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

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，涵盖了95%以上Go语言开发知识点，真正体系化！

由于文件比较多，这里只是将部分目录截图出来，全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频，并且后续会持续更新

如果你需要这些资料，可以戳这里获取

}

)

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



**2. http api返回体的序列化**


使用官方默认的encoding/json包序列化，在此不再累赘。



**3. 配置文件的反序列化**


配置文件的反序列化和http api请求体的反序列化使用同一套解析规则，可参照http api请求体的反序列化。



![img](https://img-blog.csdnimg.cn/img_convert/5c561fcf0ba1c7ecd4cb896a18dcb516.png)
![img](https://img-blog.csdnimg.cn/img_convert/52b4cff2e70cfa1cbb413fc2f2d5d7b2.png)

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

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


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



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