如何在 go 中使用 swag 处理 json 请求参数

如果你在 go 中使用 swagger 来处理请求，那么你可能会遇到处理 json 请求参数的情况。本文将介绍如何在 swag 中实现此功能。

swag 注释

swag 注释是一个用于为 go api 生成 openapi 规范的库。通过使用 swag 注释，你可以为你的 api 定义请求参数、响应和模型。对于 json 请求参数，可以使用 @param 注释：

// login 用户登录
// @summary 用户登录
// @description 用于登录用户并返回 token
// @tags 用户接口
// @accept  json
// @produce  json
// @param body body models.userlogin "登录信息"
// @security bearerauth
// @success 200 {object} models.authtoken
// @router /users/login [post]
func login(c *gin.context) {
    // 处理 json 请求参数
}

在这种情况下，body 参数被定义为 models.userlogin 类型，这是一个表示登录信息的模型。

接收 json 请求体

在处理请求时，可以使用 io.readall(r.body) 读取请求体并将其反序列化为预定义的类型。

r := *http.Request{}
query := struct{}
raw, _ := io.ReadAll(r.Body)
_ = json.Unmarshal(raw, &query)

在上面的示例中，query 是一个空的结构体，json.unmarshal 函数将反序列化请求体并将解析后的数据填充到 query 结构体中。