Golang GinWeb框架4-请求参数绑定和验证

???

???????????(Golang GinWeb???3-???????????????????/?????????)???????GinWeb???

?????????

????????????????嵽???Go??????. ?????JSON,XML,YAML?????????(??foo=bar&boo=baz)???.

Gin???go-playground/validator/v10???????????, ????tags?????????????(https://godoc.org/github.com/go-playground/validator#hdr-Baked_In_Validators_and_Tags)

???:??????????????????????α????????????,?????JSON,??????: json:"fieldname"

Gin????????(????)??????:

• Must bind

1. ????: Bind, BindJSON, BindXML, BindQuery, BindYAML, BindHeader

2. ???: ??Щ??????????MustBindWith????. ????????????, ??????????400??????????:c.AbortWithError(400, err).SetType(ErrorTypeBind), ?????????Content-Type??text/plain; charset=utf-8.???????????????,???????????????,???????: [GIN-debug] [WARNING] Headers were already written. Wanted to override status code 400 with 422, ????????????????Щ???,???????????????ShoudBind????.

• Should bind

1. ????: ShouldBind, ShouldBindJSON, ShouldBindXML, ShouldBindQuery, ShouldBindYAML, ShouldBindHeader

2. ???: ??Щ??????????ShouldBindWith. ????????????, ???????, ???????????????????????Щ????.

????e??????, Gin????????????Content-Type header??????????????. ??????????????????????,?????????????MustBindWith??ShouldBindWith????.

?????????????????????required????, ??????????????:binding:"required"???, ??????????????????????.

?????′????JSON:

package main
?
import (
  "github.com/gin-gonic/gin"
  "net/http"
)
?
// Binding from JSON
type Login struct {
  User string `form:"user" json:"user" xml:"user"  binding:"required"` //?????form,json,xml,binding????
  //Password string `form:"password" json:"password" xml:"password" binding:"required"`
  Password string `form:"password" json:"password" xml:"password" binding:"-"`
}
?
?func main() {
  router := gin.Default()
?
  // Example for binding JSON ({"user": "manu", "password": "123"})
  router.POST("/loginJSON", func(c *gin.Context) {
    var json Login
    if err := c.ShouldBindJSON(&json); err != nil {
      c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
      return
    }
?
    if json.User != "manu" || json.Password != "123" {
      c.JSON(http.StatusUnauthorized, gin.H{"status": "unauthorized"})
      return
    }
?
    c.JSON(http.StatusOK, gin.H{"status": "you are logged in"})
  })
?
  // Example for binding XML (
  //  <?xml version="1.0" encoding="UTF-8"?>
  //  <root>
  //    <user>user</user>
  //    <password>123</password>
  //  </root>)
  router.POST("/loginXML", func(c *gin.Context) {
    var xml Login
    if err := c.ShouldBindXML(&xml); err != nil {
      c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
      return
    }
?
    if xml.User != "manu" || xml.Password != "123" {
      c.JSON(http.StatusUnauthorized, gin.H{"status": "unauthorized"})
      return
    }
?
    c.JSON(http.StatusOK, gin.H{"status": "you are logged in"})
  })
?
  // Example for binding a HTML form (user=manu&password=123)
  router.POST("/loginForm", func(c *gin.Context) {
    var form Login
    // This will infer what binder to use depending on the content-type header.
    if err := c.ShouldBind(&form); err != nil {
      c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
      return
    }
?
    if form.User != "manu" || form.Password != "123" {
      c.JSON(http.StatusUnauthorized, gin.H{"status": "unauthorized"})
      return
    }
?
    c.JSON(http.StatusOK, gin.H{"status": "you are logged in"})
  })
?
  // Listen and serve on 0.0.0.0:8080
  router.Run(":8080")
}
?
//???????: curl -v -X POST http://localhost:8080/loginJSON -H 'content-type: application/json' -d '{ "user": "manu", "password": "123" }'

???????: ??binding:"required"??????????binding:"-", ???????β?????, ???????????????????.

??????????

??????????????????????????, ?????????ο?(https://github.com/gin-gonic/examples/blob/master/custom-validation/server.go)

package main
?
import (
  "net/http"
  "time"
?
  "github.com/gin-gonic/gin"
  "github.com/gin-gonic/gin/binding"
  "github.com/go-playground/validator/v10"
)
?
// Booking contains binded and validated data.
// Booking???ж??????????????????????????
type Booking struct {
  CheckIn  time.Time `form:"check_in" binding:"required,bookabledate" time_format:"2006-01-02"`  //??????
  CheckOut time.Time `form:"check_out" binding:"required,gtfield=CheckIn" time_format:"2006-01-02"`  //gtfield=CheckIn?????????????????????
}
?
// ?????????????
var bookableDate validator.Func = func(fl validator.FieldLevel) bool {
  date, ok := fl.Field().Interface().(time.Time)  //???÷??????????? -> ????? -> ???????(???????)
  if ok {
    today := time.Now()
    if today.After(date) {  //???????????checkIn?????????,????false,?????????????????????
      return false
    }
  }
  return true
}
?
func main() {
  route := gin.Default()
  //??binding.Validator.Engine()?????????????,?????????Validate??,?????????,?????????????????Gin???
  if v, ok := binding.Validator.Engine().(*validator.Validate); ok {
    // - if the key already exists, the previous validation function will be replaced. ???????????????????????滻
    // - this method is not thread-safe it is intended that these all be registered prior to any validation
    // ????????????????, ?????????,?????????е?????????????
    v.RegisterValidation("bookabledate", bookableDate)
  }
?
  route.GET("/bookable", getBookable)
  route.Run(":8085")
}
?
func getBookable(c *gin.Context) {
  var b Booking
  if err := c.ShouldBindWith(&b, binding.Query); err == nil {
    c.JSON(http.StatusOK, gin.H{"message": "Booking dates are valid!"})
  } else {
    c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
  }
}
?
//???????:
// ????????????????????
//$ curl "localhost:8085/bookable?check_in=2030-04-16&check_out=2030-04-17"
//{"message":"Booking dates are valid!"}
//
// ?????????????????, ??????gtfieldУ?????
//$ curl "localhost:8085/bookable?check_in=2030-03-10&check_out=2030-03-09"
//{"error":"Key: 'Booking.CheckOut' Error:Field validation for 'CheckOut' failed on the 'gtfield' tag"}
//
// ???????????????,?????????????????
//$ curl "localhost:8085/bookable?check_in=2000-03-09&check_out=2000-03-10"
//{"error":"Key: 'Booking.CheckIn' Error:Field validation for 'CheckIn' failed on the 'bookabledate' tag"}%

??????弶?????????????μ??????, v.RegisterStructValidation(UserStructLevelValidation, User{}), ??ο?struct-lvl-validation example(https://github.com/gin-gonic/examples/tree/master/struct-lvl-validations)

?ο????

Gin??????:https://github.com/gin-gonic/gin

END?????

??????????, ????, ?????!

??????

Golang GinWeb???3-???????????????????/?????????

Golang GinWeb???2-??????/????panic??????????崦????

Golang GinWeb???-????????/????????

Golang???????????洢????AmazonS3????????

Golang+Vue???Websocket???????????

GolangWeb??????????????HandlerFunc???м??Middleware

Golang????MySQL??в????????-??????

Golang?????????????????

Golang ???????????????(Data Race Detector)???????

Golang"????"MongoDB-????????("??????")