反射读取类级别注解需声明@Retention(RUNTIME)和@Target(TYPE),通过Class#getAnnotation()获取实例并调用其方法提取属性;结合注解属性构建路由键,扫描注册映射表实现动态分发,注意数组判空、ClassLoader一致性和Spring Bean管理。

反射读取类级别注解,本质是通过 Class#getAnnotation(Class<t>)</t> 获取声明在类上的注解实例,再调用其方法提取属性值;结合这些元数据做逻辑路由,关键在于统一约定注解结构、建立注解与处理器的映射关系,并在运行时动态分发。
获取类上注解实例并读取属性
Java 反射提供直接支持:只要注解声明了 @Retention(RetentionPolicy.RUNTIME),就能在运行时通过反射访问。
- 先确保自定义注解标注
@Retention(RUNTIME)和@Target(ElementType.TYPE) - 使用
clazz.getAnnotation(MyRoute.class)获取注解对象(返回null表示未声明) - 调用注解接口定义的方法,如
myRoute.value()、myRoute.method(),即可拿到配置的字符串、枚举或 Class 类型属性
用注解属性构建路由键或匹配条件
注解属性通常用于标识行为特征,比如路径、类型、优先级。可将其组合成唯一路由键,或作为 if-else / switch 的判断依据。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
- 常见做法:把
@Controller("/user")中的value()提取为路径前缀,再结合方法级注解拼出完整 endpoint - 也可用枚举属性(如
routeType() = RouteType.ADMIN)做权限路由分流 - 若属性是
Class>类型(如handler() = UserHandler.class),可直接newInstance()或交由 Spring 管理后通过上下文获取
建立注解到处理器的映射表
避免硬编码 if 判断,推荐启动时扫描所有含目标注解的类,注册到路由表中。
- 用
ClassPathScanningCandidateComponentProvider(Spring)或Reflections库扫描指定包下带注解的类 - 遍历每个
BeanDefinition或Class,调用getAnnotation()提取元数据 - 将注解属性(如 path + method)作为 key,对应处理器实例或工厂方法作为 value,存入
ConcurrentHashMap - 请求到达时,解析请求信息 → 构造路由 key → 查表 → 执行对应逻辑
注意事项与典型陷阱
看似简单,但几个细节容易导致失败:
- 注解必须声明
@Retention(RUNTIME),否则反射拿不到 - 如果注解属性是数组类型(如
String[] paths()),需判空并遍历处理,不能直接 toString() - 当属性是 Class 类型时,注意类加载器一致性;跨模块时可能因 ClassLoader 不同导致
instanceof失败 - Spring 环境下,不建议在注解中直接 new 实例,应结合
@Autowired或ApplicationContext.getBean()获取托管 Bean


















