GIN-BOOT
介绍
这是一个go的web项目框架（脚手架），可以让你3分钟内建立自己可用的Go Web项目。
功能描述
http请求入参可以自动填充到结构体，如果是POST，则将http body数据填充到结构体； 如果是GET，则将URL query参数自动填充到结构体；
返回数据，可以是任意数据类型。如果数据不是boot.ApiResp，则返回数据会被包装为boot.ApiResp的json数据；
统一全局异常，请求返回会被包装为系统异常
返回json格式
{
? ? "code":"100200",
? ? "msg":"成功",?
? ? "data":null?
}
使用demo
package main
import (
? ? "errors"
? ? "github.com/gin-gonic/gin"
? ? "github.com/xiaojun207/gin-boot/boot"
? ? "log"
? ? "net/http"
)
type Foo struct {
? ? Username string `json:"username" form:"username" binding:"required"`
? ? Password string `json:"password" form:"password"`
}
type Page struct {
? ? boot.BindQuery? ? // 继承boot.BindQuery的结构体，指定绑定到url参数
? ? PageNum? ? ? ? int `json:"page_num" form:"page_num"`? // url 中的参数，需要用tag 'form' 标识，才能自动绑定
? ? PageSize? ? ? int `json:"page_size" form:"page_size"` // url 中的参数，需要用tag 'form' 标识，才能自动绑定
}
type QueryHeader struct {
? ? boot.BindHeader
? ? Authorization string `header:"authorization"`
}
// /testPost
// 入参可以自动填充到结构体,如果是POST，则将http body数据填充到结构体；
// 返回数据，可以是任意数据类型。如果数据不是boot.ApiResp，则返回数据会被包装为boot.ApiResp的json数据；<br>
// 如果handler执行异常，请求返回会被包装为系统异常
// 参数page继承boot.BindQuery的结构体，绑定url参数
func TestPost1Handler(c *gin.Context, req *Foo, page Page, header QueryHeader) boot.ApiResp {
? ? log.Println("TestPost1Handler.req:", req.Username, ",Password:", req.Password)
? ? log.Println("TestPost1Handler.page.PageNum:", page.PageNum, ",PageSize:", page.PageSize)
? ? log.Println("TestPost1Handler.Authorization:", header.Authorization)
? ? return boot.ApiResp{Code: "100200", Msg: "Success", Data: "TestData: " + req.Username}
}
// /testGetEmpty
// 空返回值包装测试，返回：{"code":"100200","data":null,"msg":"成功"}
func TestGetEmptyHandler(c *gin.Context, req *Foo) {
? ? log.Println("TestGetEmptyHandler.req.username:", req.Username, ",password:", req.Password)
}
// 空返回值包装测试，返回：{"code":"100200","data":null,"msg":"成功"}
func TestGetHandler(c *gin.Context, page Page, header QueryHeader) {
? ? log.Println("TestGetHandler.page.PageNum:", page.PageNum, ",PageSize:", page.PageSize)
? ? log.Println("TestGetHandler.Authorization:", header.Authorization)
? ? log.Println("TestGetHandler")
}
// 异常全局处理测试，返回：{"code":"100101","data":null,"msg":"TestPost2Handler.TestError"}
func TestPost2Handler(c *gin.Context, req *Foo) {
? ? log.Println("TestPost2Handler.req.username:", req.Username, ",password:", req.Password)
? ? panic(errors.New("TestPost2Handler.TestError"))
}
// /testGet?username=admin12&password=1234&page_num=1&page_size=10
// url 中的参数，需要用tag 'form' 标识
// 也可以使用gin方法, GET类型的请求，query参数也可以自动装填到结构体
func TestGet1Handler(c *gin.Context, req *Foo, page Page) interface{} {
? ? log.Println("TestGet1Handler.req.username:", req.Username, ",password:", req.Password)
? ? log.Println("TestGet1Handler.page.PageNum:", page.PageNum, ",PageSize:", page.PageSize)
? ? data := map[string]interface{}{
? ? ? ? "list": []*Foo{req},
? ? ? ? "page": page,
? ? }
? ? log.Println("TestGet1Handler.data:", data)
? ? return data
}
func AuthInterceptor(c *gin.Context, header http.Header) {
? ? authorization := c.GetHeader("authorization")
? ? log.Println("AuthInterceptor.authorization:", authorization)
? ? if authorization == "" {
? ? ? ? log.Println("AuthInterceptor authorization is null")
? ? ? ? boot.Resp(c, "105101", "账户未登录", "")
? ? ? ? c.Abort()
? ? ? ? return
? ? }
? ? //TODO getUid By authorization
? ? id := 100
? ? c.Set("uid", id)
}
var webRouter = func(router *boot.WebRouter) {
? ? //router.Use(AuthInterceptor)
? ? // 静态资源
? ? router.StaticFile("/", "./views/index.html")
? ? router.StaticFS("/static/", http.Dir("./views/static/"))
? ? // 动态API
? ? router.POST("/testPost", AuthInterceptor, TestPost1Handler)
? ? router.POST("/testPost2", TestPost2Handler)
? ? router.GET("/testGetEmpty", TestGetEmptyHandler)
? ? router.GET("/testGet", TestGetHandler)
? ? router.GET("/testGet1", AuthInterceptor, TestGet1Handler)
? ? apiRouter := router.Group("/api/")
? ? apiRouter.GET("/test", TestPost2Handler)
}
func main() {
? ? boot.Start("8088", "/", webRouter)
}