本文共 1977 字，大约阅读时间需要 6 分钟。

Java注解详解：从基础到实践

1. 声明注解

在Java中，注解是通过使用@interface关键字来声明的。以下是创建一个注解的基本步骤：

示例：

@Target({ElementType.FIELD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Info {
    String value() default "tracy";
    boolean isDelete();
}

2. 元注解

元注解用于控制注解的应用范围和生命周期。

2.1 @Target

• 描述：指定注解适用的Java元素类型。
• 类型：ElementType.TYPE（类、接口、枚举）、ElementType.FIELD（字段）、ElementType.METHOD（方法）、ElementType.PARAMETER（方法参数）、ElementType.CONSTRUCTOR（构造函数）、ElementType.LOCAL_VARIABLE（局部变量）、ElementType.ANNOTATION_TYPE（注解类型）、ElementType.PACKAGE（包）、ElementType.TYPE_PARAMETER（类型变量，Java 1.8及以上）、ElementType.TYPE_USE（类型使用，Java 1.8及以上）。

2.2 @Retention

• 描述：指定注解的生命周期。
• 类型：
  • RetentionPolicy.SOURCE：注解在编译时被丢弃，不包含在类文件中。
  • RetentionPolicy.CLASS：注解在JVM加载时被丢弃，包含在类文件中，默认值。
  • RetentionPolicy.RUNTIME：注解在运行时由JVM加载，包含在类文件中。

2.3 @Documented

• 描述：标记注解的元信息可以被Javadoc或文档工具处理。

2.4 @Inherited

• 描述：标记注解可以被子类继承。

3. 注解配置

3.1 属性定义

注解可以包含抽象方法或常数值属性，使用默认值可简化使用。

3.2 元注解结合

通过组合多个元注解，灵活控制注解的应用范围和生命周期。

4. 注解使用示例

4.1 注解定义

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {
    String name();
}

4.2 注解使用

@MyAnnotation(name = "MyClass")
public class MyClass {
    // ...
}

4.3 元注解应用

@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
public @interface FieldAnnotation {
    String description();
}

4.4 动态获取注解

public class AnnotationTest {
    public static void main(String[] args) {
        Person person = Person.builder().build();
        Class clazz = person.getClass();
        
        if (clazz.isAnnotationPresent(Info.class)) {
            Info infoAnno = (Info) clazz.getAnnotation(Info.class);
            System.out.println("Name: " + infoAnno.value() + ", Delete: " + infoAnno.isDelete());
        } else {
            System.out.println("No Info annotation present!");
        }
    }
}

通过以上内容，可以清晰地了解Java注解的基本使用方法和元注解的应用场景。从声明注解到实际使用，每一步都可以根据实际需求进行调整和优化。