引入 GinWrapperContext, gateway待升级测试

优化 GinContext 定义
merge master && fix both modify
2025-03-10 14:44:20 +08:00 · 2025-03-10 14:07:51 +08:00 · 2025-03-10 12:29:11 +08:00 · 2025-02-28 18:43:11 +08:00 · 2025-02-28 18:18:03 +08:00 · 2025-02-28 17:05:12 +08:00
22 changed files with 1651 additions and 394 deletions
--- a/define/request.go
+++ b/define/request.go
@ -0,0 +1,12 @@
+// Package define ...
+//
+// Description : define ...
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 2025-03-10 14:38
+package define
+
+const (
+	GinWrapperContextKey = "GIN_WRAPPER_CONTEXT"
+)
--- a/define/response.go
+++ b/define/response.go
@ -10,6 +10,7 @@ package define
 import (
 	"git.zhangdeman.cn/zhangdeman/consts"
 	"git.zhangdeman.cn/zhangdeman/wrapper"
+	"sync"
 )

 var (
@ -124,3 +125,24 @@ func GetHttpHandleConfig() *HttpHandleConfig {
 		).Value(),
 	}
 }
+
+const (
+	LogicAfterResponseKey = "__logic_after_response__"
+)
+
+type LogicAfterResponse struct {
+	SuccessHookFuncList []func()      `json:"-"` // 请求最后需要执行的成功hook函数
+	FailureHookFuncList []func()      `json:"-"` // 请求最后需要执行的失败hook函数
+	Lock                *sync.RWMutex `json:"-"` // 逻辑锁
+}
+
+func (logic *LogicAfterResponse) AddSuccessHook(f func()) {
+	logic.Lock.Lock()
+	defer logic.Lock.Unlock()
+	logic.SuccessHookFuncList = append(logic.SuccessHookFuncList, f)
+}
+func (logic *LogicAfterResponse) AddFailureHook(f func()) {
+	logic.Lock.Lock()
+	defer logic.Lock.Unlock()
+	logic.FailureHookFuncList = append(logic.FailureHookFuncList, f)
+}
--- a/go.mod
+++ b/go.mod
@ -1,51 +1,58 @@
 module git.zhangdeman.cn/zhangdeman/gin

-go 1.21.0
+go 1.23.0

