怎样理解 Java 注解和运用注解编程？-CSDN博客

本文链接：https://blog.csdn.net/qq_45690116/article/details/133943217

Java注解是Java编程语言中的一种元数据（metadata）机制，它允许我们在源代码中添加有关程序元素的额外信息，以便在编译、运行时或工具处理中使用。注解为我们提供了一种声明性的方式来描述代码的特性、性质和行为。

它可以用于很多方面，如生成文档、配置应用程序、执行运行时检查等。在本文中，我们将深入探讨Java注解的概念，并提供专业的代码示例，以展示如何运用注解进行编程。

Java注解的基本概念

Java注解是一种注释，它使用@符号作为标识，通常放在Java源代码的类、方法、字段、参数等元素前面。

注解本身是接口，可以在接口内定义注解的成员，这些成员可以包含默认值。

以下是一个简单的Java注解示例：

import java.lang.annotation.*;

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface MyAnnotation {
    String value() default "Default Value";
    int number();
}

在这个示例中，@MyAnnotation是一个自定义注解，它定义了两个成员：value和number。@Retention和@Target注解用于指定注解的保留策略和目标元素类型。

使用Java注解

要使用自定义注解，只需将它添加到相应的程序元素上。以下是一个示例，演示如何在类、方法和字段上使用自定义注解：

public class MyClass {
    @MyAnnotation(number = 42)
    private int myField;

    @MyAnnotation(number = 7)
    public void myMethod() {
        // 方法内容
    }
}

在这个示例中，我们将@MyAnnotation注解分别添加到了类的字段和方法上，并为注解的number成员提供了不同的值。

自定义注解的处理

为了充分利用Java注解，我们通常需要编写注解处理器（Annotation Processor）来读取和处理注解信息。注解处理器可以在编译时或运行时执行，它可以用于自动生成代码、进行验证、配置加载等任务。

下面是一个简单的注解处理器示例，演示如何读取并处理自定义注解：

import java.lang.reflect.Method;

public class MyAnnotationProcessor {
    public static void processAnnotations(Class<?> clazz) {
        if (clazz.isAnnotationPresent(MyAnnotation.class)) {
            MyAnnotation annotation = clazz.getAnnotation(MyAnnotation.class);
            String value = annotation.value();
            int number = annotation.number();
            System.out.println("Class annotation value: " + value);
            System.out.println("Class annotation number: " + number);
        }

        for (Method method : clazz.getDeclaredMethods()) {
            if (method.isAnnotationPresent(MyAnnotation.class)) {
                MyAnnotation annotation = method.getAnnotation(MyAnnotation.class);
                int number = annotation.number();
                System.out.println("Method " + method.getName() + " annotation number: " + number);
            }
        }
    }

    public static void main(String[] args) {
        processAnnotations(MyClass.class);
    }
}

这个处理器会检查MyClass类和其方法上的@MyAnnotation注解，然后提取注解的信息并进行输出。在实际应用中，注解处理器可以更复杂，用于生成代码、配置加载、权限验证等任务。