慧思后端 2026-06-12

Java注解的实现原理是什么？

AI 概述

Java注解是以@开头的代码标签，分内置、自定义、元注解三类。它有SOURCE、CLASS、RUNTIME三种生命周期，可通过@Target限定作用范围。可借助反射在运行时、APT在编译时解析处理，广泛应用于Spring、Lombok等框架，也能实现权限校验、AOP等功能，简化开发。

文章目录隐藏

1. 什么是注解？
2. 注解的分类：
3. 注解的原理：
4. 实际用途：

1. 什么是注解？

注解就是给代码加标签，可以在类、方法、字段等地方标记一些额外的信息。
注解自己不做事情，它需要一些工具或框架来读取和处理，这样就能实现一些额外的功能。

2. 注解的分类：

内置注解：Java 自带的一些注解，比如@Override（表示方法是重写的）和@Deprecated（表示方法不推荐再用）。
自定义注解：你自己定义的注解，用来实现自己需要的功能。
元注解：像@Retention和@Target这样的注解，用来设置其他注解的规则。

3. 注解的原理：

Java 提供了反射和注解处理器，可以在程序运行时或者编译时读取注解。
注解的存活时间由 RetentionPolicy 决定：
- SOURCE：只存在源代码里，编译后就没有了。
- CLASS：保留在字节码文件里，但运行时看不到。
- RUNTIME：保留在字节码里，程序运行时可以通过反射读取。

4. 实际用途：

框架开发：像 Spring AOP 或 MyBatis 用注解自动生成代码。
代码检查：比如@Override用来确保你重写的方法是正确的。
编译时工具：像Lombok用注解自动生成代码，减少手动写。

知识内容

1. 注解的核心概念

1.1 什么是注解？

注解是用 @ 开头的一种结构，用来描述代码的额外信息。

示例：内置注解

@Override
public String toString() {
    return "示例";
}

示例：自定义注解

@MyAnnotation(value = "测试注解")
public void testMethod() {}

解析：

注解本质是对代码的描述，最终由编译器、工具或运行时框架进行解析。

1.2 注解的生命周期

注解的生命周期由@Retention决定，可以分为三类：

SOURCE：仅在源码中有效，编译后会被丢弃。
CLASS：保留到字节码文件中，运行时不可见。
RUNTIME：保留到字节码中，运行时可通过反射解析。

示例代码

import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;

@Retention(RetentionPolicy.RUNTIME) // 生命周期为运行时
@interface MyAnnotation {
    String value();
}

1.3 注解的适用范围

通过@Target定义注解的作用范围：

ElementType.TYPE：作用于类或接口。
ElementType.METHOD：作用于方法。
ElementType.FIELD：作用于字段。

示例代码

import java.lang.annotation.ElementType;
import java.lang.annotation.Target;

@Target({ElementType.METHOD, ElementType.FIELD})
@interface MyAnnotation {}

1.4 注解的组成

一个注解可以包含以下部分：

元注解：定义注解的行为（如生命周期、作用范围）。
属性（成员变量）：注解的参数，可以有默认值。
默认值：通过 default 关键字指定。

完整示例

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Retention(RetentionPolicy.RUNTIME) // 注解生命周期
@Target({ElementType.METHOD}) // 注解适用范围
@interface MyAnnotation {
    String value() default "默认值"; // 成员变量
}

2. 注解的解析原理

2.1 运行时解析：通过反射获取注解

Java 的 反射机制 提供了运行时解析注解的能力。

示例：通过反射获取注解

import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.reflect.Method;

// 自定义运行时注解
@Retention(RetentionPolicy.RUNTIME)
@interface Log {
    String value() default "执行方法";
}

// 使用注解
class Demo {
    @Log("执行 myMethod 方法")
    public void myMethod() {
        System.out.println("方法运行中...");
    }
}

public class AnnotationReflection {
    public static void main(String[] args) throws Exception {
        // 获取方法上的注解
        Method method = Demo.class.getMethod("myMethod");
        if (method.isAnnotationPresent(Log.class)) {
            Log log = method.getAnnotation(Log.class);
            System.out.println("注解值：" + log.value());
        }

        // 调用实际方法
        new Demo().myMethod();
    }
}

输出结果：

注解值：执行 myMethod 方法
方法运行中...

2.2 编译时处理：APT

注解处理器（Annotation Processing Tool, APT） 是 Java 提供的编译时工具，用于扫描和处理注解。

APT 工作流程

编译器扫描源代码中的注解。
注解处理器解析注解信息。
根据注解生成代码或文件。

示例：APT 自动生成代码

import javax.annotation.processing.*;
import javax.lang.model.element.*;
import java.io.*;

@SupportedAnnotationTypes("MyAnnotation")
@SupportedSourceVersion(SourceVersion.RELEASE_8)
public class MyAnnotationProcessor extends AbstractProcessor {
    @Override
    public boolean process(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv) {
        for (Element element : roundEnv.getElementsAnnotatedWith(MyAnnotation.class)) {
            String className = element.getSimpleName().toString();
            try (Writer writer = processingEnv.getFiler()
                    .createSourceFile(className + "Generated")
                    .openWriter()) {
                writer.write("public class " + className + "Generated {}");
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
        return true;
    }
}

解析：

通过 APT 可以在编译时自动生成代码，广泛用于框架开发。

3. 注解的实际应用

(1) Spring 框架中的注解

@Autowired：自动装配依赖。
@Transactional：声明事务。
@Controller：标记控制器类。

(2) Lombok 注解

Lombok 使用注解简化代码开发，例如：

@Getter和@Setter自动生成 getter/setter 方法。
@Builder构造 Builder 模式。

(3) 权限校验

通过自定义注解实现方法级别的权限控制。

示例：基于注解的权限校验

import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;

@Retention(RetentionPolicy.RUNTIME)
@interface Permission {
    String role();
}

class UserController {
    @Permission(role = "ADMIN")
    public void deleteUser() {
        System.out.println("用户已被删除");
    }
}