翻译功能
版本
= 1.6.0
引入依赖
xml
<dependency>
<groupId>com.ruoyi</groupId>
<artifactId>ruoyi-common-translation</artifactId>
</dependency>注解说明
@Translation:标注在实体字段上,用于声明需要翻译的字段。@TranslationType:标注在实现类上,与 @Translation 的 type 一致,用于实现翻译逻辑。

补充说明:
- Cloud 版本与 Vue 版本共用同一套翻译组件。
- 使用目的同样是把 ID、code 等原始值在返回前翻译为适合展示的字段。
使用说明
注意:翻译功能基于序列化实现,仅适合小数据量场景,不适用于 Excel 等大数据量导出。
建议缓存翻译结果,减少重复查询。
内置翻译类型:
- 用户 ID -> 账号/用户名
- 部门 ID -> 部门名称
- 字典 type -> label
- OSS ID -> URL
示例说明:
- 映射翻译:根据另一个字段映射到当前字段
- 直接翻译:根据当前字段直接替换
- 其他条件翻译:基于
other自定义条件




自定义扩展
实现 TranslationInterface 并标注 @TranslationType,可参考框架默认实现。

补充说明:
- 使用方式与 Vue 版本一致,可直接参考 Vue 版本翻译功能说明。
- Cloud 场景下如果翻译逻辑涉及远程服务,更应优先做好缓存,否则接口放大后性能损耗会更明显。