Gin框架中的参数绑定和验证，你知道怎么绑定吗?

在Gin框架中，实现参数绑定和验证是一个常见且重要的任务。它可以帮助我们确保接收到的请求数据符合预期的格式和内容，避免出现潜在的错误。

使用时，需要在要绑定的所有字段上，设置相应的tag。 例如，使用 JSON 绑定时，设置字段标签为 json:"fieldname"。

Gin提供了两类绑定方法：

• Type - Must bindMethods - Bind, BindJSON, BindXML, BindQuery, BindYAMLBehavior - 这些方法属于 MustBindWith 的具体调用。 如果发生绑定错误，则请求终止，并触发 c.AbortWithError(400, err).SetType(ErrorTypeBind)。响应状态码被设置为 400 并且 Content-Type 被设置为 text/plain; charset=utf-8。 如果您在此之后尝试设置响应状态码，Gin会输出日志 [GIN-debug] [WARNING] Headers were already written. Wanted to override status code 400 with 422。 如果您希望更好地控制绑定，考虑使用 ShouldBind 等效方法。
• Type - Should bindMethods - ShouldBind, ShouldBindJSON, ShouldBindXML, ShouldBindQuery, ShouldBindYAMLBehavior - 这些方法属于 ShouldBindWith 的具体调用。 如果发生绑定错误，Gin 会返回错误并由开发者处理错误和请求。

使用 Bind 方法时，Gin 会尝试根据 Content-Type 推断如何绑定。 如果你明确知道要绑定什么，可以使用 MustBindWith 或 ShouldBindWith。以下是官网上对应的示例代码：

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"`
	// CheckIn 字段表示入住日期，必须填写并且要通过 bookabledate 验证。日期格式为 "2006-01-02"。
	CheckOut time.Time `form:"check_out" binding:"required,gtfield=CheckIn" time_format:"2006-01-02"`
	// CheckOut 字段表示退房日期，必须填写并且要晚于 CheckIn 日期。日期格式为 "2006-01-02"。
}

// bookableDate 是一个自定义验证函数，用于检查日期是否在今天之后。
// bookableDate validator.Func 是一个验证函数类型。
var bookableDate validator.Func = func(fl validator.FieldLevel) bool {
	date, ok := fl.Field().Interface().(time.Time)
	// 尝试将字段值转换为 time.Time 类型。
	if ok {
		today := time.Now()
		// 获取当前时间。
		if today.After(date) {
			return false
			// 如果当前时间晚于给定日期，验证失败。
		}
	}
	return true
	// 否则，验证成功。
}

func main() {
	route := gin.Default()
	// 创建一个默认的 Gin 路由。

	// 获取验证引擎并注册自定义验证器。
	if v, ok := binding.Validator.Engine().(*validator.Validate); ok {
		v.RegisterValidation("bookabledate", bookableDate)
		// 注册自定义验证器 "bookabledate"。
	}

	// 定义一个 GET 路由，用于处理预订请求。
	route.GET("/bookable", getBookable)
	// 运行 Gin 服务器，监听 8085 端口。
	route.Run(":8085")
}

// getBookable 处理 GET /bookable 请求，绑定并验证查询参数。
func getBookable(c *gin.Context) {
	var b Booking
	// 创建一个 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()})
	}
}

上面的代码用于验证和处理酒店预订日期。它通过自定义验证器确保预订日期是有效的并且符合特定条件。预定的入住日期必须是晚于今天，退房日期日期必须大于入住日期。

运行上面的代码日期在2024-06-14日，所以入住日期需要> 2024-06-14 退房日期需要> 2024-06-15

下面的请求将会报错，原因入住日期和退房日期相同，不满足退房日期大于入住日期。

下面的请求将会报错，原因入住日期在今天之前

下面这种场景才是正确的。