-toolchain go1.23.1
+toolchain go1.24.0

 require (
-	git.zhangdeman.cn/zhangdeman/consts v0.0.0-20241104082108-0f97a870bbc3
-	git.zhangdeman.cn/zhangdeman/exception v0.0.0-20240930081343-1e7f84ed8465
-	git.zhangdeman.cn/zhangdeman/logger v0.0.0-20240725055115-98eb52ae307a
+	git.zhangdeman.cn/gateway/api-doc v0.0.0-20250220105101-71d6db967dc5
+	git.zhangdeman.cn/zhangdeman/consts v0.0.0-20250227040546-863c03f34bb8
+	git.zhangdeman.cn/zhangdeman/exception v0.0.0-20250207091724-ca151fbc1f06
+	git.zhangdeman.cn/zhangdeman/logger v0.0.0-20241125083316-eab7bab9d7ad
 	git.zhangdeman.cn/zhangdeman/network v0.0.0-20230925112156-f0eb86dd2442
-	git.zhangdeman.cn/zhangdeman/serialize v0.0.0-20241104092308-ecb02113459e
-	git.zhangdeman.cn/zhangdeman/wrapper v0.0.0-20241013112816-e3de2835a971
+	git.zhangdeman.cn/zhangdeman/serialize v0.0.0-20241223084948-de2e49144fcd
+	git.zhangdeman.cn/zhangdeman/trace v0.0.0-20231220041950-807f3d74a6fa
+	git.zhangdeman.cn/zhangdeman/wrapper v0.0.0-20250124091620-c757e551a8c9
+	github.com/gin-contrib/pprof v1.5.2
 	github.com/gin-gonic/gin v1.10.0
-	github.com/go-playground/validator/v10 v10.22.1
+	github.com/go-playground/validator/v10 v10.25.0
 	github.com/mcuadros/go-defaults v1.2.0
-	github.com/pkg/errors v0.9.1
 	github.com/sbabiv/xml2map v1.2.1
-	github.com/stretchr/testify v1.9.0
 	go.uber.org/zap v1.27.0
 )

 require (
 	git.zhangdeman.cn/zhangdeman/easylock v0.0.0-20230731062340-983985c12eda // indirect
-	git.zhangdeman.cn/zhangdeman/easymap v0.0.0-20240311030808-e2a2e6a3c211 // indirect
+	git.zhangdeman.cn/zhangdeman/easymap v0.0.0-20241101082529-28a6c68e38a4 // indirect
 	git.zhangdeman.cn/zhangdeman/op_type v0.0.0-20240122104027-4928421213c0 // indirect
 	git.zhangdeman.cn/zhangdeman/util v0.0.0-20240618042405-6ee2c904644e // indirect
-	git.zhangdeman.cn/zhangdeman/websocket v0.0.0-20240723075210-85feada512b2 // indirect
+	git.zhangdeman.cn/zhangdeman/websocket v0.0.0-20241125101541-c5ea194c9c1e // indirect
 	github.com/BurntSushi/toml v1.4.0 // indirect
+	github.com/KyleBanks/depth v1.2.1 // indirect
 	github.com/axgle/mahonia v0.0.0-20180208002826-3358181d7394 // indirect
-	github.com/bytedance/sonic v1.12.4 // indirect
-	github.com/bytedance/sonic/loader v0.2.1 // indirect
-	github.com/cloudwego/base64x v0.1.4 // indirect
-	github.com/cloudwego/iasm v0.2.0 // indirect
-	github.com/davecgh/go-spew v1.1.1 // indirect
+	github.com/bytedance/sonic v1.12.9 // indirect
+	github.com/bytedance/sonic/loader v0.2.3 // indirect
+	github.com/cloudwego/base64x v0.1.5 // indirect
 	github.com/dgrijalva/jwt-go/v4 v4.0.0-preview1 // indirect
-	github.com/gabriel-vasile/mimetype v1.4.6 // indirect
-	github.com/gin-contrib/sse v0.1.0 // indirect
+	github.com/gabriel-vasile/mimetype v1.4.8 // indirect
+	github.com/gin-contrib/sse v1.0.0 // indirect
 	github.com/go-ini/ini v1.67.0 // indirect
+	github.com/go-openapi/jsonpointer v0.21.0 // indirect
+	github.com/go-openapi/jsonreference v0.21.0 // indirect
+	github.com/go-openapi/spec v0.21.0 // indirect
+	github.com/go-openapi/swag v0.23.0 // indirect
 	github.com/go-playground/locales v0.14.1 // indirect
 	github.com/go-playground/universal-translator v0.18.1 // indirect
-	github.com/goccy/go-json v0.10.3 // indirect
+	github.com/go-webtools/knife4go v1.0.4 // indirect
+	github.com/goccy/go-json v0.10.5 // indirect
 	github.com/gorilla/websocket v1.5.3 // indirect
+	github.com/josharian/intern v1.0.0 // indirect
 	github.com/json-iterator/go v1.1.12 // indirect
-	github.com/klauspost/cpuid/v2 v2.2.8 // indirect
+	github.com/klauspost/cpuid/v2 v2.2.10 // indirect
 	github.com/leodido/go-urn v1.4.0 // indirect
 	github.com/lestrrat-go/file-rotatelogs v2.4.0+incompatible // indirect
 	github.com/lestrrat-go/strftime v1.1.0 // indirect
+	github.com/mailru/easyjson v0.9.0 // indirect
 	github.com/mattn/go-isatty v0.0.20 // indirect
 	github.com/mitchellh/go-homedir v1.1.0 // indirect
 	github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect
@ -53,20 +60,24 @@ require (
 	github.com/mozillazg/go-pinyin v0.20.0 // indirect
 	github.com/mssola/user_agent v0.6.0 // indirect
 	github.com/pelletier/go-toml/v2 v2.2.3 // indirect
-	github.com/pmezard/go-difflib v1.0.0 // indirect
+	github.com/pkg/errors v0.9.1 // indirect
 	github.com/spaolacci/murmur3 v1.1.0 // indirect
+	github.com/swaggo/files v1.0.1 // indirect
+	github.com/swaggo/gin-swagger v1.6.0 // indirect
+	github.com/swaggo/swag v1.16.4 // indirect
 	github.com/tidwall/gjson v1.18.0 // indirect
 	github.com/tidwall/match v1.1.1 // indirect
 	github.com/tidwall/pretty v1.2.1 // indirect
 	github.com/twitchyliquid64/golang-asm v0.15.1 // indirect
 	github.com/ugorji/go/codec v1.2.12 // indirect
 	go.uber.org/multierr v1.11.0 // indirect
-	golang.org/x/arch v0.11.0 // indirect
-	golang.org/x/crypto v0.28.0 // indirect
-	golang.org/x/net v0.30.0 // indirect
-	golang.org/x/sys v0.26.0 // indirect
-	golang.org/x/text v0.19.0 // indirect
-	google.golang.org/protobuf v1.35.1 // indirect
+	golang.org/x/arch v0.14.0 // indirect
+	golang.org/x/crypto v0.35.0 // indirect
+	golang.org/x/net v0.35.0 // indirect
+	golang.org/x/sys v0.30.0 // indirect
+	golang.org/x/text v0.22.0 // indirect
+	golang.org/x/tools v0.30.0 // indirect
+	google.golang.org/protobuf v1.36.5 // indirect
 	gopkg.in/olahol/melody.v1 v1.0.0-20170518105555-d52139073376 // indirect
 	gopkg.in/yaml.v3 v3.0.1 // indirect
 )
--- a/go.sum
+++ b/go.sum
@ -1,96 +1,99 @@
-git.zhangdeman.cn/zhangdeman/consts v0.0.0-20240924065029-c865046cd9e7 h1:tyCPCMK+68PZ0axZylQHitMVp1d5mzNr9/YqMHXqo+A=
-git.zhangdeman.cn/zhangdeman/consts v0.0.0-20240924065029-c865046cd9e7/go.mod h1:IXXaZkb7vGzGnGM5RRWrASAuwrVSNxuoe0DmeXx5g6k=
-git.zhangdeman.cn/zhangdeman/consts v0.0.0-20241015035056-b6f4a6512763 h1:aG59AjZAn/Y+smWoa6l6HQB+yh/Rpml79EvmfjEb6Ks=
-git.zhangdeman.cn/zhangdeman/consts v0.0.0-20241015035056-b6f4a6512763/go.mod h1:IXXaZkb7vGzGnGM5RRWrASAuwrVSNxuoe0DmeXx5g6k=
-git.zhangdeman.cn/zhangdeman/consts v0.0.0-20241023090605-10cff9173059 h1:TPAYdTKKUjgxtCnK38d1Tb4teyQp1C7wYHPdR32yZtM=
-git.zhangdeman.cn/zhangdeman/consts v0.0.0-20241023090605-10cff9173059/go.mod h1:IXXaZkb7vGzGnGM5RRWrASAuwrVSNxuoe0DmeXx5g6k=
-git.zhangdeman.cn/zhangdeman/consts v0.0.0-20241104081823-ab1d691f309d h1:LvQIKDKQ6NNgX/3l3A7tukOFcUeTzC1kEZSeq8eIdUU=
-git.zhangdeman.cn/zhangdeman/consts v0.0.0-20241104081823-ab1d691f309d/go.mod h1:IXXaZkb7vGzGnGM5RRWrASAuwrVSNxuoe0DmeXx5g6k=
-git.zhangdeman.cn/zhangdeman/consts v0.0.0-20241104082108-0f97a870bbc3 h1:BiAlBJ+DuRs/xD7nDQD2JT8Oc+V+0Uwt36qZwdXGvzI=
-git.zhangdeman.cn/zhangdeman/consts v0.0.0-20241104082108-0f97a870bbc3/go.mod h1:IXXaZkb7vGzGnGM5RRWrASAuwrVSNxuoe0DmeXx5g6k=
+git.zhangdeman.cn/gateway/api-doc v0.0.0-20250220105101-71d6db967dc5 h1:UV2+nD9HQLbRt+vY98gwPtkd+M8fbfffl7nb4Mkymmc=
+git.zhangdeman.cn/gateway/api-doc v0.0.0-20250220105101-71d6db967dc5/go.mod h1:oNTwnepzW09RNfIQCpgmbiayTKLvGx2XP92esfkxv98=
+git.zhangdeman.cn/zhangdeman/consts v0.0.0-20250227040546-863c03f34bb8 h1:VEifPc+vkpEQoX9rj7zxmT1m+IA81XjOxe7+Z1aqWNM=
+git.zhangdeman.cn/zhangdeman/consts v0.0.0-20250227040546-863c03f34bb8/go.mod h1:IXXaZkb7vGzGnGM5RRWrASAuwrVSNxuoe0DmeXx5g6k=
 git.zhangdeman.cn/zhangdeman/easylock v0.0.0-20230731062340-983985c12eda h1:bMD6r9gjRy7cO+T4zRQVYAesgIblBdTnhzT1vN5wjvI=
 git.zhangdeman.cn/zhangdeman/easylock v0.0.0-20230731062340-983985c12eda/go.mod h1:dT0rmHcJ9Z9IqWeMIt7YzR88nKkNV2V3dfG0j9Q6lK0=
-git.zhangdeman.cn/zhangdeman/easymap v0.0.0-20240311030808-e2a2e6a3c211 h1:I/wOsRpCSRkU9vo1u703slQsmK0wnNeZzsWQOGtIAG0=
-git.zhangdeman.cn/zhangdeman/easymap v0.0.0-20240311030808-e2a2e6a3c211/go.mod h1:SrtvrQRdzt+8KfYzvosH++gWxo2ShPTzR1m3VQ6uX7U=
-git.zhangdeman.cn/zhangdeman/exception v0.0.0-20231105153815-e8561a060cc8/go.mod h1:Voc8J4ordx7nuMWpgACXXZULQy7ZIuBzcEIoS8VnDIw=
-git.zhangdeman.cn/zhangdeman/exception v0.0.0-20240930081343-1e7f84ed8465 h1:j5EB0hamTMT5fY+xmjJ51oBvll+vS2inNPi+3/UBj60=
-git.zhangdeman.cn/zhangdeman/exception v0.0.0-20240930081343-1e7f84ed8465/go.mod h1:Voc8J4ordx7nuMWpgACXXZULQy7ZIuBzcEIoS8VnDIw=
-git.zhangdeman.cn/zhangdeman/logger v0.0.0-20240725055115-98eb52ae307a h1:22VkxGmpS58zHA8tf75lPr/3S6hmHKP00w/jUa700Ps=
-git.zhangdeman.cn/zhangdeman/logger v0.0.0-20240725055115-98eb52ae307a/go.mod h1:phaF6LMebn7Fpp8J/mOzHRYGniKuCk78k4N53T2m8NI=
+git.zhangdeman.cn/zhangdeman/easymap v0.0.0-20241101082529-28a6c68e38a4 h1:s6d4b6yY+NaK1AzoBD1pxqsuygEHQz0Oie86c45geDw=
+git.zhangdeman.cn/zhangdeman/easymap v0.0.0-20241101082529-28a6c68e38a4/go.mod h1:V4Dfg1v/JVIZGEKCm6/aehs8hK+Xow1dkL1yiQymXlQ=
+git.zhangdeman.cn/zhangdeman/exception v0.0.0-20250207091724-ca151fbc1f06 h1:XsjGMkBCi93h56oCg5Lrz5zVpUxify/CQVhQU9+qLWM=
+git.zhangdeman.cn/zhangdeman/exception v0.0.0-20250207091724-ca151fbc1f06/go.mod h1:Voc8J4ordx7nuMWpgACXXZULQy7ZIuBzcEIoS8VnDIw=
+git.zhangdeman.cn/zhangdeman/logger v0.0.0-20241125083316-eab7bab9d7ad h1:6BI3QiDI64SlER1006UJbTJyOCXxB8KCmCK+Kr7FzQo=
+git.zhangdeman.cn/zhangdeman/logger v0.0.0-20241125083316-eab7bab9d7ad/go.mod h1:+jPQTyCEQqMWhq4p1LowQWq15emisON+++87ArTgwNA=
 git.zhangdeman.cn/zhangdeman/network v0.0.0-20230925112156-f0eb86dd2442 h1:1eBf0C0gdpBQOqjTK3UCw/mwzQ/SCodx3iTQtidx9eE=
 git.zhangdeman.cn/zhangdeman/network v0.0.0-20230925112156-f0eb86dd2442/go.mod h1:hFYWiS+ExIuJJJdwHWy4P3pVHbd/0mpv53qlbhDNdTI=
 git.zhangdeman.cn/zhangdeman/op_type v0.0.0-20240122104027-4928421213c0 h1:gUDlQMuJ4xNfP2Abl1Msmpa3fASLWYkNlqDFF/6GN0Y=
 git.zhangdeman.cn/zhangdeman/op_type v0.0.0-20240122104027-4928421213c0/go.mod h1:VHb9qmhaPDAQDcS6vUiDCamYjZ4R5lD1XtVsh55KsMI=
-git.zhangdeman.cn/zhangdeman/serialize v0.0.0-20240618035451-8d48a6bd39dd h1:2Y37waOVCmVvx0Rp8VGEptE2/2JVMImtxB4dKKDk/3w=
-git.zhangdeman.cn/zhangdeman/serialize v0.0.0-20240618035451-8d48a6bd39dd/go.mod h1:6+7whkCmb4sJDIfH3HxNuXRveaM0gCCNWd2uXZqNtIE=
-git.zhangdeman.cn/zhangdeman/serialize v0.0.0-20241023104258-2e0a298aa558 h1:ZVJyyDKfYeA3TsN8UOi4IprkouK4wIIfCKe+F9byLWA=
-git.zhangdeman.cn/zhangdeman/serialize v0.0.0-20241023104258-2e0a298aa558/go.mod h1:/9eicss/Dt9tp2jwZ/4cXDqDKo/Dez+HuT5/NGdqW+s=
-git.zhangdeman.cn/zhangdeman/serialize v0.0.0-20241104092308-ecb02113459e h1:A045F67AMSqFKGD9kk2uLa+6c/zpmW8vjjSRmSsdjPs=
-git.zhangdeman.cn/zhangdeman/serialize v0.0.0-20241104092308-ecb02113459e/go.mod h1:XqgER4jDYwskFgj2riJ9XptIjzgYWubY+Zq8iB2WkY0=
+git.zhangdeman.cn/zhangdeman/serialize v0.0.0-20241223084948-de2e49144fcd h1:q7GG14qgXKB4MEXQFOe7/UYebsqMfPaSX80TcPdOosI=
+git.zhangdeman.cn/zhangdeman/serialize v0.0.0-20241223084948-de2e49144fcd/go.mod h1:+D6uPSljwHywjVY5WSBY4TRVMj26TN5f5cFGEYMldjs=
+git.zhangdeman.cn/zhangdeman/trace v0.0.0-20231220041950-807f3d74a6fa h1:2bZ9VmQF0pIZ+scnN3UuGoXjjKhccnwfIL779QGZArY=
+git.zhangdeman.cn/zhangdeman/trace v0.0.0-20231220041950-807f3d74a6fa/go.mod h1:Bta0kzamTWqBIcc6robGAl/iRuyCFbzy45VGbG8L+7Y=
 git.zhangdeman.cn/zhangdeman/util v0.0.0-20240618042405-6ee2c904644e h1:Q973S6CcWr1ICZhFI1STFOJ+KUImCl2BaIXm6YppBqI=
 git.zhangdeman.cn/zhangdeman/util v0.0.0-20240618042405-6ee2c904644e/go.mod h1:VpPjBlwz8U+OxZuxzHQBv1aEEZ3pStH6bZvT21ADEbI=
-git.zhangdeman.cn/zhangdeman/websocket v0.0.0-20240723075210-85feada512b2 h1:P2kuhU2TFWk9mPbJlZCK6FMDVS7S3NGafWKD4eNqKiI=
-git.zhangdeman.cn/zhangdeman/websocket v0.0.0-20240723075210-85feada512b2/go.mod h1:7KaMpQmWgiNLpEkaV7oDtep7geI1f/VoCoPVcyvMjAE=
-git.zhangdeman.cn/zhangdeman/wrapper v0.0.0-20240924063449-ef80c6cb79d1 h1:LYw8NJeWcOiyrGjH9weyxnaMit94MlIngL+uskbLjtw=
-git.zhangdeman.cn/zhangdeman/wrapper v0.0.0-20240924063449-ef80c6cb79d1/go.mod h1:+2qNxuRsfyfOvXk9HNwn+CmyPmmhhrQm/eIi1FDU1jw=
-git.zhangdeman.cn/zhangdeman/wrapper v0.0.0-20241013112816-e3de2835a971 h1:vCkhZliMy2H+OqhcIyhPYQcH13wFuYb9LUeAu71ToNA=
-git.zhangdeman.cn/zhangdeman/wrapper v0.0.0-20241013112816-e3de2835a971/go.mod h1:+2qNxuRsfyfOvXk9HNwn+CmyPmmhhrQm/eIi1FDU1jw=
+git.zhangdeman.cn/zhangdeman/websocket v0.0.0-20241125101541-c5ea194c9c1e h1:YE2Gi+M03UDImIpWa3I7jzSesyfu2RL8x/4ONs5v0oE=
+git.zhangdeman.cn/zhangdeman/websocket v0.0.0-20241125101541-c5ea194c9c1e/go.mod h1:L/7JugxKZL3JP9JP/XDvPAPz0FQXG1u181Su1+u/d1c=
+git.zhangdeman.cn/zhangdeman/wrapper v0.0.0-20250124091620-c757e551a8c9 h1:yF770WIDNwyiKL0nwmBGmjZvNCLXtHQL4xJyffPjTMU=
+git.zhangdeman.cn/zhangdeman/wrapper v0.0.0-20250124091620-c757e551a8c9/go.mod h1:I76wxEsWq7KnMQ84elpwTjEqq4I49QFw60tp5h7iGBs=
 github.com/BurntSushi/toml v1.4.0 h1:kuoIxZQy2WRRk1pttg9asf+WVv6tWQuBNVmK8+nqPr0=
 github.com/BurntSushi/toml v1.4.0/go.mod h1:ukJfTF/6rtPPRCnwkur4qwRxa8vTRFBF0uk2lLoLwho=
+github.com/KyleBanks/depth v1.2.1 h1:5h8fQADFrWtarTdtDudMmGsC7GPbOAu6RVB3ffsVFHc=
+github.com/KyleBanks/depth v1.2.1/go.mod h1:jzSb9d0L43HxTQfT+oSA1EEp2q+ne2uh6XgeJcm8brE=
 github.com/axgle/mahonia v0.0.0-20180208002826-3358181d7394 h1:OYA+5W64v3OgClL+IrOD63t4i/RW7RqrAVl9LTZ9UqQ=
 github.com/axgle/mahonia v0.0.0-20180208002826-3358181d7394/go.mod h1:Q8n74mJTIgjX4RBBcHnJ05h//6/k6foqmgE45jTQtxg=
-github.com/bytedance/sonic v1.12.3 h1:W2MGa7RCU1QTeYRTPE3+88mVC0yXmsRQRChiyVocVjU=
-github.com/bytedance/sonic v1.12.3/go.mod h1:B8Gt/XvtZ3Fqj+iSKMypzymZxw/FVwgIGKzMzT9r/rk=
-github.com/bytedance/sonic v1.12.4 h1:9Csb3c9ZJhfUWeMtpCDCq6BUoH5ogfDFLUgQ/jG+R0k=
-github.com/bytedance/sonic v1.12.4/go.mod h1:B8Gt/XvtZ3Fqj+iSKMypzymZxw/FVwgIGKzMzT9r/rk=
+github.com/bytedance/sonic v1.12.9 h1:Od1BvK55NnewtGaJsTDeAOSnLVO2BTSLOe0+ooKokmQ=
+github.com/bytedance/sonic v1.12.9/go.mod h1:uVvFidNmlt9+wa31S1urfwwthTWteBgG0hWuoKAXTx8=
 github.com/bytedance/sonic/loader v0.1.1/go.mod h1:ncP89zfokxS5LZrJxl5z0UJcsk4M4yY2JpfqGeCtNLU=
-github.com/bytedance/sonic/loader v0.2.0 h1:zNprn+lsIP06C/IqCHs3gPQIvnvpKbbxyXQP1iU4kWM=
-github.com/bytedance/sonic/loader v0.2.0/go.mod h1:ncP89zfokxS5LZrJxl5z0UJcsk4M4yY2JpfqGeCtNLU=
-github.com/bytedance/sonic/loader v0.2.1 h1:1GgorWTqf12TA8mma4DDSbaQigE2wOgQo7iCjjJv3+E=
-github.com/bytedance/sonic/loader v0.2.1/go.mod h1:ncP89zfokxS5LZrJxl5z0UJcsk4M4yY2JpfqGeCtNLU=
-github.com/cloudwego/base64x v0.1.4 h1:jwCgWpFanWmN8xoIUHa2rtzmkd5J2plF/dnLS6Xd/0Y=
-github.com/cloudwego/base64x v0.1.4/go.mod h1:0zlkT4Wn5C6NdauXdJRhSKRlJvmclQ1hhJgA0rcu/8w=
-github.com/cloudwego/iasm v0.2.0 h1:1KNIy1I1H9hNNFEEH3DVnI4UujN+1zjpuk6gwHLTssg=
+github.com/bytedance/sonic/loader v0.2.3 h1:yctD0Q3v2NOGfSWPLPvG2ggA2kV6TS6s4wioyEqssH0=
+github.com/bytedance/sonic/loader v0.2.3/go.mod h1:N8A3vUdtUebEY2/VQC0MyhYeKUFosQU6FxH2JmUe6VI=
+github.com/cloudwego/base64x v0.1.5 h1:XPciSp1xaq2VCSt6lF0phncD4koWyULpl5bUxbfCyP4=
+github.com/cloudwego/base64x v0.1.5/go.mod h1:0zlkT4Wn5C6NdauXdJRhSKRlJvmclQ1hhJgA0rcu/8w=
 github.com/cloudwego/iasm v0.2.0/go.mod h1:8rXZaNYT2n95jn+zTI1sDr+IgcD2GVs0nlbbQPiEFhY=
 github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
-github.com/dgrijalva/jwt-go v3.2.0+incompatible h1:7qlOGliEKZXTDg6OTjfoBKDXWrumCAMpl/TFQ4/5kLM=
 github.com/dgrijalva/jwt-go/v4 v4.0.0-preview1 h1:CaO/zOnF8VvUfEbhRatPcwKVWamvbYd8tQGRWacE9kU=
 github.com/dgrijalva/jwt-go/v4 v4.0.0-preview1/go.mod h1:+hnT3ywWDTAFrW5aE+u2Sa/wT555ZqwoCS+pk3p6ry4=
-github.com/gabriel-vasile/mimetype v1.4.5 h1:J7wGKdGu33ocBOhGy0z653k/lFKLFDPJMG8Gql0kxn4=
-github.com/gabriel-vasile/mimetype v1.4.5/go.mod h1:ibHel+/kbxn9x2407k1izTA1S81ku1z/DlgOW2QE0M4=
-github.com/gabriel-vasile/mimetype v1.4.6 h1:3+PzJTKLkvgjeTbts6msPJt4DixhT4YtFNf1gtGe3zc=
-github.com/gabriel-vasile/mimetype v1.4.6/go.mod h1:JX1qVKqZd40hUPpAfiNTe0Sne7hdfKSbOqqmkq8GCXc=
-github.com/gin-contrib/sse v0.1.0 h1:Y/yl/+YNO8GZSjAhjMsSuLt29uWRFHdHYUb5lYOV9qE=
-github.com/gin-contrib/sse v0.1.0/go.mod h1:RHrZQHXnP2xjPF+u1gW/2HnVO7nvIa9PG3Gm+fLHvGI=
+github.com/gabriel-vasile/mimetype v1.4.8 h1:FfZ3gj38NjllZIeJAmMhr+qKL8Wu+nOoI3GqacKw1NM=
+github.com/gabriel-vasile/mimetype v1.4.8/go.mod h1:ByKUIKGjh1ODkGM1asKUbQZOLGrPjydw3hYPU2YU9t8=
+github.com/gin-contrib/gzip v0.0.6 h1:NjcunTcGAj5CO1gn4N8jHOSIeRFHIbn51z6K+xaN4d4=
+github.com/gin-contrib/gzip v0.0.6/go.mod h1:QOJlmV2xmayAjkNS2Y8NQsMneuRShOU/kjovCXNuzzk=
+github.com/gin-contrib/pprof v1.5.2 h1:Kcq5W2bA2PBcVtF0MqkQjpvCpwJr+pd7zxcQh2csg7E=
+github.com/gin-contrib/pprof v1.5.2/go.mod h1:a1W4CDXwAPm2zql2AKdnT7OVCJdV/oFPhJXVOrDs5Ns=
+github.com/gin-contrib/sse v1.0.0 h1:y3bT1mUWUxDpW4JLQg/HnTqV4rozuW4tC9eFKTxYI9E=
+github.com/gin-contrib/sse v1.0.0/go.mod h1:zNuFdwarAygJBht0NTKiSi3jRf6RbqeILZ9Sp6Slhe0=
 github.com/gin-gonic/gin v1.10.0 h1:nTuyha1TYqgedzytsKYqna+DfLos46nTv2ygFy86HFU=
 github.com/gin-gonic/gin v1.10.0/go.mod h1:4PMNQiOhvDRa013RKVbsiNwoyezlm2rm0uX/T7kzp5Y=
 github.com/go-ini/ini v1.67.0 h1:z6ZrTEZqSWOTyH2FlglNbNgARyHG8oLW9gMELqKr06A=
 github.com/go-ini/ini v1.67.0/go.mod h1:ByCAeIL28uOIIG0E3PJtZPDL8WnHpFKFOtgjp+3Ies8=
+github.com/go-openapi/jsonpointer v0.21.0 h1:YgdVicSA9vH5RiHs9TZW5oyafXZFc6+2Vc1rr/O9oNQ=
+github.com/go-openapi/jsonpointer v0.21.0/go.mod h1:IUyH9l/+uyhIYQ/PXVA41Rexl+kOkAPDdXEYns6fzUY=
+github.com/go-openapi/jsonreference v0.21.0 h1:Rs+Y7hSXT83Jacb7kFyjn4ijOuVGSvOdF2+tg1TRrwQ=
+github.com/go-openapi/jsonreference v0.21.0/go.mod h1:LmZmgsrTkVg9LG4EaHeY8cBDslNPMo06cago5JNLkm4=
+github.com/go-openapi/spec v0.21.0 h1:LTVzPc3p/RzRnkQqLRndbAzjY0d0BCL72A6j3CdL9ZY=
+github.com/go-openapi/spec v0.21.0/go.mod h1:78u6VdPw81XU44qEWGhtr982gJ5BWg2c0I5XwVMotYk=
+github.com/go-openapi/swag v0.23.0 h1:vsEVJDUo2hPJ2tu0/Xc+4noaxyEffXNIs3cOULZ+GrE=
+github.com/go-openapi/swag v0.23.0/go.mod h1:esZ8ITTYEsH1V2trKHjAN8Ai7xHb8RV+YSZ577vPjgQ=
 github.com/go-playground/assert/v2 v2.2.0 h1:JvknZsQTYeFEAhQwI4qEt9cyV5ONwRHC+lYKSsYSR8s=
 github.com/go-playground/assert/v2 v2.2.0/go.mod h1:VDjEfimB/XKnb+ZQfWdccd7VUvScMdVu0Titje2rxJ4=
 github.com/go-playground/locales v0.14.1 h1:EWaQ/wswjilfKLTECiXz7Rh+3BjFhfDFKv/oXslEjJA=
 github.com/go-playground/locales v0.14.1/go.mod h1:hxrqLVvrK65+Rwrd5Fc6F2O76J/NuW9t0sjnWqG1slY=
 github.com/go-playground/universal-translator v0.18.1 h1:Bcnm0ZwsGyWbCzImXv+pAJnYK9S473LQFuzCbDbfSFY=
 github.com/go-playground/universal-translator v0.18.1/go.mod h1:xekY+UJKNuX9WP91TpwSH2VMlDf28Uj24BCp08ZFTUY=
-github.com/go-playground/validator/v10 v10.22.1 h1:40JcKH+bBNGFczGuoBYgX4I6m/i27HYW8P9FDk5PbgA=
-github.com/go-playground/validator/v10 v10.22.1/go.mod h1:dbuPbCMFw/DrkbEynArYaCwl3amGuJotoKCe95atGMM=
-github.com/goccy/go-json v0.10.3 h1:KZ5WoDbxAIgm2HNbYckL0se1fHD6rz5j4ywS6ebzDqA=
-github.com/goccy/go-json v0.10.3/go.mod h1:oq7eo15ShAhp70Anwd5lgX2pLfOS3QCiwU/PULtXL6M=
-github.com/google/go-cmp v0.5.6 h1:BKbKCqvP6I+rmFHt06ZmyQtvB8xAkWdhFyr0ZUNZcxQ=
-github.com/google/go-cmp v0.5.6/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=
+github.com/go-playground/validator/v10 v10.25.0 h1:5Dh7cjvzR7BRZadnsVOzPhWsrwUr0nmsZJxEAnFLNO8=
+github.com/go-playground/validator/v10 v10.25.0/go.mod h1:GGzBIJMuE98Ic/kJsBXbz1x/7cByt++cQ+YOuDM5wus=
+github.com/go-webtools/knife4go v1.0.4 h1:p32SApmM0sx2/Y5p0QfeaGv5KD96R1mj2CaHdyH8jy8=
+github.com/go-webtools/knife4go v1.0.4/go.mod h1:trOlXN1tqBJ7R44sHON3exGvzCwjbsVriIHEenry3d8=
+github.com/goccy/go-json v0.10.5 h1:Fq85nIqj+gXn/S5ahsiTlK3TmC85qgirsdTP/+DeaC4=
+github.com/goccy/go-json v0.10.5/go.mod h1:oq7eo15ShAhp70Anwd5lgX2pLfOS3QCiwU/PULtXL6M=
+github.com/google/go-cmp v0.6.0 h1:ofyhxvXcZhMsU5ulbFiLKl/XBFqE1GSq7atu8tAmTRI=
+github.com/google/go-cmp v0.6.0/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY=
 github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg=
+github.com/google/gofuzz v1.2.0 h1:xRy4A+RhZaiKjJ1bPfwQ8sedCA+YS2YcCHW6ec7JMi0=
+github.com/google/gofuzz v1.2.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg=
 github.com/gorilla/websocket v1.5.3 h1:saDtZ6Pbx/0u+bgYQ3q96pZgCzfhKXGPqt7kZ72aNNg=
 github.com/gorilla/websocket v1.5.3/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE=
 github.com/jonboulle/clockwork v0.3.0 h1:9BSCMi8C+0qdApAp4auwX0RkLGUjs956h0EkuQymUhg=
 github.com/jonboulle/clockwork v0.3.0/go.mod h1:Pkfl5aHPm1nk2H9h0bjmnJD/BcgbGXUBGnn1kMkgxc8=
+github.com/josharian/intern v1.0.0 h1:vlS4z54oSdjm0bgjRigI+G1HpF+tI+9rE5LLzOg8HmY=
+github.com/josharian/intern v1.0.0/go.mod h1:5DoeVV0s6jJacbCEi61lwdGj/aVlrQvzHFFd8Hwg//Y=
 github.com/json-iterator/go v1.1.12 h1:PV8peI4a0ysnczrg+LtxykD8LfKY9ML6u2jnxaEnrnM=
 github.com/json-iterator/go v1.1.12/go.mod h1:e30LSqwooZae/UwlEbR2852Gd8hjQvJoHmT4TnhNGBo=
 github.com/klauspost/cpuid/v2 v2.0.9/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg=
-github.com/klauspost/cpuid/v2 v2.2.8 h1:+StwCXwm9PdpiEkPyzBXIy+M9KUb4ODm0Zarf1kS5BM=
-github.com/klauspost/cpuid/v2 v2.2.8/go.mod h1:Lcz8mBdAVJIBVzewtcLocK12l3Y+JytZYpaMropDUws=
+github.com/klauspost/cpuid/v2 v2.2.10 h1:tBs3QSyvjDyFTq3uoc/9xFpCuOsJQFNPiAhYdw2skhE=
+github.com/klauspost/cpuid/v2 v2.2.10/go.mod h1:hqwkgyIinND0mEev00jJYCxPNVRVXFQeu1XKlok6oO0=
 github.com/knz/go-libedit v1.10.1/go.mod h1:MZTVkCWyz0oBc7JOWP3wNAzd002ZbM/5hgShxwh4x8M=
+github.com/kr/pretty v0.3.1 h1:flRD4NNwYAUpkphVc1HcthR4KEIFJ65n8Mw5qdRn3LE=
+github.com/kr/pretty v0.3.1/go.mod h1:hoEshYVHaxMs3cyo3Yncou5ZscifuDolrwPKZanG3xk=
 github.com/kr/pty v1.1.1/go.mod h1:pFQYn66WHrOpPYNljwOMqo10TkYh1fy3cYio2l3bCsQ=
 github.com/kr/text v0.1.0/go.mod h1:4Jbv+DJW3UT/LiOwJeYQe1efqtUx/iVham/4vfdArNI=
 github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY=
@ -103,6 +106,8 @@ github.com/lestrrat-go/file-rotatelogs v2.4.0+incompatible h1:Y6sqxHMyB1D2YSzWkL
 github.com/lestrrat-go/file-rotatelogs v2.4.0+incompatible/go.mod h1:ZQnN8lSECaebrkQytbHj4xNgtg8CR7RYXnPok8e0EHA=
 github.com/lestrrat-go/strftime v1.1.0 h1:gMESpZy44/4pXLO/m+sL0yBd1W6LjgjrrD4a68Gapyg=
 github.com/lestrrat-go/strftime v1.1.0/go.mod h1:uzeIB52CeUJenCo1syghlugshMysrqUT51HlxphXVeI=
+github.com/mailru/easyjson v0.9.0 h1:PrnmzHw7262yW8sTBwxi1PdJA3Iw/EKBa8psRf7d9a4=
+github.com/mailru/easyjson v0.9.0/go.mod h1:1+xMtQp2MRNVL/V1bOzuP3aP8VNwRW55fQUto+XFtTU=
 github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
 github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
 github.com/mcuadros/go-defaults v1.2.0 h1:FODb8WSf0uGaY8elWJAkoLL0Ri6AlZ1bFlenk56oZtc=
@ -120,7 +125,6 @@ github.com/mozillazg/go-pinyin v0.20.0 h1:BtR3DsxpApHfKReaPO1fCqF4pThRwH9uwvXzm+
 github.com/mozillazg/go-pinyin v0.20.0/go.mod h1:iR4EnMMRXkfpFVV5FMi4FNB6wGq9NV6uDWbUuPhP4Yc=
 github.com/mssola/user_agent v0.6.0 h1:uwPR4rtWlCHRFyyP9u2KOV0u8iQXmS7Z7feTrstQwk4=
 github.com/mssola/user_agent v0.6.0/go.mod h1:TTPno8LPY3wAIEKRpAtkdMT0f8SE24pLRGPahjCH4uw=
-github.com/niemeyer/pretty v0.0.0-20200227124842-a10e7caefd8e h1:fD57ERR4JtEqsWbfPhv4DMiApHyliiK5xCTNVSPiaAs=
 github.com/niemeyer/pretty v0.0.0-20200227124842-a10e7caefd8e/go.mod h1:zD1mROLANZcx1PVRCS0qkT7pwLkGfwJo4zjcN/Tysno=
 github.com/pelletier/go-toml/v2 v2.2.3 h1:YmeHyLY8mFWbdkNWwpr+qIL2bEqT0o95WSdkNHvL12M=
 github.com/pelletier/go-toml/v2 v2.2.3/go.mod h1:MfCQTFTvCcUyyvvwm1+G6H/jORL20Xlb6rzQu9GuUkc=
@ -128,6 +132,8 @@ github.com/pkg/errors v0.9.1 h1:FEBLx1zS214owpjy7qsBeixbURkuhQAwrK5UwLGTwt4=
 github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0=
 github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
 github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/rogpeppe/go-internal v1.11.0 h1:cWPaGQEPrBb5/AsnsZesgZZ9yb1OQ+GOISoDNXVBh4M=
+github.com/rogpeppe/go-internal v1.11.0/go.mod h1:ddIwULY96R17DhadqLgMfk9H9tvdUzkipdSkR5nkCZA=
 github.com/sbabiv/xml2map v1.2.1 h1:1lT7t0hhUvXZCkdxqtq4n8/ZCnwLWGq4rDuDv5XOoFE=
 github.com/sbabiv/xml2map v1.2.1/go.mod h1:2TPoAfcaM7+Sd4iriPvzyntb2mx7GY+kkQpB/GQa/eo=
 github.com/spaolacci/murmur3 v1.1.0 h1:7c1g84S4BPRrfL5Xrdp6fOJ206sU9y293DDHaoy0bLI=
@ -135,15 +141,21 @@ github.com/spaolacci/murmur3 v1.1.0/go.mod h1:JwIasOWyU6f++ZhiEuf87xNszmSA2myDM2
 github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
 github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw=
 github.com/stretchr/objx v0.5.0/go.mod h1:Yh+to48EsGEfYuaHDzXPcE3xhTkx73EhmCGUpEOglKo=
+github.com/stretchr/objx v0.5.2/go.mod h1:FRsXN1f5AsAjCGJKqEizvkpNtU+EGNCLh3NxZ/8L+MA=
 github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
 github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
 github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
 github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU=
 github.com/stretchr/testify v1.8.1/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4=
-github.com/stretchr/testify v1.9.0 h1:HtqpIVDClZ4nwg75+f6Lvsy/wHu+3BoSGCbBAcpTsTg=
-github.com/stretchr/testify v1.9.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
-github.com/tidwall/gjson v1.17.3 h1:bwWLZU7icoKRG+C+0PNwIKC6FCJO/Q3p2pZvuP0jN94=
-github.com/tidwall/gjson v1.17.3/go.mod h1:/wbyibRr2FHMks5tjHJ5F8dMZh3AcwJEMf5vlfC0lxk=
+github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo=
+github.com/stretchr/testify v1.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA=
+github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
+github.com/swaggo/files v1.0.1 h1:J1bVJ4XHZNq0I46UU90611i9/YzdrF7x92oX1ig5IdE=
+github.com/swaggo/files v1.0.1/go.mod h1:0qXmMNH6sXNf+73t65aKeB+ApmgxdnkQzVTAj2uaMUg=
+github.com/swaggo/gin-swagger v1.6.0 h1:y8sxvQ3E20/RCyrXeFfg60r6H0Z+SwpTjMYsMm+zy8M=
+github.com/swaggo/gin-swagger v1.6.0/go.mod h1:BG00cCEy294xtVpyIAHG6+e2Qzj/xKlRdOqDkvq0uzo=
+github.com/swaggo/swag v1.16.4 h1:clWJtd9LStiG3VeijiCfOVODP6VpHtKdQy9ELFG3s1A=
+github.com/swaggo/swag v1.16.4/go.mod h1:VBsHJRsDvfYvqoiMKnsdwhNV9LEMHgEDZcyVYX0sxPg=
 github.com/tidwall/gjson v1.18.0 h1:FIDeeyB800efLX89e5a8Y0BNH+LOngJyGrIWxG2FKQY=
 github.com/tidwall/gjson v1.18.0/go.mod h1:/wbyibRr2FHMks5tjHJ5F8dMZh3AcwJEMf5vlfC0lxk=
 github.com/tidwall/match v1.1.1 h1:+Ho715JplO36QYgwN9PGYNhgZvoUSc9X2c80KVTi+GA=
@ -155,43 +167,64 @@ github.com/twitchyliquid64/golang-asm v0.15.1 h1:SU5vSMR7hnwNxj24w34ZyCi/FmDZTkS
 github.com/twitchyliquid64/golang-asm v0.15.1/go.mod h1:a1lVb/DtPvCB8fslRZhAngC2+aY1QWCk3Cedj/Gdt08=
 github.com/ugorji/go/codec v1.2.12 h1:9LC83zGrHhuUA9l16C9AHXAqEV/2wBQ4nkvumAE65EE=
 github.com/ugorji/go/codec v1.2.12/go.mod h1:UNopzCgEMSXjBc6AOMqYvWC1ktqTAfzJZUZgYf6w6lg=
+github.com/yuin/goldmark v1.4.13/go.mod h1:6yULJ656Px+3vBD8DxQVa3kxgyrAnzto9xy5taEt/CY=
 go.uber.org/goleak v1.3.0 h1:2K3zAYmnTNqV73imy9J1T3WC+gmCePx2hEGkimedGto=
 go.uber.org/goleak v1.3.0/go.mod h1:CoHD4mav9JJNrW/WLlf7HGZPjdw8EucARQHekz1X6bE=
 go.uber.org/multierr v1.11.0 h1:blXXJkSxSSfBVBlC76pxqeO+LN3aDfLQo+309xJstO0=
 go.uber.org/multierr v1.11.0/go.mod h1:20+QtiLqy0Nd6FdQB9TLXag12DsQkrbs3htMFfDN80Y=
 go.uber.org/zap v1.27.0 h1:aJMhYGrd5QSmlpLMr2MftRKl7t8J8PTZPA732ud/XR8=
 go.uber.org/zap v1.27.0/go.mod h1:GB2qFLM7cTU87MWRP2mPIjqfIDnGu+VIO4V/SdhGo2E=
-golang.org/x/arch v0.10.0 h1:S3huipmSclq3PJMNe76NGwkBR504WFkQ5dhzWzP8ZW8=
-golang.org/x/arch v0.10.0/go.mod h1:FEVrYAQjsQXMVJ1nsMoVVXPZg6p2JE2mx8psSWTDQys=
-golang.org/x/arch v0.11.0 h1:KXV8WWKCXm6tRpLirl2szsO5j/oOODwZf4hATmGVNs4=
-golang.org/x/arch v0.11.0/go.mod h1:FEVrYAQjsQXMVJ1nsMoVVXPZg6p2JE2mx8psSWTDQys=
-golang.org/x/crypto v0.27.0 h1:GXm2NjJrPaiv/h1tb2UH8QfgC/hOf/+z0p6PT8o1w7A=
-golang.org/x/crypto v0.27.0/go.mod h1:1Xngt8kV6Dvbssa53Ziq6Eqn0HqbZi5Z6R0ZpwQzt70=
-golang.org/x/crypto v0.28.0 h1:GBDwsMXVQi34v5CCYUm2jkJvu4cbtru2U4TN2PSyQnw=
-golang.org/x/crypto v0.28.0/go.mod h1:rmgy+3RHxRZMyY0jjAJShp2zgEdOqj2AO7U0pYmeQ7U=
-golang.org/x/net v0.29.0 h1:5ORfpBpCs4HzDYoodCDBbwHzdR5UrLBZ3sOnUJmFoHo=
-golang.org/x/net v0.29.0/go.mod h1:gLkgy8jTGERgjzMic6DS9+SP0ajcu6Xu3Orq/SpETg0=
-golang.org/x/net v0.30.0 h1:AcW1SDZMkb8IpzCdQUaIq2sP4sZ4zw+55h6ynffypl4=
-golang.org/x/net v0.30.0/go.mod h1:2wGyMJ5iFasEhkwi13ChkO/t1ECNC4X4eBKkVFyYFlU=
+golang.org/x/arch v0.14.0 h1:z9JUEZWr8x4rR0OU6c4/4t6E6jOZ8/QBS2bBYBm4tx4=
+golang.org/x/arch v0.14.0/go.mod h1:FEVrYAQjsQXMVJ1nsMoVVXPZg6p2JE2mx8psSWTDQys=
+golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w=
+golang.org/x/crypto v0.0.0-20210921155107-089bfa567519/go.mod h1:GvvjBRRGRdwPK5ydBHafDWAxML/pGHZbMvKqRZ5+Abc=
+golang.org/x/crypto v0.35.0 h1:b15kiHdrGCHrP6LvwaQ3c03kgNhhiMgvlhxHQhmg2Xs=
+golang.org/x/crypto v0.35.0/go.mod h1:dy7dXNW32cAb/6/PRuTNsix8T+vJAqvuIy5Bli/x0YQ=
+golang.org/x/mod v0.6.0-dev.0.20220419223038-86c51ed26bb4/go.mod h1:jJ57K6gSWd91VN4djpZkiMVwK6gcyfeH4XE8wZrZaV4=
+golang.org/x/mod v0.23.0 h1:Zb7khfcRGKk+kqfxFaP5tZqCnDZMjC5VtUBs87Hr6QM=
+golang.org/x/mod v0.23.0/go.mod h1:6SkKJ3Xj0I0BrPOZoBy3bdMptDDU9oJrpohJ3eWZ1fY=
+golang.org/x/net v0.0.0-20190620200207-3b0461eec859/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
+golang.org/x/net v0.0.0-20210226172049-e18ecbb05110/go.mod h1:m0MpNAwzfU5UDzcl9v0D8zg8gWTRqZa9RBIspLL5mdg=
+golang.org/x/net v0.0.0-20220722155237-a158d28d115b/go.mod h1:XRhObCWvk6IyKnWLug+ECip1KBveYUHfp+8e9klMJ9c=
+golang.org/x/net v0.7.0/go.mod h1:2Tu9+aMcznHK/AK1HMvgo6xiTLG5rD5rZLDS+rp2Bjs=
+golang.org/x/net v0.35.0 h1:T5GQRQb2y08kTAByq9L4/bz8cipCdA8FbRTXewonqY8=
+golang.org/x/net v0.35.0/go.mod h1:EglIi67kWsHKlRzzVMUD93VMSWGFOMSZgxFjparz1Qk=
+golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
+golang.org/x/sync v0.0.0-20220722155255-886fb9371eb4/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
+golang.org/x/sync v0.11.0 h1:GGz8+XQP4FvTTrjZPzNKTMFtSXH80RAzG+5ghFPgK9w=
+golang.org/x/sync v0.11.0/go.mod h1:Czt+wKu1gCyEFDUtn0jG5QVvpJ6rzVqr5aXyt9drQfk=
+golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
+golang.org/x/sys v0.0.0-20201119102817-f84b799fce68/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
+golang.org/x/sys v0.0.0-20210615035016-665e8c7367d1/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.0.0-20220520151302-bc2c85ada10a/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.0.0-20220722155257-8c9f86f7a55f/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.5.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.25.0 h1:r+8e+loiHxRqhXVl6ML1nO3l1+oFoWbnlu2Ehimmi34=
-golang.org/x/sys v0.25.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=
-golang.org/x/sys v0.26.0 h1:KHjCJyddX0LoSTb3J+vWpupP9p0oznkqVk/IfjymZbo=
-golang.org/x/sys v0.26.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=
-golang.org/x/text v0.18.0 h1:XvMDiNzPAl0jr17s6W9lcaIhGUfUORdGCNsuLmPG224=
-golang.org/x/text v0.18.0/go.mod h1:BuEKDfySbSR4drPmRPG/7iBdf8hvFMuRexcpahXilzY=
-golang.org/x/text v0.19.0 h1:kTxAhCbGbxhK0IwgSKiMO5awPoDQ0RpfiVYBfK860YM=
-golang.org/x/text v0.19.0/go.mod h1:BuEKDfySbSR4drPmRPG/7iBdf8hvFMuRexcpahXilzY=
+golang.org/x/sys v0.30.0 h1:QjkSwP/36a20jFYWkSue1YwXzLmsV5Gfq7Eiy72C1uc=
+golang.org/x/sys v0.30.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=
+golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo=
+golang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8=
+golang.org/x/term v0.5.0/go.mod h1:jMB1sMXY+tzblOD4FWmEbocvup2/aLOaQEp7JmGp78k=
+golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
+golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=
+golang.org/x/text v0.3.7/go.mod h1:u+2+/6zg+i71rQMx5EYifcz6MCKuco9NR6JIITiCfzQ=
+golang.org/x/text v0.7.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8=
+golang.org/x/text v0.22.0 h1:bofq7m3/HAFvbF51jz3Q9wLg3jkvSPuiZu/pD1XwgtM=
+golang.org/x/text v0.22.0/go.mod h1:YRoo4H8PVmsu+E3Ou7cqLVH8oXWIHVoX0jqUWALQhfY=
+golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=
+golang.org/x/tools v0.0.0-20191119224855-298f0cb1881e/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo=
+golang.org/x/tools v0.1.12/go.mod h1:hNGJHUnrk76NpqgfD5Aqm5Crs+Hm0VOH/i9J2+nxYbc=
+golang.org/x/tools v0.30.0 h1:BgcpHewrV5AUp2G9MebG4XPFI1E2W41zU1SaqVA9vJY=
+golang.org/x/tools v0.30.0/go.mod h1:c347cR/OJfw5TI+GfX7RUPNMdDRRbjvYTS0jPyvsVtY=
+golang.org/x/xerrors v0.0.0-20190717185122-a985d3407aa7/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
 golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543 h1:E7g+9GITq07hpfrRu66IVDexMakfv52eLZ2CXBWiKr4=
 golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
-google.golang.org/protobuf v1.34.2 h1:6xV6lTsCfpGD21XK49h7MhtcApnLqkfYgPcdHftf6hg=
-google.golang.org/protobuf v1.34.2/go.mod h1:qYOHts0dSfpeUzUFpOMr/WGzszTmLH+DiWniOlNbLDw=
-google.golang.org/protobuf v1.35.1 h1:m3LfL6/Ca+fqnjnlqQXNpFPABW1UD7mjh8KO2mKFytA=
-google.golang.org/protobuf v1.35.1/go.mod h1:9fA7Ob0pmnwhb644+1+CVWFRbNajQ6iRojtC/QF5bRE=
+google.golang.org/protobuf v1.36.5 h1:tPhr+woSbjfYvY6/GPufUoYizxw1cF/yFoxJ2fmpwlM=
+google.golang.org/protobuf v1.36.5/go.mod h1:9fA7Ob0pmnwhb644+1+CVWFRbNajQ6iRojtC/QF5bRE=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
-gopkg.in/check.v1 v1.0.0-20200227125254-8fa46927fb4f h1:BLraFXnmrev5lT+xlilqcH8XK9/i0At2xKjWk4p6zsU=
 gopkg.in/check.v1 v1.0.0-20200227125254-8fa46927fb4f/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk=
+gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q=
 gopkg.in/olahol/melody.v1 v1.0.0-20170518105555-d52139073376 h1:sY2a+y0j4iDrajJcorb+a0hJIQ6uakU5gybjfLWHlXo=
 gopkg.in/olahol/melody.v1 v1.0.0-20170518105555-d52139073376/go.mod h1:BHKOc1m5wm8WwQkMqYBoo4vNxhmF7xg8+xhG8L+Cy3M=
 gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
--- a/request/context.go
+++ b/request/context.go
@ -0,0 +1,200 @@
+// Package request ...
+//
+// Description : request ...
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 2025-02-28 11:45
+package request
+
+import (
+	"fmt"
+	networkUtil "git.zhangdeman.cn/zhangdeman/network/util"
+	"git.zhangdeman.cn/zhangdeman/trace"
+	"git.zhangdeman.cn/zhangdeman/wrapper"
+	"github.com/gin-gonic/gin"
+	"os"
+	"strings"
+	"sync"
+	"time"
+)
+
+// getTraceID 生成traceID
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 23:12 2022/6/25
+func getTraceID(ctx *gin.Context) string {
+	hostname, _ := os.Hostname()
+	if hostname != "" {
+		hostname = "unknown"
+	}
+	return fmt.Sprintf(
+		"%v-%v-%v-%v-%v",
+		time.Now().UnixNano()/1e6,
+		strings.ReplaceAll(networkUtil.IP.GetHostIP(), ".", ""),
+		strings.ReplaceAll(hostname, ".", ""),
+		strings.ReplaceAll(networkUtil.IP.GetRemoteIP(ctx.Request), ".", ""),
+		wrapper.StringFromRandom(32, "").Md5().Value,
+	)
+}
+
+// getRequestID 生成requestID
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 23:12 2022/6/25
+func getRequestID(ctx *gin.Context, traceID string) string {
+	requestID := ctx.GetHeader("X-Forward-Request-Id")
+	if len(requestID) > 0 {
+		return requestID
+	}
+	if len(traceID) > 0 {
+		return traceID
+	}
+	return getTraceID(ctx)
+}
+
+// NewContext 获取context实例
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 12:01 2025/2/28
+func NewContext(ginContext *gin.Context) *Context {
+	// 生成traceID
+	traceID := getRequestID(ginContext, "")
+	hostname, _ := os.Hostname()
+	return &Context{
+		Context:              ginContext,
+		StartRequestTime:     time.Now(),
+		FinishRequestTime:    time.Unix(0, 0),
+		HandlerAfterResponse: make([]gin.HandlerFunc, 0),
+		customData:           make(map[string]any),
+		Hostname:             hostname,
+		HostIp:               networkUtil.IP.GetHostIP(),
+		customLock:           &sync.RWMutex{},
+		TraceID:              traceID,
+		Trace:                trace.NewRuntime(traceID, 0),
+	}
+}
+
+// Context 请求上下文信息, 对 ctx *gin.Context的二次包装
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 11:45 2025/2/28
+type Context struct {
+	*gin.Context         `json:"-"`
+	StartRequestTime     time.Time         `json:"start_request_time"`  // 开始请求时间(全局)
+	FinishRequestTime    time.Time         `json:"finish_request_time"` // 结束请求时间(全局)
+	TraceID              string            `json:"trace_id"`            // 请求trace_id
+	ParentAppName        string            `json:"parent_app_name"`     // 父级应用名称
+	HandlerAfterResponse []gin.HandlerFunc `json:"-"`                   // 响应数据之后需要执行的逻辑
+	Hostname             string            `json:"hostname"`            // 服务器名称
+	HostIp               string            `json:"host_ip"`             // 服务器IP
+	customData           map[string]any    `json:"-"`                   // 业务上下文自定义数据, 可以合 ginCtx.Value 作区分
+	customLock           *sync.RWMutex     `json:"-"`                   // 数据锁
+	Trace                *trace.Runtime    `json:"-"`                   // 追踪实例
+}
+
+// SetCustom 设置数据
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 11:58 2025/2/28
+func (ctx *Context) SetCustom(key string, val any) {
+	ctx.customLock.Lock()
+	defer ctx.customLock.Unlock()
+	if nil == ctx.customData {
+		ctx.customData = make(map[string]any)
+	}
+	ctx.Set(key, val)
+	ctx.customData[key] = val
+}
+
+// customDataValue 获取customData
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 12:03 2025/2/28
+func (ctx *Context) customDataValue(key string) any {
+	ctx.customLock.RLock()
+	defer ctx.customLock.RUnlock()
+	if val, exist := ctx.customData[key]; exist {
+		return val
+	} else {
+		return ctx.Value(key)
+	}
+}
+
+// customDataExist 判断
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 12:04 2025/2/28
+func (ctx *Context) customDataExist(key string) any {
+	ctx.customLock.RLock()
+	defer ctx.customLock.RUnlock()
+	_, exist := ctx.customData[key]
+	return exist
+}
+
+// customDataAppend 向数组数据中追加元素
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 12:07 2025/2/28
+func (ctx *Context) customDataAppend(key string, appendValue any) {
+	ctx.customLock.Lock()
+	defer ctx.customLock.Unlock()
+	val, exist := ctx.customData[key]
+	if !exist || nil == val {
+		ctx.customData[key] = []any{appendValue}
+		return
+	}
+	if valArr, ok := val.([]any); ok {
+		valArr = append(valArr, appendValue)
+		ctx.customData[key] = valArr
+	}
+	// 非数组, 忽略追加行为
+}
+
+// customDataAppendProperty 向一个map中追加/更新属性
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 12:11 2025/2/28
+func (ctx *Context) customDataAppendProperty(key string, appendKey string, appendValue any) {
+	ctx.customLock.Lock()
+	defer ctx.customLock.Unlock()
+	val, exist := ctx.customData[key]
+	if !exist || nil == val {
+		ctx.customData[key] = map[string]any{
+			appendKey: appendValue,
+		}
+		return
+	}
+	if valMap, ok := val.(map[string]any); ok {
+		valMap[appendKey] = appendValue
+		ctx.customData[key] = valMap
+	}
+	// 非map, 忽略追加行为
+}
+
+// TraceStart 开始监控
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 12:24 2025/2/28
+func (ctx *Context) TraceStart(action string, actionData map[string]any) int {
+	return ctx.Trace.StartBehavior(action, actionData)
+}
+
+// TraceEnd 完成监控
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 12:24 2025/2/28
+func (ctx *Context) TraceEnd(behaviorID int, endData map[string]any) {
+	ctx.Trace.FinishBehavior(behaviorID, endData)
+}
--- a/request/form.go
+++ b/request/form.go
@ -12,7 +12,6 @@ import (
 	"errors"
 	"github.com/mcuadros/go-defaults"
 	"io"
-	"io/ioutil"
 	"net/http"
 	"strings"

@ -43,7 +42,7 @@ func (f *form) Parse(ctx *gin.Context, receiver interface{}) error {
 	// 请求信息写入上下文
 	ctx.Set(handleConfig.RecordRequestDataField, string(requestBody))
 	// 因为请求体被读一遍之后就没了，重新赋值 requestBody
-	ctx.Request.Body = ioutil.NopCloser(bytes.NewReader(requestBody))
+	ctx.Request.Body = io.NopCloser(bytes.NewReader(requestBody))
 	method := strings.ToUpper(ctx.Request.Method)
 	if method == http.MethodGet ||
 		method == http.MethodPatch ||
--- a/request/wrapper.go
+++ b/request/wrapper.go
@ -8,10 +8,12 @@
 package request

 import (
+	"git.zhangdeman.cn/zhangdeman/gin/define"
 	"git.zhangdeman.cn/zhangdeman/gin/request/parse_body"
 	"git.zhangdeman.cn/zhangdeman/wrapper"
 	"github.com/gin-gonic/gin"
 	"strings"
+	"sync"
 )

 var (
@ -115,8 +117,8 @@ func (wh *wrapperHandle) GetContentType(ctx *gin.Context, defaultVal string) str
 	if nil == ctx {
 		return defaultVal
 	}
-	contentType := strings.ToLower(ctx.ContentType())
-	return wrapper.TernaryOperator.String(len(contentType) > 0, wrapper.String(contentType), wrapper.String(defaultVal)).Value()
+	contentTypeVal := strings.ToLower(ctx.ContentType())
+	return wrapper.TernaryOperator.String(len(contentTypeVal) > 0, wrapper.String(contentTypeVal), wrapper.String(defaultVal)).Value()
 }

 // GetDomain 获取请求Domain
@ -268,3 +270,77 @@ func (wh *wrapperHandle) ParseCookie(ctx *gin.Context) map[string]string {
 	}
 	return cookieData
 }
+
+// Copy 复制context
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 11:00 2025/2/28
+//
+// - ctx *gin.Context ： 基于哪一个context复制context
+// - isCopyContextValue bool : 是否继承父级ctx的自定义value
+func (wh *wrapperHandle) Copy(ctx *gin.Context, isCopyContextValue bool, excludeKeyList []string) *gin.Context {
+	if nil == ctx {
+		return nil
+	}
+	newContext := ctx.Copy()
+	excludeKeyTable := map[string]bool{}
+	for _, excludeKey := range excludeKeyList {
+		excludeKeyTable[excludeKey] = true
+	}
+	if isCopyContextValue {
+		// 上下文设置的业务数据值也继承下来, TODO: 并发读写此处可能panic
+		for k, v := range newContext.Keys {
+			if !excludeKeyTable[k] {
+				// 没有指定不继承
+				ctx.Set(k, v)
+			}
+		}
+	}
+	// 设置父级context
+	ctx.Set("parent_context", ctx)
+	if nil == ctx.Value("root_context") {
+		ctx.Set("root_context", ctx)
+	}
+	return newContext
+}
+
+// GetLogicAfterResponse ...
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 16:54 2025/2/28
+func (wh *wrapperHandle) GetLogicAfterResponse(ctx *gin.Context) *define.LogicAfterResponse {
+	if nil == ctx || nil == ctx.Request {
+		return nil
+	}
+	l, exist := ctx.Get(define.LogicAfterResponseKey)
+	if !exist || nil == l {
+		l = &define.LogicAfterResponse{
+			SuccessHookFuncList: make([]func(), 0),
+			FailureHookFuncList: make([]func(), 0),
+			Lock:                &sync.RWMutex{},
+		}
+		ctx.Set(define.LogicAfterResponseKey, l)
+	}
+	// 就这么写, key值如果被其他人覆盖成非法值, 此处会直接panic
+	return l.(*define.LogicAfterResponse)
+}
+
+// GetGinWrapperContext 获取包装之后context
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 14:41 2025/3/10
+func (wh *wrapperHandle) GetGinWrapperContext(ctx *gin.Context) *Context {
+	if nil == ctx {
+		return nil
+	}
+	if val, exist := ctx.Get(define.GinWrapperContextKey); !exist || nil == val {
+		newCtx := NewContext(ctx)
+		newCtx.SetCustom(define.GinWrapperContextKey, newCtx)
+		return newCtx
+	} else {
+		return val.(*Context)
+	}
+}
--- a/router/README.md
+++ b/router/README.md
@ -0,0 +1,110 @@
+# 路由包使用说明
+
+## 基础说明
+
+- 基于 [web框架GIN](https://github.com/gin-gonic/gin) 的二次封装
+
+## 为什么要二次封装
+
+二次封装的想法来源于 [web框架GoFrame](https://github.com/gogf/gf)。gf框架本身内置集成了大量组件, 对于轻量应用开发, 相比较而言比较笨重, 但是启根据请求数据结构、响应数据结构自动生成表单的能力十分实用。
+在采用gin开发时，一般接口文档有两种选择 : 
+- 在内部文档平台手搓文档, 并人工维护, 此方案最终演变方式大概率为文档主键滞后，与接口实现并不一致
+- 利用golang的文档生成工具[swag]() 自动生成swagger文档, 此种方案需要在代码中引入大量swag工具解析时需要的注释, 且当输入/输出发生变化时需要维护相关注释
+基于以上问题, 对gin的路由注册进行二次封装
+
+## 二次封装解决哪些问题
+
+- 文档维护的繁琐性 : 会通过反射自动基于 **`请求的数据结构 + 返回的数据结构`** , 生成接口文档, 专注于数据结构设计即可, 无需关注文档相关内容, 程序接管, 自动生成
+- 做接口设计的统一性规范约束, 如 :
+  - 入参数据类型不能为 any
+  - 入参类型不能为 map , 但是特定字段特定场景, 可以强行禁用此规则等
+  - 返回值必须为结构体等
+
+## 设计方案
+
+### 【可选】路由组定义
+
+路由组可以通过函数进行定义, 函数名必须需为 : **`RouterPrefix`** , 函数无任何参数, 返回路由组名称, 示例 : 
+
+```go
+type TestController struct{}
+
+func (t *TestController) RouterPrefix() string {
+	return "/uri/prefix"
+}
+```
+
+### 【可选】路由组中间件定义
+
+路由组中间件可以通过函数进行定义, 函数名必须需为 : **`RouterMiddleware`** , 函数无任何参数, 返回路由组中间件列表 **`[]gin.HandlerFunc`**, 示例 :
+
+```go
+type TestController struct{}
+
+func (t *TestController) RouterPrefix() string {
+	return "/uri/prefix"
+}
+
+func (t *TestController) RouterMiddleware() []gin.HandlerFunc {
+	return []gin.HandlerFunc{
+		func(ctx *gin.Context) {
+
+		},
+	}
+}
+```
+
+### 接口逻辑处理定义
+
+接口逻辑处理函数, 函数名称自定义, 必须是个 **`可导出函数`** , 函数接收两个参数, 分别是 :
+
+- *gin.Context : gin框架的上下文信息
+- any: 表单参数 **结构体指针** , 注意 : 类型必须为结构体指针
+
+函数返回值有两个 :
+- any : 返回的业务数据, 必须是个 **`结构体指针`**
+- error : 可以是内置的 **error** , 也可以是 **exception.IException** , 建议使用 exception.IException , 可承载更多的异常信息
+
+## 使用方式
+
+```go
+type TestController struct{}
+
+func (t *TestController) RouterPrefix() string {
+	return "/uri/prefix"
+}
+
+func (t *TestController) RouterMiddleware() []gin.HandlerFunc {
+	return []gin.HandlerFunc{
+		func(ctx *gin.Context) {
+
+		},
+	}
+}
+func (t *TestController) Uri(ctx *gin.Context, formData *TestForm) (any, error) {
+	return formData, nil
+}
+
+type TestForm struct {
+	Meta `tag:"测试表单" path:"/a/b/c/d" desc:"测试接口" method:"get" strict:"true"`
+	Age  int    `json:"age" form:"age"`
+	Name string `json:"name" form:"name"`
+	Test *Test  `json:"test" form:"test"`
+	Num  *int64 `json:"num" form:"num"`
+}
+type Test struct {
+	L string `json:"l"`
+}
+
+func Test_parseController(t *testing.T) {
+	type args struct {
+		controller any
+	}
+	Register(8080, &TestController{})
+}
+```
+
+注意事项:
+
+- Register 方法第一个入参是监听的端口
+- 后面若干个controller实例, 朱一必须以指针的方式传入
--- a/router/api.go
+++ b/router/api.go
@ -1,35 +0,0 @@
-// Package router ...
-//
-// Description : 便捷的相关API处理
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 2021-03-26 2:06 下午
-package router
-
-import (
-	"github.com/gin-gonic/gin"
-)
-
-// IApi 每一个接口的实现约束
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 2:08 下午 2021/3/26
-type IApi interface {
-	// GetMethod 接口请求方法
-	GetMethod() string
-	// GetURI 接口URI
-	GetURI() string
-	// GetMiddleWareList 使用的中间件列表
-	GetMiddleWareList() []gin.HandlerFunc
-	// GetHandler 处理的handler
-	GetHandler() gin.HandlerFunc
-}
-
-// RegisterFunc 注册路由的函数
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 3:09 下午 2021/3/26
-type RegisterFunc func() (method string, uri string, handlerFunc gin.HandlerFunc, middlewareList []gin.HandlerFunc)
--- a/router/config.go
+++ b/router/config.go
@ -0,0 +1,25 @@
+// Package router ...
+//
+// Description : router ...
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 2025-02-07 17:41
+package router
+
+import "strings"
+
+var defaultValidateErrTag = "err"
+
+// SetValidateErrTag 设置验证失败时, 获取错误信息的tag字段
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 17:42 2025/2/7
+func SetValidateErrTag(tagName string) {
+	tagName = strings.TrimSpace(tagName)
+	if tagName == "" {
+		return
+	}
+	defaultValidateErrTag = tagName
+}
--- a/router/controller.go
+++ b/router/controller.go
@ -0,0 +1,153 @@
+// Package router ...
+//
+// Description : router ...
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 2025-01-27 15:29
+package router
+
+import (
+	"reflect"
+	"strings"
+)
+
+// controller 解析controller有哪些方法要注册为接口
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 15:30 2025/1/27
+type controller struct {
+}
+
+// Parse 执行解析
+//
+// 符合注册为借口的方法具有如下特征:
+//
+// 1. 函数接受两个入参, 第一个参数为 gin.Context , 第二个参数为 任意结构体指针, 但是必须声明 Meta 相关信息, 否则会报错
+//
+// 2. 函数有两个返回值, 第一个返回值为任意结构体/结构体指针(限制死不能为map/slice, 方便后续统一标准化) , 第二个返回值为 error , 代表处理的异常, 会自动适配 exception.IException 类型
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 15:31 2025/1/27
+func (c controller) Parse(inputController any) map[string]UriConfig {
+	parseRes := make(map[string]UriConfig)
+	if nil == inputController {
+		return parseRes
+	}
+	controllerType := reflect.TypeOf(inputController)
+	inputController = reflect.New(controllerType).Interface()
+	controllerType = reflect.TypeOf(inputController)
+	controllerValue := reflect.ValueOf(inputController)
+	for methodIdx := 0; methodIdx < controllerType.NumMethod(); methodIdx++ {
+		uriCfg, needRegister := c.methodConfig(controllerType.Method(methodIdx))
+		if !needRegister {
+			continue
+		}
+		uriCfg.ApiStructValue = controllerValue
+		parseRes[uriCfg.Path] = uriCfg
+	}
+	return parseRes
+}
+
+// methodConfig 解析方法配置, 要求函数格式， 两个参数, 两个返回值, 格式 : func(ctx *gin.Context, formData anyStruct[组合Meta]) (anyStruct|map[response], error)
+//
+// 参数 : 方法反射结果
+//
+// 返回值 : 第一个 -> 解析出的接口配置 第二个 -> 是否要注册为接口
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 16:05 2025/1/27
+func (c controller) methodConfig(reflectMethod reflect.Method) (cfg UriConfig, needRegister bool) {
+	methodType := reflectMethod.Type
+	// num0: 函数声明
+	// num1: 第一个参数
+	// num2: 第二个参数
+	if methodType.NumIn() != 3 {
+		needRegister = false
+		return
+	}
+	// 第一个参数必须是 *gin.Context
+	firstParamStr := methodType.In(1).String()
+	if firstParamStr != GinContextType && firstParamStr != GinWrapperContextType {
+		needRegister = false
+		return
+	}
+	// 解析第二个参数是组合Meta的form表单
+	formType := methodType.In(2)
+	cfg.FormDataType = formType
+	if formType.Kind() == reflect.Ptr {
+		formType = methodType.In(2).Elem()
+	}
+	metaField, metaFieldExist := formType.FieldByName(FieldNameMeta)
+	if !metaFieldExist {
+		needRegister = false
+		return
+	}
+	cfg.ResultDataType = methodType.Out(0)
+	if cfg.ResultDataType == nil {
+	}
+	if methodType.Out(1).Kind().String() != ErrorType {
+		// 判断是否是实现 error接口的方法
+		outputErrParse := false
+		for j := 0; j < methodType.Out(1).NumMethod(); j++ {
+			if methodType.Out(1).Method(j).Name == ErrorInterfaceFuncName && // 实现Error方法
+				methodType.Out(1).Method(j).Type.NumIn() == 0 && // 没有任何参数
+				methodType.Out(1).Method(j).Type.NumOut() == 1 && // 一个返回值
+				methodType.Out(1).Method(j).Type.Out(0).Kind().String() == reflect.String.String() {
+				outputErrParse = true
+				break
+			}
+		}
+		if !outputErrParse {
+			needRegister = false
+			return
+		}
+	}
+	// 是否gin包装后的context
+	cfg.IsGinWrapperContext = firstParamStr == GinWrapperContextType
+	// 解析meta信息
+	cfg.Path = metaField.Tag.Get(TagNamePath)
+	cfg.RequestMethod = metaField.Tag.Get(TagNameMethod)
+	cfg.Desc = metaField.Tag.Get(TagNameDesc)
+	cfg.TagList = strings.Split(metaField.Tag.Get(TagNameUriTag), ",")
+	// 解析第一个返回值, 要求必须是结构体或者是map
+	outputStrictModel := metaField.Tag.Get(TagNameOutputStrict)
+	cfg.OutputStrict = outputStrictModel == "1" || outputStrictModel == "true"
+	if cfg.OutputStrict {
+		// 开启输出严格模式校验
+		if methodType.Out(0).Kind() != reflect.Struct && methodType.Out(0).Kind() != reflect.Map {
+			panic(cfg.Path + " : 接口配置输出严格校验, 输出数据类型必须为 struct 或 *struct 或 map, 实际返回数据类型 : " + methodType.Out(0).Kind().String())
+			return
+		}
+	}
+	// 解析参数配置
+	//cfg.ParamList = c.parseParamConfig(formType)
+	cfg.ApiLogicFunc = reflectMethod
+	needRegister = true
+	return
+}
+
+// parseParamConfig 解析参数配置
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 14:35 2025/2/7
+func (c controller) parseParamConfig(formDataType reflect.Type) []UriParam {
+	res := make([]UriParam, 0)
+	for i := 0; i < formDataType.NumField(); i++ {
+		structField := formDataType.Field(i)
+		if structField.Name == FieldNameMeta {
+			// Meta 字段, 忽略
+			continue
+		}
+		jsonTag := structField.Tag.Get("json")
+		if jsonTag == "" {
+			jsonTag = structField.Name
+		}
+
+	}
+	return res
+}
--- a/router/define.go
+++ b/router/define.go
@ -0,0 +1,69 @@
+// Package router ...
+//
+// Description : router ...
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 2024-07-20 22:57
+package router
+
+import (
+	"reflect"
+)
+
+const (
+	PrefixFuncName         = "RouterPrefix"     // 路由前缀函数名称
+	MiddlewareFuncName     = "RouterMiddleware" // 路由中间件函数名称
+	GinContextType         = "*gin.Context"     // gin context 类型名称
+	GinWrapperContextType  = "*request.Context" // gin context 类型名称
+	ErrorType              = "error"            // error类型
+	ErrorInterfaceFuncName = "Error"            // error接口需要实现的方法名称
+)
+
+const (
+	TagNamePath         = "path"          // 接口的请求路径
+	TagNameMethod       = "method"        // 接口的请求方法
+	TagNameUriTag       = "tag"           // 接口的tag
+	TagNameDesc         = "desc"          // 接口的描述
+	TagNameOutputStrict = "output_strict" // 接口数据是否为严格模式 : 严格模式, 响应数据必须是结构体/map，非严格模式返回任意值
+	TagNameBinding      = "binding"       // gin 内置的验证规则tag
+	TagNameValidate     = "validate"      // validator v10 默认的验证规则tag
+	TagNameErrMsg       = "err"           // 验证失败错误信息tag
+)
+
+// UriConfig 接口配置
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 15:41 2024/7/21
+type UriConfig struct {
+	Path                string         `json:"path"`                   // 接口路由, 必须配置
+	RequestMethod       string         `json:"request_method"`         // 接口请求方法, 必须配置
+	TagList             []string       `json:"tag_list"`               // 接口分组
+	Desc                string         `json:"desc"`                   // 接口描述
+	OutputStrict        bool           `json:"output_strict"`          // 接口是否为严格模式 : 不配置,可返回任意类型, 配置, 必须返回结构体或者map
+	FormDataType        reflect.Type   `json:"-"`                      // 表单数据类型
+	ResultDataType      reflect.Type   `json:"-"`                      // 返回值数据类型
+	ApiStructValue      reflect.Value  `json:"-"`                      // 逻辑函数所属结构体取值
+	ApiLogicFunc        reflect.Method `json:"-"`                      // 自定义的接口逻辑
+	IsGinWrapperContext bool           `json:"is_gin_wrapper_context"` // 是否gin包装后的context
+}
+
+// UriParam 接口参数配置
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 15:40 2025/1/27
+type UriParam struct {
+	Field           string `json:"field"`             // 结构体字段
+	Name            string `json:"name"`              // 参数名称
+	Type            string `json:"type"`              // 参数类型
+	Validate        string `json:"validate"`          // 验证规则: validator/v10 库
+	ErrorMsg        string `json:"error_msg"`         // 验证失败的错误信息
+	DisableAutoType bool   `json:"disable_auto_type"` // 禁用自动类型转换
+	Sort            string `json:"sort"`              // 参数读取顺序: 默认 POST : body > query > path GET : query > path > body
+}
+
+const (
+	FieldNameMeta = "Meta" // 元信息字段
+)
--- a/router/doc.go
+++ b/router/doc.go
@ -0,0 +1,43 @@
+// Package router ...
+//
+// Description : router ...
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 2025-02-14 21:48
+package router
+
+import (
+	"reflect"
+
+	apiDoc "git.zhangdeman.cn/gateway/api-doc"
+	"git.zhangdeman.cn/gateway/api-doc/define"
+)
+
+func NewDoc(info *define.Info, servers []*define.ServerItem) *Doc {
+	return &Doc{
+		instance: apiDoc.NewOpenapiDoc(info, servers),
+	}
+}
+
+type Doc struct {
+	instance *apiDoc.Generate
+}
+
+// Add 增加接口文档测试
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 21:55 2025/2/14
+func (d *Doc) Add(routePrefix string, paramType reflect.Type, resultType reflect.Type) {
+	_ = d.instance.AddApiFromInAndOut(routePrefix, paramType, resultType)
+}
+
+// Data 文档数据
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 21:59 2025/2/14
+func (d *Doc) Data() *define.OpenapiDoc {
+	return d.instance.Doc()
+}
--- a/router/handler.go
+++ b/router/handler.go
@ -0,0 +1,109 @@
+// Package router ...
+//
+// Description : router ...
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 2025-01-27 19:42
+package router
+
+import (
+	"git.zhangdeman.cn/zhangdeman/exception"
+	"git.zhangdeman.cn/zhangdeman/gin/define"
+	"git.zhangdeman.cn/zhangdeman/gin/request"
+	"git.zhangdeman.cn/zhangdeman/gin/response"
+	"github.com/gin-gonic/gin"
+	"reflect"
+	"sync"
+)
+
+// RequestHandler 获取请求处理方法
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 19:44 2025/1/27
+func RequestHandler(uriCfg UriConfig) gin.HandlerFunc {
+	return func(ctx *gin.Context) {
+		var (
+			err error
+			ok  bool
+			e   exception.IException
+		)
+
+		var formParam reflect.Value
+		if uriCfg.FormDataType.Kind() == reflect.Ptr {
+			formParam = reflect.New(uriCfg.FormDataType.Elem())
+		} else {
+			// 表单解析
+			formParam = reflect.New(uriCfg.FormDataType)
+		}
+		formValue := formParam.Interface()
+		if err = request.Form.Parse(ctx, formValue); nil != err {
+			// 格式化验证错误的信息
+			err = GetValidateErr(formValue, err)
+			e = exception.NewFromError(400, err)
+			response.SendWithException(ctx, e, nil)
+			ctx.Abort()
+			return
+		}
+
+		isSuccess := false
+		// 初始化响应之后logic
+		logicAfterResponse := &define.LogicAfterResponse{
+			SuccessHookFuncList: make([]func(), 0),
+			FailureHookFuncList: make([]func(), 0),
+			Lock:                &sync.RWMutex{},
+		}
+		// 此处暴露出去,是为了使用方可以获取到对应数据
+		ctx.Set(define.LogicAfterResponseKey, logicAfterResponse)
+		defer func() {
+			go func() {
+				defer recover()
+				if isSuccess {
+					for _, itemFunc := range logicAfterResponse.SuccessHookFuncList {
+						if nil != itemFunc {
+							itemFunc()
+						}
+					}
+				} else {
+					for _, itemFunc := range logicAfterResponse.FailureHookFuncList {
+						if nil != itemFunc {
+							itemFunc()
+						}
+					}
+				}
+			}()
+		}()
+		// 执行逻辑
+		inputValue := reflect.ValueOf(formValue)
+		if uriCfg.FormDataType.Kind() != reflect.Ptr {
+			inputValue = inputValue.Elem()
+		}
+		ginWrapperContext := request.NewContext(ctx)
+		// wrapper context 设置到 gin context
+		ginWrapperContext.Set(define.GinWrapperContextKey, ginWrapperContext)
+		ctxReflect := reflect.ValueOf(ctx)
+		if uriCfg.IsGinWrapperContext {
+			ctxReflect = reflect.ValueOf(ginWrapperContext)
+		}
+		resList := uriCfg.ApiLogicFunc.Func.Call([]reflect.Value{uriCfg.ApiStructValue, ctxReflect, inputValue})
+		if resList[1].IsNil() {
+			// 请求成功
+			isSuccess = true
+			response.Success(ctx, resList[0].Interface())
+			return
+		}
+		// 请求失败
+		if e, ok = resList[1].Interface().(exception.IException); ok {
+			// 本身就是exception.IException
+		} else if err, ok = resList[1].Interface().(error); ok {
+			e = exception.NewFromError(-1, err)
+		} else {
+			e = exception.NewWithCodeAndData(-1, map[string]any{
+				"err": resList[1].Interface(),
+			})
+		}
+		response.SendWithException(ctx, e, nil)
+		return
+	}
+}
--- a/router/meta.go
+++ b/router/meta.go
@ -0,0 +1,19 @@
+// Package router ...
+//
+// Description : router ...
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 2024-07-20 21:40
+package router
+
+// Meta 接口的元信息, 主要包含如下信息:
+//
+// uri: 接口路由(不包含group前缀)
+//
+// method: 请求方法: get/post 等
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 21:40 2024/7/20
+type Meta struct{}
--- a/router/option.go
+++ b/router/option.go
@ -0,0 +1,162 @@
+// Package router ...
+//
+// Description : router ...
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 2025-02-18 17:26
+package router
+
+import (
+	apiDocDefine "git.zhangdeman.cn/gateway/api-doc/define"
+	"git.zhangdeman.cn/zhangdeman/gin/middleware"
+	"github.com/gin-gonic/gin"
+	"strings"
+)
+
+type SetServerOptionFunc func(so *serverOption)
+
+// serverOption 获取server实例的选项
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 17:28 2025/2/18
+type serverOption struct {
+	swaggerUiTheme       string                     // swagger 主题
+	swaggerBaseUri       string                     // swagger基础path
+	globalMiddlewareList []gin.HandlerFunc          // 全局中间件列表
+	disableSwaggerDoc    bool                       // 禁用swagger文档, 特定环境不想展示文档, 可通过次方式禁用
+	serverInfo           *apiDocDefine.Info         // 服务器信息
+	serverList           []*apiDocDefine.ServerItem // 服务器环境列表
+	enablePprof          bool                       // 启用pprof
+	enableRequestInit    bool                       // 初始化请求,生成trace_id 设置请求时间等
+	enableCors           bool                       // 启动跨域支持
+	loggerCfg            *middleware.AccessConfig   // 日志配置
+}
+
+// WithSwaggerUITheme 设置swaggerUI主题
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 17:29 2025/2/18
+func WithSwaggerUITheme(uiTheme string) SetServerOptionFunc {
+	return func(so *serverOption) {
+		uiTheme = strings.TrimSpace(uiTheme)
+		if len(uiTheme) == 0 {
+			return
+		}
+		so.swaggerUiTheme = uiTheme
+	}
+}
+
+// WithGlobalMiddlewareList 设置全局中间件
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 17:33 2025/2/18
+func WithGlobalMiddlewareList(middlewareList ...gin.HandlerFunc) SetServerOptionFunc {
+	return func(so *serverOption) {
+		so.globalMiddlewareList = middlewareList
+	}
+}
+
+// WithSwaggerBaseUri ...
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 18:05 2025/2/18
+func WithSwaggerBaseUri(baseUri string) SetServerOptionFunc {
+	return func(so *serverOption) {
+		baseUri = strings.TrimSpace(baseUri)
+		if len(baseUri) == 0 {
+			return
+		}
+		baseUri = "/" + strings.TrimLeft(baseUri, "/")
+		so.swaggerBaseUri = baseUri
+	}
+}
+
+// WithDisableSwaggerDoc 禁用swagger文档
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 17:35 2025/2/18
+func WithDisableSwaggerDoc() SetServerOptionFunc {
+	return func(so *serverOption) {
+		so.disableSwaggerDoc = true
+	}
+}
+
+// WithServerInfo 设置serverInfo
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 17:51 2025/2/18
+func WithServerInfo(serverInfo *apiDocDefine.Info) SetServerOptionFunc {
+	return func(so *serverOption) {
+		if nil == serverInfo {
+			return
+		}
+		so.serverInfo = serverInfo
+	}
+}
+
+// WithServerList 设置服务器列表
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 17:52 2025/2/18
+func WithServerList(serverList []*apiDocDefine.ServerItem) SetServerOptionFunc {
+	return func(so *serverOption) {
+		if len(serverList) == 0 {
+			return
+		}
+		so.serverList = serverList
+	}
+}
+
+// WithPprofEnable 启用pprof
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 15:10 2025/2/21
+func WithPprofEnable() SetServerOptionFunc {
+	return func(so *serverOption) {
+		so.enablePprof = true
+	}
+}
+
+// WithEnableRequestInit 全局配置初始化
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 14:56 2025/2/22
+func WithEnableRequestInit() SetServerOptionFunc {
+	return func(so *serverOption) {
+		so.enableRequestInit = true
+	}
+}
+
+// WithEnableCors 启用全局跨域
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 14:56 2025/2/22
+func WithEnableCors() SetServerOptionFunc {
+	return func(so *serverOption) {
+		so.enableCors = true
+	}
+}
+
+// WithLoggerCfg ...
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 15:25 2025/2/22
+func WithLoggerCfg(loggerCfg *middleware.AccessConfig) SetServerOptionFunc {
+	return func(so *serverOption) {
+		if nil != loggerCfg || nil != loggerCfg.Logger {
+			so.loggerCfg = loggerCfg
+		}
+	}
+}
--- a/router/register.go
+++ b/router/register.go
@ -1,115 +1,214 @@
 // Package router ...
 //
-// Description : 注册路由
+// Description : router ...
 //
 // Author : go_developer@163.com<白茶清欢>
 //
-// Date : 2021-03-26 2:13 下午
+// Date : 2024-07-20 21:39
 package router

 import (
-	"log"
-	"reflect"
-
-	"github.com/pkg/errors"
-
+	"fmt"
+	"git.zhangdeman.cn/zhangdeman/exception"
+	"git.zhangdeman.cn/zhangdeman/gin/middleware"
+	"git.zhangdeman.cn/zhangdeman/gin/request"
+	"git.zhangdeman.cn/zhangdeman/gin/response"
+	"git.zhangdeman.cn/zhangdeman/wrapper"
 	"github.com/gin-gonic/gin"
+	"net/http"
+	"reflect"
+	"strings"
 )

 var (
-	// DebugLogEnable 默认打开debug日志
-	DebugLogEnable = true
+	Debug     = false // 是否开启DEBUG
+	ginRouter = gin.Default()
 )

-// DisableDebugLog 禁用debug日志
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 2:17 下午 2021/3/26
-func DisableDebugLog() {
-	DebugLogEnable = false
+func init() {
+
 }

-// RegisterRouter 注册一个路由
+// Register 注册路由
 //
 // Author : go_developer@163.com<白茶清欢>
 //
-// Date : 2:14 下午 2021/3/26
-func RegisterRouter(router *gin.Engine, apiInstanceList ...any) error {
-	for _, apiInstance := range apiInstanceList {
-		if nil == apiInstance {
+// Date : 21:40 2024/7/20
+func Register(port int, controllerList ...any) error {
+	for _, itemController := range controllerList {
+		if nil == itemController {
+			// 忽略空指针
 			continue
 		}
-		val := reflect.ValueOf(apiInstance)
-		switch val.Kind() {
-		case reflect.Struct:
-			fallthrough
-		case reflect.Ptr:
-			api, ok := apiInstance.(IApi)
-			if ok {
-				if err := HandleRegisterRouter(router, api.GetMethod(), api.GetURI(), api.GetHandler(), api.GetMiddleWareList()); nil != err {
-					routerLog(err.Error())
-					return err
-				}
-				continue
-			}
-			routerLog(val.String() + "结构体或者结构体指针, 自动识别函数是否包含RouterFunc")
-			// 不是IApi接口,自动识别函数列表 RouterFunc 函数自动注册
-			methodCnt := val.NumMethod()
-			for i := 0; i < methodCnt; i++ {
-				// TODO : 识别函数本身是不是 RouterFunc
-				af, o := val.Method(i).Interface().(func() (string, string, gin.HandlerFunc, []gin.HandlerFunc))
-				if o {
-					method, uri, handler, middlewareList := af()
-					if err := HandleRegisterRouter(router, method, uri, handler, middlewareList); nil != err {
-						routerLog(err.Error())
-						return err
-					}
-					continue
-				}
-				apiFuncList := val.Method(i).Call(nil)
-				for _, apiFuncVal := range apiFuncList {
-					apiFunc, ok := apiFuncVal.Interface().(RegisterFunc)
-					if !ok {
-						continue
-					}
-					method, uri, handler, middlewareList := apiFunc()
-					if err := HandleRegisterRouter(router, method, uri, handler, middlewareList); nil != err {
-						routerLog(err.Error())
-						return err
-					}
-				}
-
-			}
-		case reflect.Func:
-			api, ok := apiInstance.(RegisterFunc)
-			if !ok {
-				err := errors.New("函数方式注册路由必须是 RouterFunc")
-				routerLog(err.Error())
-				return err
-			}
-			method, uri, handler, middlewareList := api()
-			if err := HandleRegisterRouter(router, method, uri, handler, middlewareList); nil != err {
-				routerLog(err.Error())
-				return err
-			}
-		default:
-			err := errors.New("注册的路由必须是 IApi 或者 RouterFunc 或者 包含 RouterFunc 的结构体")
-			routerLog(err.Error())
-			return err
-		}
+		parseController(itemController)
 	}
-	return nil
+	return ginRouter.Run(fmt.Sprintf(":%d", port))
 }

-// routerLog 记录日志
+// parseController 解析controller
 //
 // Author : go_developer@163.com<白茶清欢>
 //
-// Date : 2:28 下午 2021/3/26
-func routerLog(msg string) {
-	if !DebugLogEnable || len(msg) == 0 {
+// Date : 22:10 2024/7/20
+func parseController(controller any) {
+	controllerType := reflect.TypeOf(controller)
+	controllerValue := reflect.ValueOf(controller)
+	routerPrefix := "/"
+	// 解析路由前缀函数
+	// routerPrefix 不能有任何入参, 并且只能有一个返回值,
+	// 返回值类型为字符串, 为具体路由前缀
+	routerPrefixFunc, routerPrefixFuncExist := controllerType.MethodByName(PrefixFuncName)
+	if routerPrefixFuncExist {
+		routerPrefixFuncType := routerPrefixFunc.Type
+		if routerPrefixFuncType.NumIn() == 1 && // 无任何入参, 正在没有如何入参情况下, 第一个参数是结构体指针
+			routerPrefixFuncType.NumOut() == 1 && // 只能有一个返回值
+			routerPrefixFuncType.Out(0).Kind() == reflect.String { // 返回值必须是字符串
+			routerPrefix = routerPrefixFunc.Func.Call([]reflect.Value{controllerValue})[0].String()
+		}
+	}
+	// 请求组的中间件
+	middlewareList := make([]gin.HandlerFunc, 0)
+	routerMiddlewareFunc, routerMiddlewareFuncExist := controllerType.MethodByName(MiddlewareFuncName)
+	if routerMiddlewareFuncExist {
+		routerMiddlewareFuncType := routerMiddlewareFunc.Type
+		if routerMiddlewareFuncType.NumIn() == 1 && // 无需任何参数
+			routerMiddlewareFuncType.NumOut() == 1 && // 只能有一个返回值
+			routerMiddlewareFuncType.Out(0).String() == "[]gin.HandlerFunc" { // 返回值必须是gin.HandlerFunc
+			res := routerMiddlewareFunc.Func.Call([]reflect.Value{controllerValue})
+			if !res[0].IsNil() {
+				middlewareList = res[0].Interface().([]gin.HandlerFunc)
+			}
+		}
+	}
+	for funcIdx := 0; funcIdx < controllerType.NumMethod(); funcIdx++ {
+		method := controllerType.Method(funcIdx)
+		if method.Name == PrefixFuncName || method.Name == MiddlewareFuncName {
+			continue
+		}
+		methodType := method.Type
+		uriConfig, err := parseUriConfig(methodType, routerPrefix)
+		if nil != err {
+			debugLog("parseUriConfig error : %s -> %s", err.Error(), methodType.Kind().String())
+		}
+		if nil == uriConfig {
+			continue
+		}
+		registerUri(uriConfig, controllerValue.Method(funcIdx), middlewareList)
+	}
+}
+
+// parseUriConfig 解析Uri配置
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 16:40 2024/7/21
+func parseUriConfig(methodType reflect.Type, routerPrefix string) (*UriConfig, error) {
+	if methodType.NumIn() != 3 || // 结构体指针 + 两个参数
+		methodType.NumOut() != 2 { // 两个返回值
+		return nil, nil
+	}
+	// 接口logic共计两个参数. 两个返回值, 格式 : func(ctx *gin.Context, formData any[组合Meta]) (any[response], error)
+
+	// 解析第一个参数是 *gin.Context / 或者包装后的 request.Context
+	firstParamStr := methodType.In(1).String()
+	if firstParamStr != "*gin.Context" && firstParamStr != "*request.Context" {
+		return nil, nil
+	}
+	// 解析第二个参数是组合Meta的form表单
+	formType := methodType.In(2)
+	if formType.Kind() == reflect.Ptr {
+		formType = methodType.In(2).Elem()
+	}
+	metaField, metaFieldExist := formType.FieldByName(FieldNameMeta)
+	if !metaFieldExist {
+		return nil, nil
+	}
+	uriConfig := &UriConfig{
+		Path:          strings.TrimRight(routerPrefix, "/") + "/" + strings.TrimLeft(metaField.Tag.Get(TagNamePath), "/"),
+		RequestMethod: strings.ToUpper(metaField.Tag.Get(TagNameMethod)),
+		TagList:       strings.Split(metaField.Tag.Get(TagNameUriTag), "|"),
+		Desc:          metaField.Tag.Get(TagNameDesc),
+		OutputStrict:  wrapper.ArrayType([]string{"", "true"}).Has(strings.ToLower(metaField.Tag.Get(TagNameOutputStrict))) >= 0,
+		FormDataType:  methodType.In(2).Elem(),
+	}
+	// 校验 FormDataType
+	for fieldIdx := 0; fieldIdx < uriConfig.FormDataType.NumField(); fieldIdx++ {
+		if uriConfig.FormDataType.Field(fieldIdx).Type.Kind() == reflect.Interface {
+			panic("request param set type `interface` is not allowed")
+		}
+	}
+	return uriConfig, nil
+}
+
+// registerUri 注册路由
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 18:00 2024/7/21
+func registerUri(uriConfig *UriConfig, methodValue reflect.Value, middlewareList []gin.HandlerFunc) {
+	if nil == middlewareList {
+		middlewareList = make([]gin.HandlerFunc, 0)
+	}
+	handlerFunc := func(ctx *gin.Context) {
+		formDataReceiver := reflect.New(uriConfig.FormDataType)
+		if err := request.Form.Parse(ctx, formDataReceiver.Interface()); nil != err {
+			panic(err)
+		}
+
+		returnValue := methodValue.Call([]reflect.Value{reflect.ValueOf(ctx), formDataReceiver})
+		businessData := returnValue[0].Interface()
+		errData := returnValue[1]
+		if errData.IsNil() {
+			response.Success(ctx, businessData)
+			return
+		}
+		err := errData.Interface()
+		if e, ok := err.(exception.IException); ok {
+			response.SendWithException(ctx, e, map[string]any{"business_data": businessData})
+			return
+		} else {
+			response.SendWithException(ctx, exception.NewFromError(-1, errData.Interface().(error)), map[string]any{"business_data": businessData})
+			return
+		}
+	}
+	middlewareList = append(middlewareList, handlerFunc)
+	middlewareList = append([]gin.HandlerFunc{
+		middleware.InitRequest(),
+	}, middlewareList...)
+	switch uriConfig.RequestMethod {
+	case http.MethodGet:
+		ginRouter.GET(uriConfig.Path, middlewareList...)
+	case http.MethodHead:
+		ginRouter.HEAD(uriConfig.Path, middlewareList...)
+	case http.MethodPost:
+		ginRouter.PUT(uriConfig.Path, middlewareList...)
+	case http.MethodPut:
+		ginRouter.PUT(uriConfig.Path, middlewareList...)
+	case http.MethodPatch:
+		ginRouter.PATCH(uriConfig.Path, middlewareList...)
+	case http.MethodDelete:
+		ginRouter.DELETE(uriConfig.Path, middlewareList...)
+	case http.MethodConnect:
+		ginRouter.Handle(http.MethodConnect, uriConfig.Path, middlewareList...)
+	case http.MethodOptions:
+		ginRouter.OPTIONS(uriConfig.Path, middlewareList...)
+	case http.MethodTrace:
+		ginRouter.Handle(http.MethodTrace, uriConfig.Path, middlewareList...)
+	case "ANY":
+		ginRouter.Any(uriConfig.Path, middlewareList...)
+	default:
+		panic(uriConfig.Path + " : " + uriConfig.RequestMethod + " is not support")
+	}
+}
+
+// debugLog ...
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 15:32 2024/7/21
+func debugLog(format string, valList ...any) {
+	if !Debug {
 		return
 	}
-	log.Print(msg)
+	fmt.Printf("[DEBUG] "+format+"\n", valList...)
 }
--- a/router/register_router_test.go
+++ b/router/register_router_test.go
@ -1,78 +0,0 @@
-// Package router ...
-//
-// Description : 路由注册单元测试
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 2021-03-26 3:49 下午
-package router
-
-import (
-	"net/http"
-	"testing"
-
-	"github.com/stretchr/testify/assert"
-
-	"github.com/gin-gonic/gin"
-)
-
-// TestRegisterRouter ...
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 3:50 下午 2021/3/26
-func TestRegisterRouter(t *testing.T) {
-	r := gin.Default()
-	err := RegisterRouter(r, demoApiFunc(), &demoApi{}, &otherApi{}, nil)
-	assert.Nil(t, err, "路由注册异常 : %v", err)
-}
-
-func demoApiFunc() RegisterFunc {
-	return func() (method string, uri string, handlerFunc gin.HandlerFunc, middlewareList []gin.HandlerFunc) {
-		return http.MethodGet, "/api/func/test", func(context *gin.Context) {
-
-		}, nil
-	}
-}
-
-type demoApi struct {
-}
-
-func (d demoApi) GetMethod() string {
-	return http.MethodGet
-}
-
-func (d demoApi) GetURI() string {
-	return "/api/struct/test"
-}
-
-func (d demoApi) GetMiddleWareList() []gin.HandlerFunc {
-	return nil
-}
-
-func (d demoApi) GetHandler() gin.HandlerFunc {
-	return func(context *gin.Context) {
-
-	}
-}
-
-type otherApi struct {
-}
-
-func (oa *otherApi) DemoApiFunc() RegisterFunc {
-	return func() (method string, uri string, handlerFunc gin.HandlerFunc, middlewareList []gin.HandlerFunc) {
-		return http.MethodGet, "/api/other/test", func(context *gin.Context) {
-
-		}, nil
-	}
-}
-
-func (oa *otherApi) Lala() {
-
-}
-
-func (oa *otherApi) SelfApi() (method string, uri string, handlerFunc gin.HandlerFunc, middlewareList []gin.HandlerFunc) {
-	return http.MethodGet, "/api/other/self/test", func(context *gin.Context) {
-
-	}, nil
-}
--- a/router/register_test.go
+++ b/router/register_test.go
@ -0,0 +1,47 @@
+// Package router ...
+//
+// Description : router ...
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 2024-07-20 23:24
+package router
+
+import (
+	"git.zhangdeman.cn/zhangdeman/gin/request"
+	"testing"
+)
+
+type TestController struct{}
+
+func (t TestController) Logic(ctx *request.Context, formData *TestForm) (TestOut, error) {
+	return TestOut{
+		FormData: formData,
+	}, nil
+}
+
+type TestOut struct {
+	Age      int       `json:"age" form:"age" binding:"min=20" err_msg:"年龄不能小于20"`
+	Name     string    `json:"name" form:"name"`
+	Test     *Test     `json:"test" form:"test"`
+	Num      *int64    `json:"num" form:"num"`
+	FormData *TestForm `json:"form_data" form:"form_data"`
+}
+
+type TestForm struct {
+	Meta `tag:"测试表单" path:"/a/b/c/d" desc:"测试接口" method:"GET"`
+	Age  int    `json:"age" form:"age" binding:"min=20" err_msg:"年龄不能小于20"`
+	Name string `json:"name" form:"name"`
+	Test *Test  `json:"test" form:"test"`
+	Num  *int64 `json:"num" form:"num"`
+}
+type Test struct {
+	L string `json:"l"`
+}
+
+func Test_parseController(t *testing.T) {
+	SetValidateErrTag("err_msg")
+	s := NewServer(8888, nil)
+	s.Group("test", nil, TestController{})
+	s.Start()
+}
--- a/router/server.go
+++ b/router/server.go
@ -0,0 +1,205 @@
+// Package router ...
+//
+// Description : router ...
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 2025-02-07 18:19
+package router
+
+import (
+	"fmt"
+	apiDoc "git.zhangdeman.cn/gateway/api-doc"
+	"git.zhangdeman.cn/zhangdeman/consts"
+	"git.zhangdeman.cn/zhangdeman/gin/middleware"
+	"git.zhangdeman.cn/zhangdeman/gin/middleware/request_cors"
+	"github.com/gin-contrib/pprof"
+	"net/http"
+	"strings"
+
+	apiDocDefine "git.zhangdeman.cn/gateway/api-doc/define"
+	"github.com/gin-gonic/gin"
+)
+
+func newServerOption(port int, optionList ...SetServerOptionFunc) *serverOption {
+	option := &serverOption{
+		swaggerUiTheme:       apiDocDefine.SwaggerUIThemeRedocFree,
+		swaggerBaseUri:       "/doc/swagger",
+		globalMiddlewareList: nil,
+		disableSwaggerDoc:    false,
+		serverInfo: &apiDocDefine.Info{
+			Description:    "这是一个微服务，提供一些必要的的数据接口功能",
+			Title:          "微服务接口文档",
+			TermsOfService: "",
+			Contact: &apiDocDefine.Contact{
+				Name:  "开发人员",
+				Url:   "",
+				Email: "developer@example.com",
+			},
+			License: &apiDocDefine.License{
+				Name: consts.LicenseApache20,
+				Url:  consts.LicenseUrlTable[consts.LicenseApache20],
+			},
+			Version: "0.0.1",
+		},
+		serverList: []*apiDocDefine.ServerItem{
+			{
+				Url:         fmt.Sprintf("http://127.0.0.1:%d", port),
+				Description: "测试服务器",
+				Variables:   nil,
+			},
+		},
+	}
+	for _, opt := range optionList {
+		if nil == opt {
+			continue
+		}
+		opt(option)
+	}
+	return option
+}
+
+// NewServer server实例
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 18:20 2025/2/7
+func NewServer(port int, optionList ...SetServerOptionFunc) *server {
+	if port < 80 {
+		panic("port should be greater than 80")
+	}
+	option := newServerOption(port, optionList...)
+	globalMiddlewareList := make([]gin.HandlerFunc, 0)
+	if option.enableRequestInit {
+		// 初始化请求中间件
+		globalMiddlewareList = append(globalMiddlewareList, middleware.InitRequest())
+	}
+	if nil != option.loggerCfg {
+		// 请求日志记录中间件
+		globalMiddlewareList = append(globalMiddlewareList, middleware.LogRequest(option.loggerCfg))
+	}
+	if option.enableCors {
+		// 跨域中间件
+		globalMiddlewareList = append(globalMiddlewareList, request_cors.New(request_cors.Config{
+			AllowAllOrigins:        true,
+			AllowOrigins:           nil,
+			AllowOriginFunc:        nil,
+			AllowMethods:           []string{"*"},
+			AllowHeaders:           []string{"*"},
+			AllowCredentials:       true,
+			ExposeHeaders:          nil,
+			MaxAge:                 0,
+			AllowWildcard:          true,
+			AllowBrowserExtensions: true,
+			AllowWebSockets:        true,
+			AllowFiles:             true,
+		}))
+	}
+	if len(option.globalMiddlewareList) > 0 {
+		// 自定义全局中间件追加
+		globalMiddlewareList = append(globalMiddlewareList, option.globalMiddlewareList...)
+	}
+	r := gin.Default()
+
+	// 注册全局中间件
+	r.Use(globalMiddlewareList...)
+
+	// 启用pprof, 注册相关路由
+	if option.enablePprof {
+		pprof.Register(r)
+	}
+	return &server{
+		router:     r,
+		uiInstance: apiDoc.NewSwaggerUI(option.serverInfo, option.serverList, option.swaggerUiTheme),
+		port:       port,
+		option:     option,
+	}
+}
+
+type server struct {
+	router     *gin.Engine
+	port       int
+	uiInstance *apiDoc.SwaggerUI
+	option     *serverOption
+}
+
+// Start 启动服务
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 18:31 2025/2/7
+func (s *server) Start() {
+	// 注册文档
+	s.uiInstance.RegisterHandler(s.router, s.option.swaggerBaseUri)
+	if err := s.router.Run(fmt.Sprintf(":%d", s.port)); err != nil {
+		panic("服务启动监听失败" + err.Error())
+	}
+}
+
+// Router 对外访问路由实例, 不建议直接用
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 17:35 2025/2/18
+func (s *server) Router() *gin.Engine {
+	return s.router
+}
+
+// Handler404 注册404的处理方法
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 16:01 2025/2/22
+func (s *server) Handler404(f gin.HandlerFunc) {
+	s.router.NoRoute(f)
+}
+
+// SetCustomRouter 自定义路由处理
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 16:09 2025/2/22
+func (s *server) SetCustomRouter(f func(r *gin.Engine)) {
+	if nil == f {
+		return
+	}
+	f(s.router)
+}
+
+// Group 注册接口路由
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 19:35 2025/1/27
+func (s *server) Group(routerPrefix string, middlewareList []gin.HandlerFunc, cList ...any) {
+	g := s.router.Group(routerPrefix)
+	g.Use(middlewareList...)
+	cParser := controller{}
+	for _, c := range cList {
+		urlTable := cParser.Parse(c)
+		for _, itemUriCfg := range urlTable {
+			_ = s.uiInstance.DocInstance().AddApiFromInAndOut(routerPrefix, itemUriCfg.FormDataType, itemUriCfg.ResultDataType)
+			method := strings.ToUpper(itemUriCfg.RequestMethod)
+			switch method {
+			case http.MethodGet:
+				g.GET(itemUriCfg.Path, RequestHandler(itemUriCfg))
+			case http.MethodHead:
+				g.HEAD(itemUriCfg.Path, RequestHandler(itemUriCfg))
+			case http.MethodPost:
+				g.POST(itemUriCfg.Path, RequestHandler(itemUriCfg))
+			case http.MethodPut:
+				g.PUT(itemUriCfg.Path, RequestHandler(itemUriCfg))
+			case http.MethodPatch:
+				g.PATCH(itemUriCfg.Path, RequestHandler(itemUriCfg))
+			case http.MethodDelete:
+				g.DELETE(itemUriCfg.Path, RequestHandler(itemUriCfg))
+			case http.MethodOptions:
+				g.OPTIONS(itemUriCfg.Path, RequestHandler(itemUriCfg))
+			case http.MethodTrace:
+				panic(`method Trace is not supported`)
+			default:
+				panic("method " + itemUriCfg.RequestMethod + " is not support")
+			}
+		}
+	}
+}
--- a/router/util.go
+++ b/router/util.go
@ -1,79 +0,0 @@
-// Package router ...
-//
-// Description : router ...
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 2023-03-03 16:48
-package router
-
-import (
-	"fmt"
-	"net/http"
-	"strings"
-
-	"github.com/gin-gonic/gin"
-)
-
-// HandleRegisterRouter 注册gin路由
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 8:36 下午 2021/3/9
-func HandleRegisterRouter(router *gin.Engine, method string, uri string, handler gin.HandlerFunc, middlewareList []gin.HandlerFunc) error {
-	if nil == middlewareList {
-		middlewareList = make([]gin.HandlerFunc, 0)
-	}
-	switch strings.ToUpper(method) {
-	case http.MethodGet:
-		router.GET(uri, handler).Use(middlewareList...)
-	case http.MethodPost:
-		router.POST(uri, handler).Use(middlewareList...)
-	case http.MethodDelete:
-		router.DELETE(uri, handler).Use(middlewareList...)
-	case http.MethodHead:
-		router.HEAD(uri, handler).Use(middlewareList...)
-	case http.MethodOptions:
-		router.OPTIONS(uri, handler).Use(middlewareList...)
-	case http.MethodPatch:
-		router.PATCH(uri, handler).Use(middlewareList...)
-	case http.MethodPut:
-		router.PUT(uri, handler).Use(middlewareList...)
-	case "ANY": // 一次性注册全部请求方法的路由
-		router.Any(uri, handler).Use(middlewareList...)
-	default:
-		// 不是一个函数,数名method配置错误
-		return fmt.Errorf("uri=%s method=%s 请求方法配置错误", uri, method)
-	}
-	return nil
-}
-
-// RegisterRouterGroup 注册gin路由
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 8:36 下午 2021/3/9
-func RegisterRouterGroup(router *gin.RouterGroup, method string, uri string, handler gin.HandlerFunc) error {
-	switch strings.ToUpper(method) {
-	case http.MethodGet:
-		router.GET(uri, handler)
-	case http.MethodPost:
-		router.POST(uri, handler)
-	case http.MethodDelete:
-		router.DELETE(uri, handler)
-	case http.MethodHead:
-		router.HEAD(uri, handler)
-	case http.MethodOptions:
-		router.OPTIONS(uri, handler)
-	case http.MethodPatch:
-		router.PATCH(uri, handler)
-	case http.MethodPut:
-		router.PUT(uri, handler)
-	case "ANY": // 一次性注册全部请求方法的路由
-		router.Any(uri, handler)
-	default:
-		// 不是一个函数,数名method配置错误
-		return fmt.Errorf("uri=%s method=%s 请求方法配置错误", uri, method)
-	}
-	return nil
-}
--- a/router/validator.go
+++ b/router/validator.go
@ -0,0 +1,55 @@
+// Package router ...
+//
+// Description : router ...
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 2025-02-07 17:36
+package router
+
+import (
+	"errors"
+	"fmt"
+	"github.com/go-playground/validator/v10"
+	"reflect"
+	"strings"
+)
+
+// GetValidateErr 格式化错误信息
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 22:19 2025/1/15
+func GetValidateErr(obj any, rawErr error) error {
+	if nil == rawErr {
+		return nil
+	}
+	if nil == obj {
+		return rawErr
+	}
+	var (
+		ok             bool
+		validationErrs validator.ValidationErrors
+		errString      []string
+		field          reflect.StructField
+	)
+	if ok = errors.As(rawErr, &validationErrs); !ok {
+		return rawErr
+	}
+	objType := reflect.TypeOf(obj)
+	if objType.Kind() == reflect.Ptr {
+		objType = objType.Elem()
+	}
+	for _, validationErr := range validationErrs {
+		if field, ok = objType.FieldByName(validationErr.Field()); ok {
+			if e := field.Tag.Get(defaultValidateErrTag); e != "" {
+				errString = append(errString, fmt.Sprintf("%s: %s", field.Tag.Get("json"), e))
+				continue
+			} else {
+				errString = append(errString, fmt.Sprintf("%s: %v", field.Tag.Get("json"), validationErr.Value()))
+			}
+		}
+		errString = append(errString, validationErr.Error())
+	}
+	return errors.New(strings.Join(errString, "\n"))
+}
Author	SHA1	Message	Date
白茶清欢	ab78127317	引入 GinWrapperContext, gateway待升级测试	2025-03-10 14:44:20 +08:00
白茶清欢	28da213bb8	优化 GinContext 定义	2025-03-10 14:07:51 +08:00
白茶清欢	13d1ab6607	merge master && fix both modify	2025-03-10 12:29:11 +08:00
白茶清欢	2fd9195b77	Merge pull request '修复logic after response实际是同步逻辑问题' (#9 ) from feature/fix_logic_after_response into master Reviewed-on: #9	2025-02-28 18:43:11 +08:00
白茶清欢	c826166256	修复logic after response实际是同步逻辑问题	2025-02-28 18:18:03 +08:00
白茶清欢	84f0e1a4f6	Merge pull request '引入对响应后处理逻辑的支持' (#8 ) from feature/logic_after_response into master Reviewed-on: #8	2025-02-28 17:05:12 +08:00
白茶清欢	9ae310782b	fix	2025-02-28 17:04:36 +08:00
白茶清欢	0d981b32c6	增加获取logic after response实例的方法	2025-02-28 16:57:02 +08:00
白茶清欢	9decd12ee8	优化代码组织	2025-02-28 16:53:02 +08:00
白茶清欢	b95d464c89	包装handler支持响应后触发相关逻辑	2025-02-28 16:48:22 +08:00
白茶清欢	bb5d97f6eb	规划二次包装的ginContext	2025-02-28 12:26:09 +08:00
白茶清欢	ac5776f3f6	增加ctx copy的包装方法	2025-02-28 11:44:56 +08:00
白茶清欢	3432087fbd	修复拼写错误	2025-02-25 17:22:14 +08:00
白茶清欢	2c201ae226	优化跨域处理	2025-02-22 17:05:38 +08:00
白茶清欢	12d2735663	Merge pull request '升级路由注册' (#7 ) from feature/upgrade_route_register into master Reviewed-on: #7	2025-02-22 16:15:37 +08:00
白茶清欢	01b62b6eee	支持在router实力上自行注册路由	2025-02-22 16:14:55 +08:00
白茶清欢	1de0715637	支持注册404Handler	2025-02-22 16:05:56 +08:00
白茶清欢	93cef0cf7f	支持请求日志记录中间件	2025-02-22 15:45:30 +08:00
白茶清欢	b9a7f97342	优化注册全局中间件逻辑	2025-02-22 15:00:37 +08:00
白茶清欢	75cc21c494	Merge pull request '支持注册pprof相关路由' (#6 ) from feature/support_pprof into master Reviewed-on: #6	2025-02-21 15:17:09 +08:00
白茶清欢	4909e75928	支持注册pprof相关路由	2025-02-21 15:16:43 +08:00
白茶清欢	bc94242d12	update apiDocPkg	2025-02-20 18:52:49 +08:00
白茶清欢	11d90566ae	update apiDocPkg	2025-02-20 18:01:26 +08:00
白茶清欢	113b1e5a05	升级apiDocPkg	2025-02-20 16:24:08 +08:00
白茶清欢	7530625baa	update go sum	2025-02-20 10:38:00 +08:00
白茶清欢	8cb98e4817	update apiDocPkg	2025-02-19 22:26:45 +08:00
白茶清欢	cfcb05f4da	update go mod	2025-02-19 21:49:49 +08:00
白茶清欢	f11540fa6e	update apiDocPkg	2025-02-19 18:17:15 +08:00
白茶清欢	c3e42b944c	update go mod	2025-02-19 15:37:59 +08:00
白茶清欢	bb54978dc5	update go mod	2025-02-18 23:04:44 +08:00
白茶清欢	de34f57a5f	update go mod	2025-02-18 22:31:06 +08:00
白茶清欢	793fefbcd2	update go mod	2025-02-18 21:29:01 +08:00
白茶清欢	26476ee23b	Merge pull request 'server初始化支持设置各种option' (#5 ) from feature/support_server_option into master Reviewed-on: #5	2025-02-18 18:14:04 +08:00
白茶清欢	1c2c5aa4ce	server初始化支持设置各种option	2025-02-18 18:12:44 +08:00
白茶清欢	74dde8b41e	update go mod	2025-02-18 17:27:03 +08:00
白茶清欢	1e53d899dc	update go mod	2025-02-18 14:57:16 +08:00
白茶清欢	a80c559a7c	修复文档路由重复注册的BUG	2025-02-18 14:39:29 +08:00
白茶清欢	02675d6c40	update go mod	2025-02-18 14:09:24 +08:00
白茶清欢	681bd3fe95	update api-doc	2025-02-17 18:12:52 +08:00
白茶清欢	7ef8bf2676	修复参数解析BUG	2025-02-17 17:13:57 +08:00
白茶清欢	293f829945	反射支持 controller 指针与普通实例; 函数调用支持指针参数与非指针参数	2025-02-17 16:31:21 +08:00
白茶清欢	74f0ae2069	update go mod	2025-02-16 21:12:28 +08:00
白茶清欢	d237b3b651	update go mod	2025-02-16 20:08:17 +08:00
白茶清欢	fca399fdc3	Merge pull request '升级server自动管理' (#4 ) from feature/upgrade_server into master Reviewed-on: #4	2025-02-16 17:45:07 +08:00
白茶清欢	593df47884	引入日志初始化中间件	2025-02-16 17:41:33 +08:00
白茶清欢	3774bda0ff	升级api-doc版本	2025-02-16 17:28:22 +08:00
白茶清欢	4ddf55d371	优化接口文档注册	2025-02-16 16:44:57 +08:00
白茶清欢	d832eef5a0	调试文档集成	2025-02-16 13:06:58 +08:00
白茶清欢	c3df76e94d	修复URL注册BUG	2025-02-15 22:34:21 +08:00
白茶清欢	99df73e50e	整合默认swagger文档	2025-02-15 21:53:21 +08:00
白茶清欢	ff91efd1c8	完成一版文档json生成	2025-02-15 21:19:35 +08:00
白茶清欢	e1f597ae50	引入文档解析	2025-02-14 22:30:56 +08:00
白茶清欢	2f7d1438b2	update go mod	2025-02-14 21:16:19 +08:00
白茶清欢	a50883b734	优化server初始化的方式	2025-02-07 18:33:07 +08:00
白茶清欢	5d19efa8cf	Merge pull request '格式化验证失败的错误信息, 默认tag=err, 支持重置默认tag' (#3 ) from feature/format_validate_err into master Reviewed-on: #3	2025-02-07 18:03:21 +08:00
白茶清欢	7c67160c65	格式化验证失败的错误信息, 默认tag=err, 支持重置默认tag	2025-02-07 18:01:05 +08:00
白茶清欢	a338713c77	Merge pull request '支持通过controller自动解析注册接口路由' (#2 ) from feature/router into master Reviewed-on: #2	2025-02-07 17:32:34 +08:00
白茶清欢	cb4718a269	接口逻辑函数返回值严格校验时, 校验不通过, 由忽略接口注册修改为panic	2025-02-07 17:25:25 +08:00
白茶清欢	1b1964881f	返回数据支持是否严格模式的校验, 严格模式下, 必须返回结构体或者map	2025-02-07 17:19:25 +08:00
白茶清欢	e95061a1a8	完成基础反射调用接口 + 数据响应	2025-02-07 16:57:15 +08:00
白茶清欢	77ea723e86	完善 RequestHandler 逻辑	2025-02-07 16:10:33 +08:00
白茶清欢	196c437cc5	update go mod	2025-02-07 10:33:39 +08:00
白茶清欢	b408076fa7	保存路由统一注册方法	2025-01-27 19:46:34 +08:00
白茶清欢	851de1b3ef	save code	2025-01-27 15:07:58 +08:00
白茶清欢	e40475cdb1	update go mod	2025-01-26 14:34:24 +08:00
白茶清欢	ec04a023cd	merge master && fix both modify	2025-01-26 14:32:59 +08:00
白茶清欢	c420abfed9	update go mod	2024-08-14 14:12:37 +08:00
白茶清欢	fce6043dca	update go mod	2024-08-11 17:39:03 +08:00
白茶清欢	df16e63e85	fix both modify	2024-07-26 14:47:00 +08:00
白茶清欢	60ef099fdf	update readme	2024-07-22 14:33:21 +08:00
白茶清欢	8997577181	add readme	2024-07-22 14:31:55 +08:00
白茶清欢	cc98043aff	update Test	2024-07-22 11:19:41 +08:00
白茶清欢	0b7df330f7	切换弃用的函数	2024-07-22 10:30:18 +08:00
白茶清欢	8a6182d0de	统一支持设置请求开始时间	2024-07-21 22:03:59 +08:00
白茶清欢	deead87688	优化路由注册	2024-07-21 19:16:50 +08:00
白茶清欢	f8f63691b7	完成基础路由注册, 遗留 : form表单, any数据类型解析失败	2024-07-21 18:49:44 +08:00
白茶清欢	455f74ad89	接口meta信息解析	2024-07-21 16:51:02 +08:00
白茶清欢	f55dee577d	完成路由中间件解析	2024-07-21 12:19:23 +08:00
白茶清欢	b14b1ef345	支持解析路由前缀	2024-07-20 23:39:25 +08:00