gin 自动参数绑定，类 beego 注解路由

## [ginprc](https://github.com/xxjwxc/ginrpc) ## golang gin 参数自动绑定工具 - 支持rpc自动映射 - 支持对象注册 - 支持注解路由 - 基于 [go-gin](https://github.com/gin-gonic/gin) 的 json restful 风格的golang基础库 - 自带请求参数过滤及绑定实现 binding:"required" [validator](go-playground/validator.v8) - 代码注册简单且支持多种注册方式 ## api接口说明 ### 支持3种接口模式 - func(*gin.Context) //go-gin 原始接口 func(*api.Context) //自定义的context类型 - func(*api.Context,req) //自定义的context类型,带request 请求参数 func(*api.Context,*req) - func(*gin.Context,*req) //go-gin context类型,带request 请求参数 func(*gin.Context,req) ### 示例代码 ## 初始化项目(本项目以ginweb 为名字) ``` go mod init ginweb ``` ### 代码 ( [详细地址](https://github.com/xxjwxc/ginrpc/tree/master/sample/ginweb)) ```go package main import ( "fmt" "net/http" _ "ginweb/routers" // debug模式需要添加[mod]/routers 注册注解路由 "github.com/gin-gonic/gin" "github.com/xxjwxc/ginrpc" "github.com/xxjwxc/ginrpc/api" ) type ReqTest struct { Access_token string `json:"access_token"` UserName string `json:"user_name" binding:"required"` // 带校验方式 Password string `json:"password"` } // Hello ... type Hello struct { Index int } // Hello 带注解路由(参考beego形式) // @router /block [post,get] func (s *Hello) Hello(c *api.Context, req *ReqTest) { fmt.Println(req) fmt.Println(s.Index) c.JSON(http.StatusOK, "ok") } // Hello2 不带注解路由(参数为2默认post) func (s *Hello) Hello2(c *gin.Context, req ReqTest) { fmt.Println(req) fmt.Println(s.Index) c.JSON(http.StatusOK, "ok") } //TestFun1 gin 默认的函数回调地址 func TestFun1(c *gin.Context) { fmt.Println(c.Params) c.String(200, "ok") } //TestFun2 自定义context的函数回调地址 func TestFun2(c *api.Context) { fmt.Println(c.Params) c.JSON(http.StatusOK, "ok") } //TestFun3 带自定义context跟已解析的req参数回调方式 func TestFun3(c *api.Context, req *ReqTest) { fmt.Println(c.Params) fmt.Println(req) c.JSON(http.StatusOK, "ok") } //TestFun4 带自定义context跟已解析的req参数回调方式 func TestFun4(c *gin.Context, req ReqTest) { fmt.Println(c.Params) fmt.Println(req) c.JSON(http.StatusOK, req) } func main() { base := ginrpc.New(ginrpc.WithCtx(func(c *gin.Context) interface{} { return api.NewCtx(c) }), ginrpc.WithDebug(true), ginrpc.WithGroup("xxjwxc")) router := gin.Default() base.Register(router, new(Hello)) // 对象注册 router.POST("/test1", base.HandlerFunc(TestFun1)) // 函数注册 router.POST("/test2", base.HandlerFunc(TestFun2)) router.POST("/test3", base.HandlerFunc(TestFun3)) router.POST("/test4", base.HandlerFunc(TestFun4)) base.RegisterHandlerFunc(router, []string{"post", "get"}, "/test", TestFun1) // 多种请求方式注册 router.Run(":8080") } ``` - curl ``` curl 'http://127.0.0.1:8080/test4' -H 'Content-Type: application/json' -d '{"access_token":"111", "user_name":"222", "password":"333"}' ``` ### 注解路由 - 1.注解路由会自动创建[mod]/routers/gen_router.go 文件 需要在调用时加： ``` _ "[mod]/routers" // debug模式需要添加[mod]/routers 注册注解路由 ``` 默认也会在项目根目录生成[gen_router.data]文件(保留次文件，可以不用添加上面代码嵌入) - 2.注解路由调用方式： ``` base := ginrpc.New(ginrpc.WithCtx(func(c *gin.Context) interface{} { return api.NewCtx(c) }), ginrpc.WithDebug(true), ginrpc.WithGroup("xxjwxc")) base.Register(router, new(Hello)) // 对象注册 router.Run(":8080") ``` 详细请看demo [ginweb](/sample/ginweb) - 3.执行curl，可以自动参数绑定。直接看结果 ``` curl 'http://127.0.0.1:8080/xxjwxc/block' -H 'Content-Type: application/json' -d '{"access_token":"111", "user_name":"222", "password":"333"}' ``` ``` curl 'http://127.0.0.1:8080/xxjwxc/hello.hello2' -H 'Content-Type: application/json' -d '{"access_token":"111", "user_name":"222", "password":"333"}' ``` - 4 参数说明 ginrpc.WithCtx ： 设置自定义context ginrpc.WithDebug(true) : 设置debug模式 ginrpc.WithGroup("xxjwxc") : 添加路由前缀 (也可以使用gin.Group 分组) ginrpc.WithBigCamel(true) : 设置大驼峰标准(false 为web模式，_,小写) [更多](https://godoc.org/github.com/xxjwxc/ginrpc) ### 下一步 1.导出api文档 2.导出postman测试配置 ### 代码地址： [ginprc](https://github.com/xxjwxc/ginrpc) 如果喜欢请给星支持 [传送门](https://github.com/xxjwxc/ginrpc) 如果你喜欢,请'star'