翻译功能

---

版本复制标题链接

• = 4.6.0

注解说明复制标题链接

@Translation：标注在实体字段上，用于声明需要翻译的字段。
@TranslationType：标注在实现类上，与 @Translation 的 type 一致，用于实现翻译逻辑。

补充说明：

• 这套能力适合把“数据库里存的 ID / code”在返回前自动翻译成可展示字段。
• 常见场景包括用户名称、部门名称、字典标签、OSS 地址等。

使用说明复制标题链接

注意：翻译功能基于序列化实现，仅适合小数据量场景，不适用于 Excel 等大数据量导出。
建议缓存翻译结果，减少重复查询。

内置翻译类型：

• 用户 ID -> 账号/用户名
• 部门 ID -> 部门名称
• 字典 type -> label
• OSS ID -> URL

示例说明：

• 映射翻译：根据另一个字段映射到当前字段
• 直接翻译：根据当前字段直接替换
• 其他条件翻译：基于 other 自定义条件

补充说明：

• 由于翻译发生在序列化阶段，所以返回列表越大，翻译开销越明显。
• 如果是导出、批量同步、离线任务等大数据量场景，建议提前查询并手动组装，不要完全依赖序列化翻译。

自定义扩展复制标题链接

实现 TranslationInterface 并标注 @TranslationType，可参考框架默认实现。

补充说明：

• 自定义翻译器时，建议优先考虑加缓存，避免每次序列化都重复查库或远程调用。