JSON Marshal 库
Hertz 使用的 JSON Marshal 库及自定义能力。
Hertz 默认集成并使用 Sonic 用于序列化 ctx.JSON
接口,以及反序列化 binding
包中的请求。Sonic 是一款超高性能 golang json 库,详情参考 Sonic README 。
开启 Sonic 需要满足以下条件:
- Go 1.16 以上
- Linux / darwin OS / Windows
- Amd64 CPU with AVX instruction set
当上述条件不能满足时,Sonic 会自动 fallback 到 golang 的 encoding/json 库。
自定义 JSON Marshall Unmarshal 库
如果 Sonic 不能够满足您的需求,你可以使用以下方式配置 binding 或 render 的自定义 json marshal unmarshal 库:
条件编译
Hertz 支持条件编译来控制实际使用的 json 库,你可以通过 -tags stdjson
来选择使用标准库。
go build -tags stdjson
Sonic 相关问题
若出现与 Sonic 相关的问题,可参考 Sonic README 或提 issue 解决。
最后修改
November 14, 2024
: Feat: Documentation for Monolake (#1165) (2667d6a)