`java.lang.annotation` 是 Java 语言中用于定义和处理注解（Annotations）的核心包

java.lang.annotation 是 Java 标准库中的一个包，它提供了与注解（Annotation）相关的类和接口，用于定义和处理注解。注解是 Java 语言在 5.0 版本中引入的一种元数据机制，用于为代码提供额外的信息，这些信息可以在编译时、运行时或类加载时被工具或框架读取和处理。

以下是 java.lang.annotation 包中一些重要的类和接口：

1. Annotation 接口

• 这是所有注解类型的父接口。
• 它定义了注解的基本行为和方法，例如 annotationType() 方法，用于获取注解的类型。

2. Retention 注解

• 用于指定注解的保留策略，即注解在什么阶段仍然可用。
• 它可以有以下三种保留策略：
  • RetentionPolicy.SOURCE：注解仅在源代码中可用，编译时会被丢弃。
  • RetentionPolicy.CLASS：注解在编译时保留，但在运行时不可用。
  • RetentionPolicy.RUNTIME：注解在运行时仍然可用，可以通过反射访问。

3. Target 注解

• 用于指定注解可以应用的目标元素类型。
• 可以是类、方法、字段、构造函数、参数等。例如：
  • ElementType.TYPE：可以应用于类、接口或枚举。
  • ElementType.METHOD：可以应用于方法。
  • ElementType.FIELD：可以应用于字段。

4. Documented 注解

• 用于指定注解是否应该被包含在 JavaDoc 文档中。
• 如果一个注解被 @Documented 注解标记，那么它会被包含在生成的文档中。

5. Inherited 注解

• 用于指定注解是否可以被子类继承。
• 如果一个注解被 @Inherited 注解标记，那么它会被子类继承，但仅限于类级别的注解。

6. Repeatable 注解

• 用于指定注解是否可以重复使用。
• 从 Java 8 开始，支持在同一个目标元素上重复使用同一个注解。

示例代码

以下是一个简单的注解定义和使用示例：

import java.lang.annotation.*;

// 定义一个注解
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
@interface MyAnnotation {
    String value();
}

// 使用注解
public class AnnotationExample {
    @MyAnnotation(value = "Hello, World!")
    public void myMethod() {
        System.out.println("This is a method with an annotation.");
    }

    public static void main(String[] args) {
        AnnotationExample example = new AnnotationExample();
        example.myMethod();

        // 反射获取注解信息
        MyAnnotation annotation = example.getClass().getMethod("myMethod").getAnnotation(MyAnnotation.class);
        System.out.println("Annotation value: " + annotation.value());
    }
}

总结

java.lang.annotation 包是 Java 注解机制的核心，它提供了定义注解的基础设施和工具。通过注解，开发者可以在代码中添加元数据，这些元数据可以被编译器、工具或运行时环境读取和处理，从而实现各种强大的功能，例如依赖注入、日志记录、代码生成等。
java.lang.annotation 是 Java 语言中用于定义和处理注解（Annotations）的核心包。注解是 Java 5 引入的一种元数据形式，它为程序元素（类、方法、字段等）提供额外的信息，这些信息可以在编译时、运行时被读取和处理。

核心接口和类

1. Annotation 接口
   所有注解类型都隐式继承自 java.lang.annotation.Annotation，但不能显式继承它。

2. 元注解（Meta-Annotations）
   用于定义其他注解的注解，包括：

   • @Retention：指定注解的保留策略（SOURCE、CLASS、RUNTIME）。
   • @Target：指定注解可以应用的程序元素类型。
   • @Documented：指示注解应被包含在 JavaDoc 中。
   • @Inherited：允许子类继承父类的注解。
   • @Repeatable（Java 8+）：允许同一类型的注解多次应用于同一元素。

3. 其他接口

   • ElementType：枚举类型，定义注解可以应用的目标类型。
   • RetentionPolicy：枚举类型，定义注解的保留策略。

注解的声明与使用

以下是一个自定义注解的示例：

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 "";
    int priority() default 1;
}

// 使用注解
class MyClass {
    @MyAnnotation(value = "Important", priority = 5)
    public void myMethod() {
        // 方法实现
    }
}

注解处理器

在运行时，可以通过反射机制获取和处理注解：

import java.lang.reflect.Method;

public class AnnotationProcessor {
    public static void main(String[] args) throws NoSuchMethodException {
        Class<?> clazz = MyClass.class;
        Method method = clazz.getMethod("myMethod");
        
        if (method.isAnnotationPresent(MyAnnotation.class)) {
            MyAnnotation annotation = method.getAnnotation(MyAnnotation.class);
            System.out.println("Value: " + annotation.value());
            System.out.println("Priority: " + annotation.priority());
        }
    }
}

常见内置注解

Java 标准库提供了一些内置注解，例如：

• @Override：检查方法是否正确覆盖了父类的方法。
• @Deprecated：标记已过时的程序元素。
• @SuppressWarnings：抑制编译器警告。
• @FunctionalInterface（Java 8+）：标识函数式接口。

注解在现代 Java 开发中广泛应用于框架（如 Spring、JUnit）、代码生成工具和编译时检查等场景。
Provides library support for the Java programming language annotation facility.

See: Description

Interface Summary  Interface 	Description
Annotation 	
The common interface extended by all annotation types.
Enum Summary  Enum 	Description
ElementType 	
A program element type.
RetentionPolicy 	
Annotation retention policy.
Exception Summary  Exception 	Description
AnnotationTypeMismatchException 	
Thrown to indicate that a program has attempted to access an element of an annotation whose type has changed after the annotation was compiled (or serialized).
IncompleteAnnotationException 	
Thrown to indicate that a program has attempted to access an element of an annotation type that was added to the annotation type definition after the annotation was compiled (or serialized).
Error Summary  Error 	Description
AnnotationFormatError 	
Thrown when the annotation parser attempts to read an annotation from a class file and determines that the annotation is malformed.
Annotation Types Summary  Annotation Type 	Description
Documented 	
Indicates that annotations with a type are to be documented by javadoc and similar tools by default.
Inherited 	
Indicates that an annotation type is automatically inherited.
Retention 	
Indicates how long annotations with the annotated type are to be retained.
Target 	
Indicates the kinds of program element to which an annotation type is applicable.

Package java.lang.annotation Description
Provides library support for the Java programming language annotation facility.

Since:
1.5