Java自定义注解

在Java中，自定义注解是一种非常强大的功能，它允许你为代码添加元数据，这些元数据可以在编译时、类加载时或运行时被读取和处理。下面是创建和使用自定义注解的基本步骤：

1. 定义注解

使用@interface关键字来定义一个注解。你可以指定注解的属性，这些属性可以有默认值。

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) // 注解的目标是方法
public @interface CustomAnnotation {
    String value() default "Default Value"; // 注解属性
}

2. 使用注解

一旦定义了注解，你可以将它应用于类、方法、字段、参数等。

public class Example {

    @CustomAnnotation(value = "Hello, World!")
    public void testMethod() {
        System.out.println("This is a test method.");
    }
}

3. 读取注解

要读取注解，可以使用Java反射API。

import java.lang.reflect.Method;

public class AnnotationReader {
    public static void main(String[] args) {
        try {
            Method method = Example.class.getMethod("testMethod");
            CustomAnnotation annotation = method.getAnnotation(CustomAnnotation.class);
            if (annotation != null) {
                System.out.println("Annotation value: " + annotation.value());
            }
        } catch (NoSuchMethodException e) {
            e.printStackTrace();
        }
    }
}

4. 注解的元数据

• @Retention：定义了注解的保留策略。

  • RetentionPolicy.SOURCE：注解仅保留在源代码中，在编译时丢弃。
  • RetentionPolicy.CLASS：注解保留在class文件中，但在运行时无法通过反射访问。
  • RetentionPolicy.RUNTIME：注解保留在class文件中，并且在运行时可以通过反射访问。

• @Target：定义了注解可以应用的Java元素类型。

  • ElementType.TYPE：类、接口或枚举的声明。
  • ElementType.FIELD：字段声明（包括enum常量）。
  • ElementType.METHOD：方法声明。
  • ElementType.PARAMETER：参数声明。
  • ElementType.CONSTRUCTOR：构造函数声明。
  • ElementType.LOCAL_VARIABLE：局部变量声明。
  • ElementType.ANNOTATION_TYPE：注解声明。
  • ElementType.PACKAGE：包声明。

5. 注解属性类型

注解的属性类型必须是以下八种类型之一：

• 所有基本数据类型（int、float等）
• String
• Class
• enum
• 注解
• 以上类型的数组

6. 注解的继承

默认情况下，注解不是继承的，即一个类继承了另一个类，子类不会继承父类的注解。但是，你可以通过@Inherited注解来声明注解是可继承的。