Java注解与反射结合可在运行时获取元信息,实现配置、校验等功能。首先定义@Retention(RUNTIME)和@Target的自定义注解Description,用于标记类或方法;接着在UserService类及其saveUser方法上应用该注解;然后通过反射调用isAnnotationPresent()和getAnnotation()方法解析类和方法上的注解信息,输出类描述为“用户服务类”,作者为“unknown”,方法saveUser的描述为“保存用户”,作者为“zhangsan”;关键点是注解必须声明为RUNTIME级别,才能在运行时通过class、Method等反射对象读取,此机制广泛应用于spring、JPA等框架的零配置与AOP实现。

Java注解与反射结合,可以在运行时动态获取类、方法、字段等元素上的元信息,从而实现诸如框架配置、数据校验、序列化控制等功能。核心思路是:通过反射获取类结构信息,再通过注解相关的API提取注解值。
定义自定义注解
先创建一个注解,用于标记类或方法:
@Retention(RetentionPolicy.RUNTIME) @Target({ElementType.TYPE, ElementType.METHOD}) public @interface Description { String value(); String author() default "unknown"; }
@Retention(RetentionPolicy.RUNTIME) 表示该注解在运行时保留,这样才能通过反射读取。@Target 指定注解可以修饰的程序元素。
使用注解标记类和方法
在类或方法上应用注解:
立即学习“Java免费学习笔记(深入)”;
@Description("用户服务类") public class UserService { @Description(value = "保存用户", author = "zhangsan") public void saveUser() { System.out.println("保存用户..."); } public void deleteUser() { System.out.println("删除用户..."); } }
通过反射解析注解信息
利用反射 API 读取类和方法上的注解数据:
public class AnnotationParser { public static void parse(Class<?> clazz) { // 判断类是否有 Description 注解 if (clazz.isAnnotationPresent(Description.class)) { Description desc = clazz.getAnnotation(Description.class); System.out.println("类描述: " + desc.value()); System.out.println("作者: " + desc.author()); } // 遍历所有方法,检查是否有 Description 注解 for (java.lang.reflect.Method method : clazz.getDeclaredMethods()) { if (method.isAnnotationPresent(Description.class)) { Description desc = method.getAnnotation(Description.class); System.out.println("方法: " + method.getName() + ", 描述: " + desc.value() + ", 作者: " + desc.author()); } } } public static void main(String[] args) { parse(UserService.class); } }
输出结果:
类描述: 用户服务类
作者: unknown
方法: saveUser, 描述: 保存用户, 作者: zhangsan
关键点说明
- 只有注解被声明为 RUNTIME 级别,才能在运行时通过反射访问。
- Class、Method、Field、constructor 等反射对象都提供了 isAnnotationPresent() 和 getAnnotation() 方法。
- 可结合注解属性构建配置逻辑,比如根据注解决定是否执行某个方法,或生成文档。
基本上就这些。注解+反射是很多框架(如Spring、JPA、junit)实现“零配置”或“AOP”的基础机制。


