update：全面支持泛型，支持go1.18 添加案例，修复omit解析时字段未写json标签被忽略的bug

Author: liu-cn

README.md

@@ -7,7 +7,7 @@
 
 ## English
 
-Golang's JSON field filter can select fields at will, output fields of specified structures at will, and reuse structures.
+Golang's JSON field filter can select fields at will, output fields of specified structures at will, and reuse structures.  **It fully supports generics** and is perfectly compatible with go 1.18 and 1.17 and below
 
 list：
 
@@ -277,13 +277,13 @@ func main() {
 		},
 	}
 
-	fmt.Println(filter.SelectMarshal("justName", tags))
+	fmt.Println(filter.SelectMarshal("justName", tags).MustJSON())
 	//--->output： [{"name":"c"},{"name":"c++"},{"name":"go"}]
 
-	fmt.Println(filter.SelectMarshal("all", tags))
+	fmt.Println(filter.SelectMarshal("all", tags).MustJSON())
 	//--->output： [{"icon":"icon-c","id":1,"name":"c"},{"icon":"icon-c++","id":1,"name":"c++"},{"icon":"icon-go","id":1,"name":"go"}]
 
-	fmt.Println(filter.SelectMarshal("chat", tags))
+	fmt.Println(filter.SelectMarshal("chat", tags).MustJSON())
 	//--->output： [{"icon":"icon-c"},{"icon":"icon-c++"},{"icon":"icon-go"}]
 
 }
@@ -321,7 +321,7 @@ func main() {
 		},
 	}
 
-	articleJson := filter.SelectMarshal("article", article)
+	articleJson := filter.SelectMarshal("article", article).MustJSON()
 	fmt.Println(articleJson)
   //output--->  {"pageInfo":999,"pageNum":1,"title":"c++从研发到脱发"}
 }
@@ -434,7 +434,7 @@ func main() {
 
  // If I only want to add some user information related to the programming language
   lang := filter.SelectMarshal("lang", user)
-	fmt.Println(lang)
+	fmt.Println(lang.MustJSON())
 	//{"langAge":[{"name":"c"},{"name":"c++"},{"name":"Go"}],"uid":1}
 
   //format
@@ -455,7 +455,7 @@ func main() {
 
   //If I just want to get some field information of uid and all arts under langage, you can do this
  lookup := filter.SelectMarshal("lookup", user)
-	fmt.Println(lookup)
+	fmt.Println(lookup.MustJSON())
 	//{"langAge":[{"arts":[{"profile":{"c":"clang"},"values":["1","2"]}]},{"arts":[{"profile":{"c++":"cpp"},"values":["cpp1","cpp2"]}]},{"arts":[{"profile":{"Golang":"go"},"values":["Golang","Golang1"]}]}],"uid":1}
 
 
@@ -626,7 +626,7 @@ func UserRes(c *gin.Context) {
 
 ### 简体中文
 
-golang的json字段过滤器，随意选择字段，随意输出指定结构体的字段，复用结构体。
+golang的json字段过滤器，随意选择字段，随意输出指定结构体的字段，复用结构体，**全面支持泛型**，对于go 1.18和1.17及其以下版本完美兼容。
 
 视频教程快速入门：https://www.bilibili.com/video/BV1ba411b7m1/
 
@@ -901,13 +901,13 @@ func main() {
 		},
 	}
 
-	fmt.Println(filter.SelectMarshal("justName", tags))
+	fmt.Println(filter.SelectMarshal("justName", tags).MustJSON())
 	//--->输出结果： [{"name":"c"},{"name":"c++"},{"name":"go"}]
 
-	fmt.Println(filter.SelectMarshal("all", tags))
+	fmt.Println(filter.SelectMarshal("all", tags).MustJSON())
 	//--->输出结果： [{"icon":"icon-c","id":1,"name":"c"},{"icon":"icon-c++","id":1,"name":"c++"},{"icon":"icon-go","id":1,"name":"go"}]
 
-	fmt.Println(filter.SelectMarshal("chat", tags))
+	fmt.Println(filter.SelectMarshal("chat", tags).MustJSON())
 	//--->输出结果： [{"icon":"icon-c"},{"icon":"icon-c++"},{"icon":"icon-go"}]
 
 }
@@ -948,7 +948,7 @@ func main() {
 		},
 	}
 
-	articleJson := filter.SelectMarshal("article", article)
+	articleJson := filter.SelectMarshal("article", article).MustJSON()
 	fmt.Println(articleJson)
   //输出结果--->  {"pageInfo":999,"pageNum":1,"title":"c++从研发到脱发"}
 }
