优化升级gin框架的二次包装 #19

Merged
zhangdeman merged 12 commits from feature/upgrade_gin into master 2025-12-29 10:40:06 +08:00
7 changed files with 65 additions and 51 deletions
Showing only changes of commit e415bad869 - Show all commits

View File

@@ -10,15 +10,7 @@ package define
import "github.com/gin-gonic/gin" import "github.com/gin-gonic/gin"
// IsBlackIP 是否是黑名单IP // IsBlackIP 是否是黑名单IP
//
// Author : go_developer@163.com<白茶清欢>
//
// Date : 23:25 2022/6/25
type IsBlackIP func(ctx *gin.Context, clientIP string) bool type IsBlackIP func(ctx *gin.Context, clientIP string) bool
// IsWhiteIP 是否白名单IP // IsWhiteIP 是否白名单IP
//
// Author : go_developer@163.com<白茶清欢>
//
// Date : 23:27 2022/6/25
type IsWhiteIP func(ctx *gin.Context, clientIP string) bool type IsWhiteIP func(ctx *gin.Context, clientIP string) bool

View File

@@ -20,10 +20,6 @@ var (
) )
// HttpHandleConfig 请求处理配置 // HttpHandleConfig 请求处理配置
//
// Author : go_developer@163.com<白茶清欢>
//
// Date : 20:41 2022/6/25
type HttpHandleConfig struct { type HttpHandleConfig struct {
RecordRequestDataField string RecordRequestDataField string
RecordResponseDataField string RecordResponseDataField string
@@ -43,19 +39,11 @@ type HttpHandleConfig struct {
} }
// ConvertDefaultConfig 覆盖默认配置 // ConvertDefaultConfig 覆盖默认配置
//
// Author : go_developer@163.com<白茶清欢>
//
// Date : 20:41 2022/6/25
func ConvertDefaultConfig(cfg *HttpHandleConfig) { func ConvertDefaultConfig(cfg *HttpHandleConfig) {
inputHttpHandleConfig = cfg inputHttpHandleConfig = cfg
} }
// GetHttpHandleConfig 获取http配置 // GetHttpHandleConfig 获取http配置
//
// Author : go_developer@163.com<白茶清欢>
//
// Date : 16:55 2024/7/23
func GetHttpHandleConfig() *HttpHandleConfig { func GetHttpHandleConfig() *HttpHandleConfig {
return &HttpHandleConfig{ return &HttpHandleConfig{
EnableExtensionOutput: inputHttpHandleConfig.EnableExtensionOutput, EnableExtensionOutput: inputHttpHandleConfig.EnableExtensionOutput,

View File

@@ -49,4 +49,5 @@ const (
const ( const (
CodeInjectCommonParam = "inject-common-param" CodeInjectCommonParam = "inject-common-param"
CodeLogicHook = "logic-hook" CodeLogicHook = "logic-hook"
CodeParamValidateFailure = "param-validate-failure"
) )

View File

@@ -49,14 +49,17 @@ func (s *server) injectCommonParam(ctx *gin.Context, formValue any) error {
} else { } else {
reflectType = reflectFormValue.Type() reflectType = reflectFormValue.Type()
} }
if reflectType.Kind() == reflect.Ptr {
reflectType = reflectType.Elem()
}
fieldTable := map[string]bool{} fieldTable := map[string]bool{}
fieldNum := reflectType.Elem().NumField() fieldNum := reflectType.NumField()
for i := 0; i < fieldNum; i++ { for i := 0; i < fieldNum; i++ {
if reflectType.Elem().Field(i).Anonymous && // 是匿名字段, 再做一次解析 if reflectType.Field(i).Anonymous && // 是匿名字段, 再做一次解析
((reflectType.Elem().Field(i).Type.Kind() == reflect.Ptr && reflectType.Elem().Field(i).Type.Kind() == reflect.Struct) || // 结构体指针 ((reflectType.Field(i).Type.Kind() == reflect.Ptr && reflectType.Field(i).Type.Kind() == reflect.Struct) || // 结构体指针
reflectType.Elem().Field(i).Type.Kind() == reflect.Struct) { // 结构体 reflectType.Field(i).Type.Kind() == reflect.Struct) { // 结构体
anonymousFieldType := reflectType.Elem().Field(i).Type anonymousFieldType := reflectType.Field(i).Type
if anonymousFieldType.Kind() == reflect.Ptr { if anonymousFieldType.Kind() == reflect.Ptr {
anonymousFieldType = anonymousFieldType.Elem() anonymousFieldType = anonymousFieldType.Elem()
} }
@@ -65,7 +68,7 @@ func (s *server) injectCommonParam(ctx *gin.Context, formValue any) error {
} }
} else { } else {
// 提取全部结构体字段 // 提取全部结构体字段
fieldTable[reflectType.Elem().Field(i).Name] = true fieldTable[reflectType.Field(i).Name] = true
} }
} }
for fieldName, getParamFunc := range s.commonParam { for fieldName, getParamFunc := range s.commonParam {

View File

@@ -11,6 +11,7 @@ import (
"reflect" "reflect"
"strings" "strings"
"git.zhangdeman.cn/zhangdeman/gin/logger"
"git.zhangdeman.cn/zhangdeman/util" "git.zhangdeman.cn/zhangdeman/util"
) )
@@ -49,37 +50,59 @@ func (c controller) Parse(inputController any) map[string]UriConfig {
return parseRes return parseRes
} }
// methodConfig 解析方法配置, 要求函数格式, 两个参数, 两个返回值, 格式 : func(ctx *gin.Context, formData anyStruct[组合Meta]) (anyStruct|map[response], error) // preCheckMethod 预检查方法是否可以注册为接口
// func (c controller) preCheckMethod(reflectMethod reflect.Method) (bool, reflect.Type, reflect.StructField) {
// 参数 : 方法反射结果 var (
// metaField reflect.StructField
// 返回值 : 第一个 -> 解析出的接口配置 第二个 -> 是否要注册为接口 metaFieldExist bool
func (c controller) methodConfig(reflectMethod reflect.Method) (cfg UriConfig, needRegister bool) { )
methodType := reflectMethod.Type methodType := reflectMethod.Type
// num0: 函数声明 // num0: 函数声明
// num1: 第一个参数 // num1: 第一个参数
// num2: 第二个参数 // num2: 第二个参数
if methodType.NumIn() != 3 { if methodType.NumIn() != 3 {
needRegister = false return false, nil, metaField
return
} }
// 第一个参数必须是 *gin.Context 或者 *define.Context // 第一个参数必须是 *gin.Context 或者 *define.Context
paramOne := methodType.In(1).String() paramOne := methodType.In(1).String()
if paramOne != GinContextType { if paramOne != GinContextType {
needRegister = false return false, nil, metaField
return
} }
// 解析第二个参数是组合 Meta 的form表单 // 解析第二个参数是组合 Meta 的form表单
formType := methodType.In(2) formType := methodType.In(2)
cfg.FormDataType = formType
if formType.Kind() == reflect.Ptr { if formType.Kind() == reflect.Ptr {
formType = methodType.In(2).Elem() formType = formType.Elem()
} }
metaField, metaFieldExist := formType.FieldByName(FieldNameMeta)
if !metaFieldExist { if metaField, metaFieldExist = formType.FieldByName(FieldNameMeta); !metaFieldExist {
needRegister = false return false, nil, metaField
return
} }
return true, formType, metaField
}
// methodConfig 解析方法配置, 要求函数格式, 两个参数, 两个返回值, 格式 : func(ctx *gin.Context, formData anyStruct[组合Meta]) (anyStruct|map[response], error)
//
// 参数 : 方法反射结果
//
// 返回值 : 第一个 -> 解析出的接口配置 第二个 -> 是否要注册为接口
func (c controller) methodConfig(reflectMethod reflect.Method) (UriConfig, bool) {
var (
needRegister bool
metaField reflect.StructField
cfg UriConfig
)
methodType := reflectMethod.Type
// num0: 函数声明
// num1: 第一个参数
// num2: 第二个参数
if needRegister, cfg.FormDataType, metaField = c.preCheckMethod(reflectMethod); !needRegister {
logger.Instance.Info("接口方法不符合要求, 不注册为接口, 方法名: " + reflectMethod.Name + ", 方法签名: " + methodType.String())
return UriConfig{}, false
}
cfg.ResultDataType = methodType.Out(0) cfg.ResultDataType = methodType.Out(0)
if methodType.Out(1).Kind().String() != ErrorType { if methodType.Out(1).Kind().String() != ErrorType {
// 判断是否是实现 error接口的方法 // 判断是否是实现 error接口的方法
@@ -95,7 +118,7 @@ func (c controller) methodConfig(reflectMethod reflect.Method) (cfg UriConfig, n
} }
if !outputErrParse { if !outputErrParse {
needRegister = false needRegister = false
return return cfg, needRegister
} }
} }
c.setUriMeta(metaField, &cfg) c.setUriMeta(metaField, &cfg)
@@ -111,7 +134,7 @@ func (c controller) methodConfig(reflectMethod reflect.Method) (cfg UriConfig, n
//cfg.ParamList = c.parseParamConfig(formType) //cfg.ParamList = c.parseParamConfig(formType)
cfg.ApiLogicFunc = reflectMethod cfg.ApiLogicFunc = reflectMethod
needRegister = true needRegister = true
return return cfg, needRegister
} }
// setUriMeta 设置接口的 meta 信息 // setUriMeta 设置接口的 meta 信息

View File

@@ -9,14 +9,18 @@ package router
import ( import (
"errors" "errors"
"net/http"
"reflect" "reflect"
"sync" "sync"
"git.zhangdeman.cn/zhangdeman/consts" "git.zhangdeman.cn/zhangdeman/consts"
"git.zhangdeman.cn/zhangdeman/exception" "git.zhangdeman.cn/zhangdeman/exception"
"git.zhangdeman.cn/zhangdeman/gin/define" "git.zhangdeman.cn/zhangdeman/gin/define"
"git.zhangdeman.cn/zhangdeman/gin/logger"
"git.zhangdeman.cn/zhangdeman/gin/request" "git.zhangdeman.cn/zhangdeman/gin/request"
"git.zhangdeman.cn/zhangdeman/gin/response" "git.zhangdeman.cn/zhangdeman/gin/response"
"git.zhangdeman.cn/zhangdeman/gin/util"
loggerPkg "git.zhangdeman.cn/zhangdeman/logger"
"github.com/gin-gonic/gin" "github.com/gin-gonic/gin"
"github.com/mcuadros/go-defaults" "github.com/mcuadros/go-defaults"
) )
@@ -38,6 +42,9 @@ func (s *server) getFormInitValue(ctx *gin.Context, uriCfg UriConfig) (any, erro
if err = request.Form.Parse(ctx, formValue); nil != err { if err = request.Form.Parse(ctx, formValue); nil != err {
// 格式化验证错误的信息 // 格式化验证错误的信息
err = GetValidateErr(formValue, err) err = GetValidateErr(formValue, err)
logger.Instance.Error("参数解析出现异常", loggerPkg.NewLogData(util.GinCtxToContext(ctx), logger.RecordType, logger.CodeParamValidateFailure, map[string]any{
"err_msg": err.Error(),
}).ToFieldList()...)
return nil, err return nil, err
} }
return formValue, nil return formValue, nil
@@ -55,7 +62,7 @@ func (s *server) RequestHandler(uriCfg UriConfig) gin.HandlerFunc {
) )
if formValue, err = s.getFormInitValue(ctx, uriCfg); nil != err { if formValue, err = s.getFormInitValue(ctx, uriCfg); nil != err {
e = exception.NewFromError(400, err) e = exception.NewFromError(http.StatusBadRequest, err)
response.SendWithException(ctx, e, &define.ResponseOption{ response.SendWithException(ctx, e, &define.ResponseOption{
ContentType: consts.MimeTypeJson, ContentType: consts.MimeTypeJson,
}) })