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() 方法。
- 可结合注解属性构建配置逻辑，比如根据注解决定是否执行某个方法，或生成文档。
