添加func选择器进行字段处理，添加使用案例，更新文档

Author: liu-cn

README.md

@@ -615,6 +615,8 @@ golang的json字段过滤器，随意选择字段，随意输出指定结构体
 
 [omit选择器排除过滤](#omit选择器排除过滤)
 
+[func选择器自定义方法进行字段处理](#func选择器自定义方法进行字段处理)
+
 [$any标识符任意场景解析](#$any标识符任意场景解析)
 
 [过滤后的Filter结构体的方法](#过滤后的Filter结构体的方法)
@@ -764,6 +766,51 @@ Age int `json:"age,omitempty,select(article|profile)"` //为0忽略
 ```
 
 
+### func选择器自定义方法进行字段处理
+```go
+type Image struct {
+	Url     []byte `json:"url,select(img),func(GetUrl)"`
+	Path    string `json:"path,select(img),func(GetImagePath)"`
+	Name    string `json:"name"`
+	Hot     int    `json:"hot,select(img),func(GetHot)"` //热度
+	Like    int
+	Collect int
+	Forward int
+}
+
+func (i Image) GetUrl() string {
+	return string(i.Url) + ".jpg"
+}
+
+// 指针接收器的方法只有在过滤时候传送指针才可以保证此方法被正常调用
+func (i *Image) GetImagePath() string {
+	return i.Path + i.Name + ".png"
+}
+
+// 计算热度
+func (i Image) GetHot() int {
+	return i.Like * i.Forward * i.Collect
+}
+
+func TestFunc(t *testing.T) {
+	img := Image{
+		Url:     []byte("url"),
+		Path:    "path",
+		Name:    "_golang",
+		Collect: 10,
+		Like:    100,
+		Forward: 50,
+	}
+	fmt.Println(filter.Select("img", img))
+	//{"hot":50000,"path":"path","url":"url.jpg"}
+
+	fmt.Println(filter.Select("img", &img)) //只有传入指针才可以调用绑定指针接收器方法
+	//{"hot":50000,"path":"path_golang.png","url":"url.jpg"}
+}
+
+```
+
+
 
 #### $any标识符任意场景解析
 

example/func_test.go

@@ -0,0 +1,47 @@
+package main
+
+import (
+	"fmt"
+	"github.com/liu-cn/json-filter/filter"
+	"testing"
+)
+
+type Image struct {
+	Url     []byte `json:"url,select(img),func(GetUrl)"`
+	Path    string `json:"path,select(img),func(GetImagePath)"`
+	Name    string `json:"name"`
+	Hot     int    `json:"hot,select(img),func(GetHot)"` //热度
+	Like    int
+	Collect int
+	Forward int
+}
+
+func (i Image) GetUrl() string {
+	return string(i.Url) + ".jpg"
+}
+
+// 指针接收器的方法只有在过滤时候传送指针才可以保证此方法被正常调用
+func (i *Image) GetImagePath() string {
+	return i.Path + i.Name + ".png"
+}
+
+// 计算热度
+func (i Image) GetHot() int {
+	return i.Like * i.Forward * i.Collect
+}
+
+func TestFunc(t *testing.T) {
+	img := Image{
+		Url:     []byte("url"),
+		Path:    "path",
+		Name:    "_golang",
+		Collect: 10,
+		Like:    100,
+		Forward: 50,
+	}
+	fmt.Println(filter.Select("img", img))
+	//{"hot":50000,"path":"path","url":"url.jpg"}
+
+	fmt.Println(filter.Select("img", &img)) //只有传入指针才可以调用绑定指针接收器方法
+	//{"hot":50000,"path":"path_golang.png","url":"url.jpg"}
+}

filter/example_test.go

@@ -20,10 +20,10 @@ func ExampleSelect() {
 	)
 	name := "小北"
 	user := User{ID: 1, Name: &name, Age: 21, Tags: []Tag{{"icon", "foo"}, {"icon", "bar"}}}
-	article := Select("article", &user) //传指针或值均可
-	null := Select("null", user)
+	article := Select("article", &user) //尽量传指针
+	null := Select("null", &user)
 	user.Name = nil
-	profile := Select("profile", user)
+	profile := Select("profile", &user)
 	articleJSON, _ := json.Marshal(article)
 	fmt.Println(string(articleJSON))
 	fmt.Println(profile) //可以直接打印，打印会直接输出过滤后的json
@@ -35,27 +35,36 @@ func ExampleSelect() {
 	//{"id":1}
 }
 
-func ExampleOmit() {
+func (a *Article) GetHot() {
 
+}
+func ExampleOmit() {
 	type (
 		Tag struct {
 			Icon string `json:"icon,omit(article)"`
 			Name string `json:"name,omit(profile)"`
 		}
-		User struct {
-			Age      int   `json:"age"`
+		Articles struct {
 			Password int   `json:"password,omit($any)"` //$any表示任何场景都排除该字段
 			Tags     []Tag `json:"tags"`
+			Hot      int   `json:"hot,select(img),func(GetHot)"` //热度 过滤时会调用GetHot方法获取该字段的值
+			Like     int   `json:"-"`
+			Collect  int   `json:"-"`
 		}
 	)
-	user := User{Age: 21, Tags: []Tag{{"icon", "foo"}, {"icon", "bar"}}}
-	article := Omit("article", &user) //传指针或值均可
-	profile := Omit("profile", user)
+
+	//func (a Articles) GetHot() int { //这个方法里可以对字段进行处理，处理后可以返回一个任意值
+	//	return a.Like + a.Collect
+	//}
+
+	articles := Articles{Like: 100, Collect: 20, Tags: []Tag{{"icon", "foo"}, {"icon", "bar"}}}
+	article := Omit("article", &articles) //尽量传指针，不传指针func选择器中的用指针接收的方法无法被调用
+	profile := Omit("profile", &articles)
 	articleJSON, _ := json.Marshal(article)
 	fmt.Println(string(articleJSON))
 	fmt.Println(profile) //可以直接打印，打印会直接输出过滤后的json
 
 	//Output:
-	//{"age":21,"tags":[{"name":"foo"},{"name":"bar"}]}
-	//{"age":21,"tags":[{"icon":"icon"},{"icon":"icon"}]}
+	//{"hot":120,"tags":[{"name":"foo"},{"name":"bar"}]}
+	//{"hot":120,"tags":[{"icon":"icon"},{"icon":"icon"}]}
 }

test/main.go

@@ -76,13 +76,46 @@ func main() {
 		Avatar2:    []byte("uuid2"),
 	}
 
-	//fmt.Println(mustJson(u))
+	fmt.Println(mustJson(u))
 	//fmt.Println(filter.Omit("h", u))
-	fmt.Println(filter.Select("all", u))
-	fmt.Println(filter.Omit("all", u))
-	fmt.Println(filter.Select("all", &u))
-	fmt.Println(filter.Omit("all", &u))
-	TestSlice()
-	TestMap()
-	TestU()
+	//fmt.Println(filter.Select("all", u))
+	//fmt.Println(filter.Omit("all", u))
+	//fmt.Println(filter.Select("all", &u))
+	//fmt.Println(filter.Omit("all", &u))
+	//TestSlice()
+	//TestMap()
+	//TestU()
+
+	ExampleOmit()
+}
+
+func ExampleOmit() {
+	type (
+		Tag struct {
+			Icon string `json:"icon,omit(article)"`
+			Name string `json:"name,omit(profile)"`
+		}
+		Articles struct {
+			Password int   `json:"password,omit($any)"` //$any表示任何场景都排除该字段
+			Tags     []Tag `json:"tags"`
+			Hot      int   `json:"hot,select(img),func(GetHot)"` //热度 过滤时会调用GetHot方法获取该字段的值
+			Like     int   `json:"-"`
+			Collect  int   `json:"-"`
+		}
+	)
+
+	//func (a Articles) GetHot() int { //这个方法里可以对字段进行处理，处理后可以返回一个任意值
+	//	return a.Like + a.Collect
+	//}
+
+	articles := Articles{Like: 100, Collect: 20, Tags: []Tag{{"icon", "foo"}, {"icon", "bar"}}}
+	article := filter.Omit("article", &articles) //尽量传指针，不传指针func选择器中的用指针接收的方法无法被调用
+	profile := filter.Omit("profile", &articles)
+	articleJSON, _ := json.Marshal(article)
+	fmt.Println(string(articleJSON))
+	fmt.Println(profile) //可以直接打印，打印会直接输出过滤后的json
+
+	//Output:
+	//{"hot":120,"tags":[{"name":"foo"},{"name":"bar"}]}
+	//{"hot":120,"tags":[{"icon":"icon"},{"icon":"icon"}]}
 }