如何高效定义和验证restful请求的参数_go-zero api 自定义参数校验(2)

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化的资料的朋友，可以添加戳这里获取

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

	pageSize int8   `form:"pageSize"` // 页大小
}
findOrderRes struct {
	orderInfo []orderInfo `json:"orderInfo"` // 商品ID
}
orderInfo struct {
	productId   string `json:"productId"`   // 商品ID
	productName string `json:"productName"` // 商品名称
	num         int    `json:"num"`         // 商品数量
}
deleteOrderReq struct {
	id string `path:"id"`
}
deleteOrderRes struct {
	success bool `json:"success"` // 是否成功
}

)

service order {
@doc(
summary: 创建订单
)
@handler CreateOrderHandler
post /order/add/:token(createOrderReq) returns(createOrderRes)

@doc(
    summary: 获取订单
)
@handler FindOrderHandler
get /order/find/:token(findOrderReq) returns(findOrderRes)

@doc(
    summary: 删除订单
)
@handler: DeleteOrderHandler
delete /order/:id(deleteOrderReq) returns(deleteOrderRes)

}

http api请求体的反序列化的tag有三种：


* path：http url 路径中参数反序列化/order/add/1234567会解析出来token为1234567
* form：http form表单反序列化，需要 header头添加 Content-Type: multipart/form-data/order/find/1234567?page=1&pageSize=20会解析出来token为1234567，page为1，pageSize为20
* json：http request json body反序列化，需要 header头添加 Content-Type: application/json{"productId":"321","num":1}会解析出来productId为321，num为1


**1.2 数据校验以用户user.api文件为例**

type (
createUserReq struct {
age int8 json:"age,default=20,range=(12:100]" // 年龄
name string json:"name" // 名字
alias string json:"alias,optional" // 别名
sex string json:"sex,options=male|female" // 性别
avatar string json:"avatar,default=default.png" // 头像
}
createUserRes struct {
success bool json:"success" // 是否成功
}
)

service user {
@doc(
summary: 创建订单
)
@handler CreateUserHandler
post /user/add(createUserReq) returns(createUserRes)
}

数据校验有很多种方式，包括以下但不限：


* age：默认不输入为20，输入则取值范围为(12:100]，前开后闭
* name：必填，不可为空
* alias：选填，可为空
* sex：必填，取值为male或female
* avatar：选填，默认为default.png


![img](https://img-blog.csdnimg.cn/img_convert/957bc766c1cb66d4aa5bd07f818bd81a.png)
![img](https://img-blog.csdnimg.cn/img_convert/e850ba102b6743607a7ccbb6b4a9dc61.png)

**网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。**

**[需要这份系统化的资料的朋友，可以添加戳这里获取](https://bbs.csdn.net/topics/618658159)**


**一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！**



**一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！**