improve converter feature for package gconv (#3211)

example/config/apollo/boot/boot.go

@@ -1,3 +1,9 @@
+// Copyright GoFrame Author(https://goframe.org). All Rights Reserved.
+//
+// This Source Code Form is subject to the terms of the MIT License.
+// If a copy of the MIT was not distributed with this file,
+// You can obtain one at https://github.com/gogf/gf.
+
 package boot
 
 import (

example/config/apollo/main.go

@@ -1,3 +1,9 @@
+// Copyright GoFrame Author(https://goframe.org). All Rights Reserved.
+//
+// This Source Code Form is subject to the terms of the MIT License.
+// If a copy of the MIT was not distributed with this file,
+// You can obtain one at https://github.com/gogf/gf.
+
 package main
 
 import (

example/config/consul/boot/boot.go

@@ -1,12 +1,19 @@
+// Copyright GoFrame Author(https://goframe.org). All Rights Reserved.
+//
+// This Source Code Form is subject to the terms of the MIT License.
+// If a copy of the MIT was not distributed with this file,
+// You can obtain one at https://github.com/gogf/gf.
+
 package boot
 
 import (
 	consul "github.com/gogf/gf/contrib/config/consul/v2"
 
-	"github.com/gogf/gf/v2/frame/g"
-	"github.com/gogf/gf/v2/os/gctx"
 	"github.com/hashicorp/consul/api"
 	"github.com/hashicorp/go-cleanhttp"
+
+	"github.com/gogf/gf/v2/frame/g"
+	"github.com/gogf/gf/v2/os/gctx"
 )
 
 func init() {

example/config/consul/main.go

@@ -1,3 +1,9 @@
+// Copyright GoFrame Author(https://goframe.org). All Rights Reserved.
+//
+// This Source Code Form is subject to the terms of the MIT License.
+// If a copy of the MIT was not distributed with this file,
+// You can obtain one at https://github.com/gogf/gf.
+
 package main
 
 import (

example/config/kubecm/boot_in_pod/boot.go

@@ -1,3 +1,9 @@
+// Copyright GoFrame Author(https://goframe.org). All Rights Reserved.
+//
+// This Source Code Form is subject to the terms of the MIT License.
+// If a copy of the MIT was not distributed with this file,
+// You can obtain one at https://github.com/gogf/gf.
+
 package boot
 
 import (

example/config/kubecm/boot_out_pod/boot.go

@@ -1,10 +1,17 @@
+// Copyright GoFrame Author(https://goframe.org). All Rights Reserved.
+//
+// This Source Code Form is subject to the terms of the MIT License.
+// If a copy of the MIT was not distributed with this file,
+// You can obtain one at https://github.com/gogf/gf.
+
 package boot
 
 import (
+	"k8s.io/client-go/kubernetes"
+
 	"github.com/gogf/gf/contrib/config/kubecm/v2"
 	"github.com/gogf/gf/v2/frame/g"
 	"github.com/gogf/gf/v2/os/gctx"
-	"k8s.io/client-go/kubernetes"
 )
 
 const (

example/config/kubecm/main.go

@@ -1,3 +1,9 @@
+// Copyright GoFrame Author(https://goframe.org). All Rights Reserved.
+//
+// This Source Code Form is subject to the terms of the MIT License.
+// If a copy of the MIT was not distributed with this file,
+// You can obtain one at https://github.com/gogf/gf.
+
 package main
 
 import (

example/config/nacos/boot/boot.go

@@ -1,11 +1,18 @@
+// Copyright GoFrame Author(https://goframe.org). All Rights Reserved.
+//
+// This Source Code Form is subject to the terms of the MIT License.
+// If a copy of the MIT was not distributed with this file,
+// You can obtain one at https://github.com/gogf/gf.
+
 package boot
 
 import (
+	"github.com/nacos-group/nacos-sdk-go/common/constant"
+	"github.com/nacos-group/nacos-sdk-go/vo"
+
 	"github.com/gogf/gf/contrib/config/nacos/v2"
 	"github.com/gogf/gf/v2/frame/g"
 	"github.com/gogf/gf/v2/os/gctx"
-	"github.com/nacos-group/nacos-sdk-go/common/constant"
-	"github.com/nacos-group/nacos-sdk-go/vo"
 )
 
 func init() {

example/config/nacos/main.go

@@ -1,3 +1,9 @@
+// Copyright GoFrame Author(https://goframe.org). All Rights Reserved.
+//
+// This Source Code Form is subject to the terms of the MIT License.
+// If a copy of the MIT was not distributed with this file,
+// You can obtain one at https://github.com/gogf/gf.
+
 package nacos
 
 import (

example/converter/alias_type_convert_with_refer/main.go

@@ -0,0 +1,58 @@
+// Copyright GoFrame Author(https://goframe.org). All Rights Reserved.
+//
+// This Source Code Form is subject to the terms of the MIT License.
+// If a copy of the MIT was not distributed with this file,
+// You can obtain one at https://github.com/gogf/gf.
+
+package main
+
+import (
+	"fmt"
+
+	"github.com/gogf/gf/v2/os/gtime"
+	"github.com/gogf/gf/v2/util/gconv"
+)
+
+type MyTime = *gtime.Time
+
+type Src struct {
+	A MyTime
+}
+
+type Dst struct {
+	B string
+}
+
+type SrcWrap struct {
+	Value Src
+}
+
+type DstWrap struct {
+	Value Dst
+}
+
+// SrcToDstConverter is custom converting function for custom type.
+func SrcToDstConverter(src Src) (dst *Dst, err error) {
+	return &Dst{B: src.A.Format("Y-m-d")}, nil
+}
+
+// SrcToDstConverter is custom converting function for custom type.
+func main() {
+	// register custom converter function.
+	err := gconv.RegisterConverter(SrcToDstConverter)
+	if err != nil {
+		panic(err)
+	}
+
+	// custom struct converting.
+	var src = Src{A: gtime.Now()}
+	dst := gconv.ConvertWithRefer(src, &Dst{})
+	fmt.Println("src:", src)
+	fmt.Println("dst:", dst)
+
+	// custom struct attributes converting.
+	var srcWrap = SrcWrap{Src{A: gtime.Now()}}
+	dstWrap := gconv.ConvertWithRefer(srcWrap, &DstWrap{})
+	fmt.Println("srcWrap:", srcWrap)
+	fmt.Println("dstWrap:", dstWrap)
+}

example/converter/alias_type_scan/main.go

@@ -0,0 +1,72 @@
+// Copyright GoFrame Author(https://goframe.org). All Rights Reserved.
+//
+// This Source Code Form is subject to the terms of the MIT License.
+// If a copy of the MIT was not distributed with this file,
+// You can obtain one at https://github.com/gogf/gf.
+
+package main
+
+import (
+	"fmt"
+
+	"github.com/gogf/gf/v2/os/gtime"
+	"github.com/gogf/gf/v2/util/gconv"
+)
+
+type MyTime = *gtime.Time
+
+type Src struct {
+	A MyTime
+}
+
+type Dst struct {
+	B string
+}
+
+type SrcWrap struct {
+	Value Src
+}
+
+type DstWrap struct {
+	Value Dst
+}
+
+// SrcToDstConverter is custom converting function for custom type.
+func SrcToDstConverter(src Src) (dst *Dst, err error) {
+	return &Dst{B: src.A.Format("Y-m-d")}, nil
+}
+
+// SrcToDstConverter is custom converting function for custom type.
+func main() {
+	// register custom converter function.
+	err := gconv.RegisterConverter(SrcToDstConverter)
+	if err != nil {
+		panic(err)
+	}
+
+	// custom struct converting.
+	var (
+		src = Src{A: gtime.Now()}
+		dst *Dst
+	)
+	err = gconv.Scan(src, &dst)
+	if err != nil {
+		panic(err)
+	}
+
+	fmt.Println("src:", src)
+	fmt.Println("dst:", dst)
+
+	// custom struct attributes converting.
+	var (
+		srcWrap = SrcWrap{Src{A: gtime.Now()}}
+		dstWrap *DstWrap
+	)
+	err = gconv.Scan(srcWrap, &dstWrap)
+	if err != nil {
+		panic(err)
+	}
+
+	fmt.Println("srcWrap:", srcWrap)
+	fmt.Println("dstWrap:", dstWrap)
+}

example/converter/struct_convert_with_refer/main.go

@@ -0,0 +1,54 @@
+// Copyright GoFrame Author(https://goframe.org). All Rights Reserved.
+//
+// This Source Code Form is subject to the terms of the MIT License.
+// If a copy of the MIT was not distributed with this file,
+// You can obtain one at https://github.com/gogf/gf.
+
+package main
+
+import (
+	"fmt"
+
+	"github.com/gogf/gf/v2/util/gconv"
+)
+
+type Src struct {
+	A int
+}
+
+type Dst struct {
+	B int
+}
+
+type SrcWrap struct {
+	Value Src
+}
+
+type DstWrap struct {
+	Value Dst
+}
+
+// SrcToDstConverter is custom converting function for custom type.
+func SrcToDstConverter(src Src) (dst *Dst, err error) {
+	return &Dst{B: src.A}, nil
+}
+
+func main() {
+	// register custom converter function.
+	err := gconv.RegisterConverter(SrcToDstConverter)
+	if err != nil {
+		panic(err)
+	}
+
+	// custom struct converting.
+	var src = Src{A: 1}
+	dst := gconv.ConvertWithRefer(src, Dst{})
+	fmt.Println("src:", src)
+	fmt.Println("dst:", dst)
+
+	// custom struct attributes converting.
+	var srcWrap = SrcWrap{Src{A: 1}}
+	dstWrap := gconv.ConvertWithRefer(srcWrap, &DstWrap{})
+	fmt.Println("srcWrap:", srcWrap)
+	fmt.Println("dstWrap:", dstWrap)
+}

example/converter/struct_scan/main.go

@@ -0,0 +1,68 @@
+// Copyright GoFrame Author(https://goframe.org). All Rights Reserved.
+//
+// This Source Code Form is subject to the terms of the MIT License.
+// If a copy of the MIT was not distributed with this file,
+// You can obtain one at https://github.com/gogf/gf.
+
+package main
+
+import (
+	"fmt"
+
+	"github.com/gogf/gf/v2/util/gconv"
+)
+
+type Src struct {
+	A int
+}
+
+type Dst struct {
+	B int
+}
+
+type SrcWrap struct {
+	Value Src
+}
+
+type DstWrap struct {
+	Value Dst
+}
+
+func SrcToDstConverter(src Src) (dst *Dst, err error) {
+	return &Dst{B: src.A}, nil
+}
+
+// SrcToDstConverter is custom converting function for custom type.
+func main() {
+	// register custom converter function.
+	err := gconv.RegisterConverter(SrcToDstConverter)
+	if err != nil {
+		panic(err)
+	}
+
+	// custom struct converting.
+	var (
+		src = Src{A: 1}
+		dst *Dst
+	)
+	err = gconv.Scan(src, &dst)
+	if err != nil {
+		panic(err)
+	}
+
+	fmt.Println("src:", src)
+	fmt.Println("dst:", dst)
+
+	// custom struct attributes converting.
+	var (
+		srcWrap = SrcWrap{Src{A: 1}}
+		dstWrap *DstWrap
+	)
+	err = gconv.Scan(srcWrap, &dstWrap)
+	if err != nil {
+		panic(err)
+	}
+
+	fmt.Println("srcWrap:", srcWrap)
+	fmt.Println("dstWrap:", dstWrap)
+}

example/httpserver/default_value/main.go

@@ -1,3 +1,9 @@
+// Copyright GoFrame Author(https://goframe.org). All Rights Reserved.
+//
+// This Source Code Form is subject to the terms of the MIT License.
+// If a copy of the MIT was not distributed with this file,
+// You can obtain one at https://github.com/gogf/gf.
+
 package main
 
 import (

example/httpserver/proxy/main.go

@@ -1,3 +1,9 @@
+// Copyright GoFrame Author(https://goframe.org). All Rights Reserved.
+//
+// This Source Code Form is subject to the terms of the MIT License.
+// If a copy of the MIT was not distributed with this file,
+// You can obtain one at https://github.com/gogf/gf.
+
 package main
 
 import (