Java中自定义注解实现I18N自动转换，核心是结合MessageSource、@I18nMessage注解与BeanPostProcessor或AOP，在运行时按Locale动态解析占位符并注入消息文本，声明即生效。
Java中自定义注解实现I18N消息自动转换，核心在于结合Spring的MessageSource、自定义注解、AOP（或BeanPostProcessor）拦截目标属性/方法，并在运行时动态解析占位符、注入当前Locale对应的消息文本。不依赖硬编码，也不靠手动调用getMessage()，而是让注解“声明即生效”。
定义支持多语言的自定义注解
注解需支持消息码（message key）、默认值（fallback）、参数占位符（如{0}、{name}），并可选指定是否启用国际化：
- 使用
@Target({ElementType.FIELD, ElementType.METHOD, ElementType.TYPE})覆盖常见使用场景 - 用
@Retention(RetentionPolicy.RUNTIME)确保运行时可读取 - 推荐字段：
String value()（必填key）、String defaultValue() default ""、Object[] args() default {}（静态参数）、boolean i18n() default true（开关）
示例：
@Target({FIELD, METHOD})@Retention(RUNTIME)
public @interface I18nMessage {
String value(); // 如 "user.not.found"
String defaultValue() default ""; // 无Locale匹配时兜底
String[] args() default {}; // 静态参数，如 {"admin"}
boolean i18n() default true;
}
编写消息解析器与Locale感知工具类
封装对MessageSource的调用逻辑，自动获取当前请求Locale（Spring MVC中可通过RequestContextHolder；微服务中建议从ThreadLocal或MDC提取）：
立即学习“Java免费学习笔记（深入）”；
- 注入
MessageSource（如ReloadableResourceBundleMessageSource） - 提供
resolve(String code, Object... args)方法：先尝试当前Locale，再fallback到系统默认Locale - 支持占位符语法统一：兼容
{0}（数组索引）和{username}（命名参数），后者需配合new MessageFormat(...).format(...)或org.springframework.context.support.MessageSourceResolvable
通过BeanPostProcessor实现字段级自动注入
适用于实体类字段标注@I18nMessage后，在Bean初始化完成前自动设值（如DTO、VO对象）：
- 实现
BeanPostProcessor，重写postProcessAfterInitialization - 反射遍历目标对象所有
@I18nMessage标注的Field，检查是否为String类型 - 调用消息解析器，传入注解配置的
value、args、当前Locale，将结果赋值给字段 - 注意：仅处理非final、可访问字段；避免循环引用或代理对象问题（加
!AopUtils.isAopProxy(bean)判断）
通过AOP实现方法返回值/参数的动态翻译
适用于Controller返回JSON时，对响应体中的特定字段（如错误码、提示信息）做运行时翻译：
- 定义切点匹配含
@I18nMessage的方法或返回类型含标注字段的对象 - 在
@Around通知中获取返回值，递归扫描其所有@I18nMessage字段（或自定义结构如I18nResult包装类） - 对每个匹配字段，调用消息解析器替换原始字符串为本地化文本
- 优势：不影响原有业务逻辑，支持嵌套对象、集合、泛型，且与序列化流程解耦
关键细节：Locale来源要可靠（Web环境优先用LocaleContextHolder.getLocale()）、消息文件命名规范（如messages_zh_CN.properties）、避免在静态上下文或异步线程中丢失Locale。整个过程无需修改业务代码，只通过注解+配置即可完成多语言注入。
