Java中使用注解实现字典值自动翻译的方法

背景与目标：解决字典翻译的性能问题

在处理包含状态、性别等枚举类型字段的业务场景时，通常需要将后端存储的代码（如 "0", "1"）转换为易读的文本（如 "男", "女"）。传统的做法是在 SQL 层面建立主表与字典表的关联查询，但这会带来以下痛点：

• SQL 冗长复杂：随着业务表增多，连接查询变得难以维护。
• 性能开销大：每次返回列表数据都触发额外的数据库读取操作。
• 解耦性差：业务逻辑与数据库结构紧密绑定。

为解决上述问题，目标是实现一种在 Java 内存层完成的自动化翻译方案，要求对业务代码侵入性小，且能透明地为前端提供翻译后的结果。

准备条件：创建自定义注解

首先，定义一个用于标记字典转换的自定义注解 @DictCovert。该注解需作用于字段或方法级别，并保留运行时信息以便反射读取。

@Target({ElementType.FIELD, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface DictCovert {
    /**
     * 字典标识 Key，用于查找对应翻译规则
     */
    String key() default "";

    /**
     * 是否优先使用 Redis 缓存进行翻译
     */
    boolean redis() default false;
}

随后，在需要进行字典转换的实体类属性上应用此注解。例如，将表示性别的整数字段标记为需要基于 "gender" key 进行翻译，且指定优先查缓存：

/**
 * 性别描述
 */
@DictCovert(key = "gender", redis = true)
private Integer gender;

核心实现：拦截响应数据并执行翻译

由于实体对象往往不由 Spring 容器直接管理，传统的 AOP 切面可能无法准确捕获时机。更可靠的方式是利用 Spring MVC 提供的全局通知机制：@ControllerAdvice 配合 ResponseBodyAdvice 接口。该接口能在 Controller 返回数据后、序列化发送前进行统一处理。

创建处理类 DictCovertHandler，注入依赖的服务与配置常量：

@ControllerAdvice
@Slf4j
public class DictCovertHandler implements ResponseBodyAdvice <Object> {

    @Autowired
    private RedisTemplate redisTemplate;

    @Autowired
    private ISysDicService sysDicService;

    // Redis 中字典值的键前缀
    private final String DICTDIR = "DICT:";
    ... 
}

第一步：判断是否需要处理返回数据

实现 supports 方法，决定哪些方法的返回值需要经过本处理器。若项目中大部分输出都需要字典转换，可简单返回 true；若需精细化控制，可在目标 Controller 方法上增加额外标记来过滤。

@Override
public boolean supports(MethodParameter returnType, Class converterType) {
    return true;
}

第二步：解析数据并遍历翻译字段

在 beforeBodyWrite 方法中编写核心逻辑。需注意处理不同的返回结构，如普通集合 List<?> 或分页对象 Page<?>。对于每个实体对象：

1. 利用工具类将 Bean 转换为 Map 以方便后续修改。
2. 通过 getDeclaredFields() 获取所有声明字段。
3. 检查字段是否带有 @DictCovert 注解。

第三步：获取源值并根据策略转换

对于被标记的字段，按以下步骤执行翻译：

1. 获取原始值：通过反射调用对应的 getter 方法（构造方式为 get + 字段名首字母大写）获取当前值。
2. 构建缓存/查询键：格式通常为 {key}_{value}。
3. 优先读取 Redis：如果注解中 redis=true 或默认开启，先从 Redis 的 DICT: 命名空间下读取翻译文本。
4. 回源查询数据库：如果缓存未命中，调用 sysDicService.getById(value) 从数据库加载字典详情。
5. 回填缓存：从数据库查到结果后，写入 Redis 以备后续高频访问。

最终结果：验证翻译效果

经过 ResponseBodyAdvice 的处理，原始数据会被增强。系统会在 Map 中新增一个名为 "{原字段名}String" 的键值对，存放翻译后的中文文本。

在前端接收到的 JSON 数据结构中，除了原有的数字编码外，会同时出现对应的字符串描述。这种双字段返回策略既保留了便于排序和筛选的数字 ID，又满足了展示需求，且整个过程完全对业务代码无感。