核心是通过@retention(retentionpolicy.runtime)定义运行时注解,配合@target限定作用位置,再用反射扫描并缓存注解属性,实现零侵入的配置外化;需避免高频反射、校验参数并限制扫描范围。

核心在于:定义一个运行时可见的注解,再用反射扫描目标类或方法,读取注解属性并执行对应配置逻辑。整个过程不修改原有业务代码,只通过“打标签+解析标签”实现配置外化。
定义支持运行时解析的自定义注解
必须使用 @Retention(RetentionPolicy.RUNTIME),否则反射拿不到;同时用 @Target 明确作用位置(如类、字段、方法):
-
@Retention(RetentionPolicy.RUNTIME) 是硬性要求,只有它才能让注解在 JVM 运行时被
getAnnotation()读取 - @Target({ElementType.TYPE, ElementType.FIELD}) 表示该注解可用于类和字段,适合组件级配置(比如标记某个类是可配置的 Bean,某个字段需要注入配置值)
- 注解属性推荐用基本类型、String、Class 或 String[],避免复杂嵌套——解析简单、兼容性好、不易出错
用反射扫描并提取注解信息
以类级别注解为例,获取配置通常分三步:定位类 → 检查注解是否存在 → 提取属性值:
- 通过
Class.forName("com.example.MyComponent")或 Spring 的ApplicationContext.getBeansWithAnnotation(...)找到目标类 - 调用
clazz.isAnnotationPresent(MyConfig.class)判断注解是否存在,避免空指针 - 用
clazz.getAnnotation(MyConfig.class).value()直接读取属性,字符串、布尔、数组都按同种方式访问 - 若需批量处理(如扫描包下所有带注解的类),可用
ClassPathScanningCandidateComponentProvider(Spring)或Reflections库辅助发现
根据注解内容动态装配组件行为
拿到注解值后,就进入“解释执行”阶段。常见做法是映射到具体操作,例如:
- 注解带
profile = "dev"属性 → 在 dev 环境启用调试日志、禁用缓存 - 注解声明
timeout = 5000→ 反射设置 HTTP 客户端超时时间,或包装为带超时的代理对象 - 注解含
fallback = MyFallback.class→ 用反射实例化 fallback 类,注入到主组件中作为降级策略 - 避免在每次调用时重复反射:把解析结果缓存为配置对象(如
MyConfigProps实例),后续直接使用
注意性能与安全边界
反射不是免费的,尤其高频调用场景需克制:
- 不要在方法内部反复调用
getMethod().getAnnotation(),应在初始化阶段一次性解析并缓存 - 禁用
setAccessible(true)访问私有成员,除非明确需要且已评估安全风险 - 对注解参数做基础校验(如非空、范围检查),防止恶意或误配导致运行时异常
- 生产环境慎用全包扫描,优先结合命名规范或接口继承关系缩小反射范围











