将 request body 绑定到不同的结构体中

一般通过调用 c.Request.Body 方法绑定数据，但不能多次调用这个方法。

  1. type formA struct {
  2.   Foo string `json:"foo" xml:"foo" binding:"required"`
  3. }
  5. type formB struct {
  6.   Bar string `json:"bar" xml:"bar" binding:"required"`
  7. }
  9. func SomeHandler(c *gin.Context) {
  10.   objA := formA{}
  11.   objB := formB{}
  12.   // c.ShouldBind 使用了 c.Request.Body，不可重用。
  13.   if errA := c.ShouldBind(&objA); errA == nil {
  14.     c.String(http.StatusOK, `the body should be formA`)
  15.   // 因为现在 c.Request.Body 是 EOF，所以这里会报错。
  16.   } else if errB := c.ShouldBind(&objB); errB == nil {
  17.     c.String(http.StatusOK, `the body should be formB`)
  18.   } else {
  19.     ...
  20.   }
  21. }

要想多次绑定，可以使用 c.ShouldBindBodyWith.

  1. func SomeHandler(c *gin.Context) {
  2.   objA := formA{}
  3.   objB := formB{}
  4.   // 读取 c.Request.Body 并将结果存入上下文。
  5.   if errA := c.ShouldBindBodyWith(&objA, binding.JSON); errA == nil {
  6.     c.String(http.StatusOK, `the body should be formA`)
  7.   // 这时, 复用存储在上下文中的 body。
  8.   } else if errB := c.ShouldBindBodyWith(&objB, binding.JSON); errB == nil {
  9.     c.String(http.StatusOK, `the body should be formB JSON`)
  10.   // 可以接受其他格式
  11.   } else if errB2 := c.ShouldBindBodyWith(&objB, binding.XML); errB2 == nil {
  12.     c.String(http.StatusOK, `the body should be formB XML`)
  13.   } else {
  14.     ...
  15.   }
  16. }
  • c.ShouldBindBodyWith 会在绑定之前将 body 存储到上下文中。 这会对性能造成轻微影响，如果调用一次就能完成绑定的话，那就不要用这个方法。
  • 只有某些格式需要此功能，如 JSON, XML, MsgPack, ProtoBuf。 对于其他格式, 如 Query, Form, FormPost, FormMultipart 可以多次调用 c.ShouldBind() 而不会造成任任何性能损失 (详见 #1341)。

Last modified 07.03.2020 : add blog dir (#115) (f46734b)