gin框架使用注意事项

gin框架使用注意事项

本文就说下这段时间我在使用gin框架过程中遇到的问题和要注意的事情。

错误处理请求返回要使用c.Abort,不要只是return

当在controller中进行错误处理的时候,发现一个错误,往往要立即返回,这个时候要记得使用gin.Context.Abort 或者其相关的函数。

类似于:

if err != nil {
        c.AbortWithStatus(500)
        return
    }

这个Abort函数本质是提前结束后续的handler链条,(通过将handler的下标索引直接变化为 math.MaxInt8 / 2 )但是前面已经执行过的handler链条(包括middleware等)还会继续返回。

gin的Abort系列的几个函数为:

func (c *Context) Abort()
func (c *Context) AbortWithStatus(code int)
func (c *Context) AbortWithStatusJSON(code int, jsonObj interface{})
func (c *Context) AbortWithError(code int, err error)

gin的错误处理

gin本身默认加载了Recovery()的中间件,所以在不知道如何处理error的时候,可以直接panic出去

如何获取response的body

需求来源于我要做个gin的中间件,请求进来的时候记录一下请求参数,请求出去的时候记录一下请求返回值。在记录请求返回值的时候,我就需要得到请求的返回内容。但是context里面只有一个结构:

Writer    gin.ResponseWriter

所以这里基本思路就是创建一个Writer,它继承gin.ResponseWriter。同时,它又有一个byte.buffer来copy一份数据。

// bodyLogWriter是为了记录返回数据到log中进行了双写
type bodyLogWriter struct {
    gin.ResponseWriter
    body *bytes.Buffer
}

func (w bodyLogWriter) Write(b []byte) (int, error) {
    w.body.Write(b)
    return w.ResponseWriter.Write(b)
}

所以,在middleware中就应该这么写

sTime := time.Now()

blw := &bodyLogWriter{body: bytes.NewBufferString(""), ResponseWriter: c.Writer}
c.Writer = blw

c.Next()

// 请求结束的时候记录
duration := fmt.Sprintf("%fms", float64(time.Now().Sub(sTime).Nanoseconds()) / 1000000.0)
handler.Tracef(c.Request.Context(), logger.DLTagRequestOut,
    "proc_time=%s||response=%s",
    duration,
    blw.body.String())

主要就是在Next之前吧context.Writer用我们定义的Writer给替换掉,让它输出数据的时候写两份。

如何获取所有的请求参数

这个其实和gin框架没有啥关系,我刚开始使用的时候以为使用request.ParseForm,然后在request.Form中就能得到了。

结果发现当我的Content-type为multipart/form-data的时候,竟然解析不到数据。

追到ParseForm里面发现,http/request.go里面有这么一个部分代码

case ct == "multipart/form-data":
    // handled by ParseMultipartForm (which is calling us, or should be)
    // TODO(bradfitz): there are too many possible
    // orders to call too many functions here.
    // Clean this up and write more tests.
    // request_test.go contains the start of this,
    // in TestParseMultipartFormOrder and others.
}

我的golang版本是1.11.4。当content-type为multipart/form-data的时候是空的调用的。

当然注释也写很清楚了,建议使用ParseMultipartForm

所以获取http参数的函数我就写成这个样子:

// 这个函数只返回json化之后的数据,且不处理错误,错误就返回空字符串
func getArgs(c *gin.Context) []byte {
    if c.ContentType() == "multipart/form-data" {
        c.Request.ParseMultipartForm(defaultMemory)
    } else {
        c.Request.ParseForm()
    }
    args, _ := json.Marshal(c.Request.Form)
    return args
}
点赞