@@ -1062,7 +1062,7 @@ func main() {
 
  // 如果我只想要编程语言相关加上部分用户信息的话
   lang := filter.SelectMarshal("lang", user)
-	fmt.Println(lang)
+	fmt.Println(lang.MustJSON())
 	//{"langAge":[{"name":"c"},{"name":"c++"},{"name":"Go"}],"uid":1}
 
   //格式化后
@@ -1083,7 +1083,7 @@ func main() {
 
   //如果我只是想获取uid加上langAge下所有Art的部分字段信息， 你可以这样
  lookup := filter.SelectMarshal("lookup", user)
-	fmt.Println(lookup)
+	fmt.Println(lookup.MustJSON())
 	//{"langAge":[{"arts":[{"profile":{"c":"clang"},"values":["1","2"]}]},{"arts":[{"profile":{"c++":"cpp"},"values":["cpp1","cpp2"]}]},{"arts":[{"profile":{"Golang":"go"},"values":["Golang","Golang1"]}]}],"uid":1}
 
 

example/anonymous_test.go

@@ -0,0 +1,35 @@
+package main
+
+import (
+	"fmt"
+	"github.com/liu-cn/json-filter/filter"
+	"testing"
+)
+
+func TestAnonymous(t *testing.T) {
+
+	type Page struct {
+		PageInfo int `json:"pageInfo,select($any)"`
+		PageNum  int `json:"pageNum,select($any)"`
+	}
+
+	type Article struct {
+		Title string                    `json:"title,select(article)"`
+		Page  `json:",select(article)"` // 这种tag字段名为空的方式会直接把该结构体展开，当作匿名结构体处理
+		//Page `json:"page,select(article)"` // 注意这里tag里标注了匿名结构体的字段名，所以解析时会解析成对象，不会展开
+		Author string `json:"author,select(admin)"`
+	}
+
+	article := Article{
+		Title: "c++从研发到脱发",
+		Page: Page{
+			PageInfo: 999,
+			PageNum:  1,
+		},
+	}
+
+	articleJson := filter.SelectMarshal("article", article)
+	fmt.Println(articleJson.MustJSON())
+	//输出结果--->  {"pageInfo":999,"pageNum":1,"title":"c++从研发到脱发"}
+
+}

example/complex_test.go

@@ -0,0 +1,91 @@
+package main
+
+import (
+	"fmt"
+	"github.com/liu-cn/json-filter/filter"
+	"testing"
+)
+
+type Users struct {
+	UID          uint   `json:"uid,select($any)"`
+	Name         string `json:"name,select(comment|chat|profile|justName)"`
+	Age          int    `json:"age,select(comment|chat|profile)"`
+	Avatar       string `json:"avatar,select(comment|chat|profile)"`
+	Birthday     int    `json:"birthday,select(profile)"`
+	Password     string `json:"password"`
+	PasswordSlat string `json:"password_slat"`
+	LangAge      []Lang `json:"langAge,select(profile|lookup|lang)"`
+}
+
+type Lang struct {
+	Name string `json:"name,select(profile|lang)"`
+	Arts []*Art `json:"arts,select(profile|lookup)"`
+}
+
+type Art struct {
+	Name    string                 `json:"name,select(profile)"`
+	Profile map[string]interface{} `json:"profile,select(profile|lookup)"`
+	Values  []string               `json:"values,select(profile|lookup)"`
+}
+
+func NewUser() Users {
+	return Users{
+		UID:          1,
+		Name:         "boyan",
+		Age:          20,
+		Avatar:       "https://www.avatar.com",
+		Birthday:     2001,
+		PasswordSlat: "slat",
+		Password:     "123",
+		LangAge: []Lang{
+			{
+				Name: "c",
+				Arts: []*Art{
+					{
+						Name: "cc",
+						Profile: map[string]interface{}{
+							"c": "clang",
+						},
+						Values: []string{"1", "2"},
+					},
+				},
+			},
+			{
+				Name: "c++",
+				Arts: []*Art{
+					{
+						Name: "c++",
+						Profile: map[string]interface{}{
+							"c++": "cpp",
+						},
+						Values: []string{"cpp1", "cpp2"},
+					},
+				},
+			},
+			{
+				Name: "Go",
+				Arts: []*Art{
+					{
+						Name: "Golang",
+						Profile: map[string]interface{}{
+							"Golang": "go",
+						},
+						Values: []string{"Golang", "Golang1"},
+					},
+				},
+			},
+		},
+	}
+}
+
+func TestComplex(t *testing.T) {
+	user := NewUser()
+	lang := filter.SelectMarshal("lang", user)
+	fmt.Println(lang.MustJSON())
+	//{"langAge":[{"name":"c"},{"name":"c++"},{"name":"Go"}],"uid":1}
+
+	lookup := filter.SelectMarshal("lookup", user)
+	fmt.Println(lookup.MustJSON())
+	//{"langAge":[{"arts":[{"profile":{"c":"clang"},"values":["1","2"]}]},{"arts":[{"profile":{"c++":"cpp"},"values":["cpp1","cpp2"]}]},{"arts":[{"profile":{"Golang":"go"},"values":["Golang","Golang1"]}]}],"uid":1}
+
+}

example/generic.go.exam

@@ -0,0 +1,60 @@
+package test
+
+import (
+	"fmt"
+	"github.com/liu-cn/json-filter/filter"
+	"testing"
+)
+
+
+
+//完全兼容泛型，
+//Fully compatible generics
+
+
+
+type Lang struct {
+	Name     string `json:"name,select(article)"`
+	IsStatic bool   `json:"is_static,select(article)"`
+}
+
+type User[T, K, V any] struct {
+	Nickname string `json:"nickname,select(article|chat)"`
+
+	Data  T  `json:"data,select(article)"`
+	Data1 *T `json:"data1,select(article)"`
+
+	K  K  `json:"k,select(article)"`
+	KP *K `json:"k_p,select(article)"`
+	V  V  `json:"v,select(article)"`
+	VP *V `json:"vp,select(article)"`
+}
+
+func NewUser() User[Lang, string, int] {
+	k := "key"
+	v := 10
+	return User[Lang, string, int]{
+		Nickname: "boyan",
+		Data: Lang{
+			Name:     "go",
+			IsStatic: true,
+		},
+		Data1: &Lang{
+			Name:     "c++",
+			IsStatic: true,
+		},
+		K:  k,
+		KP: &k,
+		V:  v,
+		VP: &v,
+	}
+}
+
+func TestJson(t *testing.T) {
+	fmt.Println(filter.SelectMarshal("article", NewUser()).MustJSON())
+	//{"data":{"is_static":true,"name":"go"},"data1":{"is_static":true,"name":"c++"},"k":"key","k_p":"key","nickname":"boyan","v":10,"vp":10}
+
+
+	fmt.Println(filter.SelectMarshal("chat", NewUser()).MustJSON())
+	//{"nickname":"boyan"}
+}

example/good_test.go

@@ -0,0 +1,31 @@
+package main
+
+import "github.com/liu-cn/json-filter/filter"
+
+type UserModel struct {
+	UID    uint        `json:"uid,select($any)"` //标记了$any无论选择任何场景都会解析该参数
+	Name   string      `json:"name,select(article|profile|chat)"`
+	Avatar interface{} `json:"data,select(profile|chat)"`
+}
+
+func (u UserModel) ArticleResp() interface{} {
+	//这样当你后面想要优化性能时可以在这里进行优化，
+	return filter.SelectMarshal("article", u).Interface()
+}
+
+func (u UserModel) ProfileResp() interface{} {
+	//这样当你后面想要优化性能时可以在这里进行优化，
+	return filter.SelectMarshal("profile", u).Interface()
+}
+
+func (u UserModel) ChatResp() interface{} {
+	//假如性能出现瓶颈，想要优化
+	chat := struct {
+		UID  uint   `json:"uid"`
+		Name string `json:"name"`
+	}{
+		UID:  u.UID,
+		Name: u.Name,
+	}
+	return chat
+}

example/omit_simple_test.go

@@ -0,0 +1,34 @@
+package main
+
+import (
+	"fmt"
+	"github.com/liu-cn/json-filter/filter"
+	"testing"
+)
+
+type OmitUser struct {
+	Name    string
+	Avatar  string `json:"avatar,omit(lang)"`
+	LangAge LangAger
+}
+
+type LangAger struct {
+	Name     string
+	IsStatic bool `json:"is_static,omit(lang)"`
+}
+
+func NewOmitUser() OmitUser {
+	return OmitUser{
+		Name:   "boyan",
+		Avatar: "avatar111",
+		LangAge: LangAger{
+			Name:     "go",
+			IsStatic: true,
+		},
+	}
+}
+
+func TestOmitUser(t *testing.T) {
+	fmt.Println(filter.OmitMarshal("lang", NewOmitUser()).MustJSON())
+	//{"LangAge":{"Name":"go"},"Name":"boyan"}
+}

example/select_omit_any_test.go

@@ -0,0 +1,35 @@
+package main
+
+import (
+	"fmt"
+	"github.com/liu-cn/json-filter/filter"
+	"testing"
+)
+
+type Anyway struct {
+	Name string `json:"name,select($any),omit(user)"`
+	Age  int    `json:"age,select(chat),omit(profile)"`
+	Sex  int    `json:"sex,select(article),omit($any)"`
+}
+
+func newAnyway() Anyway {
+	return Anyway{
+		Age:  10,
+		Sex:  10,
+		Name: "boyan",
+	}
+}
+
+func TestSelectAny(t *testing.T) {
+	fmt.Println(filter.SelectMarshal("chat", newAnyway()).MustJSON())
+	//{"age":10,"name":"boyan"}
+	fmt.Println(filter.SelectMarshal("article", newAnyway()).MustJSON())
+	//{"name":"boyan","sex":10}
+}
+
+func TestOmitAny(t *testing.T) {
+	fmt.Println(filter.OmitMarshal("user", newAnyway()).MustJSON())
+	//{"age":10}
+	fmt.Println(filter.OmitMarshal("profile", newAnyway()).MustJSON())
+	//{"name":"boyan"}
+}