yun
21293673e1
BREAKING CHANGE: 相对 v0.0.1 的 API 变更 - 删除全部 Set* 方法，改为返回新值的 With*；错误值不可变，包级常量可并发使用 - 错误值不再持有 context，只保存语言标识（WithLang），渲染时再传 ctx - 删除兼容别名 Errf / ErrfKV / Msgf / NewLanguage / NewStruct 与空操作 Copy() - Msgf 改为 MsgWith，NewErrorf 改为 NewErrorWith；ErrorLanguage 不再实现 ErrorInterface 修复 - Copy 浅拷贝共享 format map，并发下 fatal error: concurrent map writes - 包级常量被 Set* 污染，请求之间互相改写错误文案 - langx.RegisterCode / RegisterTrans 覆盖注册表后，运行时错误码退化为默认码、文案退化为裸 key - 未注册 key 静默返回默认码 + 裸 key，现返回 500 + 未注册提示 - NewError(nil, ...) 与非 string 的 Accept-Language 触发 panic 新增 - Wrap / Unwrap / errors.Is 按 key 匹配、调用栈（惰性解析）、%+v 输出 cause 与栈 - 错误常量自带默认文案兜底 + errorx 侧常量注册表（不依赖 langx 可变状态） - 根 README、3 个可运行示例、17 个断言测试（语句覆盖率 97.2%）、基准测试 依赖 - github.com/yuninks/langx v0.0.7 -> v0.1.0
1.3 KiB
1.3 KiB
langx 资源加载示例
本目录演示 langx 的三种资源加载方式，以及它们与 errorx 的配合。
| 方式 | 函数 | 语义 |
|---|---|---|
| 追加 | langx.AppendCode / langx.AppendTrans |
按键合并，业务代码推荐 |
| 打包 | langx.RegisterEmbed(fs) |
按键合并，用 //go:embed 把 lang 目录打进二进制，随程序发布 |
| 目录 | langx.RegisterDir(dir) |
按键合并，运行时读目录，改文案不用重新编译 |
资源文件格式
code.json：{"key": 业务码}zh.json/en.json：{"key": "文案 #占位符#"}- 子目录的第一段是语言名：
zh/common.json、zh/errors.json都会并入zh
注意两种注册语义（langx v0.1.0 起）
RegisterCode/RegisterTrans：整体替换对应的注册表，会冲掉errorx.New在 init 阶段追加的内置文案；RegisterEmbed/RegisterDir/RegisterFS：按键合并，不影响已经注册的资源。
即使被整体替换，errorx 的错误常量自带 code 与默认文案，查不到时会自动回填，
所以 errorx.Error.Err().GetCode() 永远是 400、文案永远可读，不会退化成裸 key。
但如果直接用 langx.GetTransFormat 读这些 key，就会看到裸 key。
运行：
go run ./example/imports