文本序列化和反序列化

文本序列化和反序列化

go-zero针对文本的序列化和反序列化主要在三个地方使用

http api请求体的反序列化
http api返回体的序列化
配置文件的反序列化

本文假定读者已经定义过api文件以及修改过配置文件，如不熟悉，可参照

1. http api请求体的反序列化

在反序列化的过程中的针对请求数据的数据格式以及数据校验需求，go-zero实现了自己的一套反序列化机制

1.1 `数据格式`以订单order.api文件为例

type (
    createOrderReq struct {
        token     string `path:"token"`     // 用户token
        productId string `json:"productId"` // 商品ID
        num       int    `json:"num"`       // 商品数量
    }
    createOrderRes struct {
        success bool `json:"success"` // 是否成功
    }
    findOrderReq struct {
        token    string `path:"token"`    // 用户token
        page     int    `form:"page"`     // 页数
        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)
}