首页 > 文章 > java教程

Java注解与反射解析详解

时间：2025-12-12 10:39:31 415浏览收藏

推广推荐

支持 PC / 移动端，安全直达

本篇文章主要是结合我之前面试的各种经历和实战开发中遇到的问题解决经验整理的，希望这篇《Java注解与反射解析类元信息详解》对你有很大帮助！欢迎收藏，分享给更多的需要的朋友学习~

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

Java注解如何与反射结合解析类的元信息

Java注解与反射结合，可以在运行时动态获取类、方法、字段等元素上的元信息，从而实现诸如框架配置、数据校验、序列化控制等功能。核心思路是：通过反射获取类结构信息，再通过注解相关的API提取注解值。

定义自定义注解

先创建一个注解，用于标记类或方法：

@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.TYPE, ElementType.METHOD})
public @interface Description {
    String value();
    String author() default "unknown";
}

@Retention(RetentionPolicy.RUNTIME) 表示该注解在运行时保留，这样才能通过反射读取。@Target 指定注解可以修饰的程序元素。

使用注解标记类和方法

在类或方法上应用注解：

@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”的基础机制。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Java注解与反射解析详解》文章吧，也可关注golang学习网公众号了解相关技术文章。