Java注解

前言

JDK 1.5（也称为Java 5）于2004年9月30日发布。这个版本引入了许多重要的新特性，包括泛型、增强的for循环、自动装箱/拆箱、枚举类型、可变参数、静态导入以及注解（Annotations）。这些新特性极大地增强了Java语言的功能和灵活性。

1.注解定义

注解是Java语言中的一种特殊类型，可以附加到包、类、方法、字段、参数等程序元素上，用来提供与这些程序元素相关的元数据。注解本身不会直接影响程序的执行，但可以通过工具或框架在编译时、类加载时或运行时对这些元数据进行处理。

举个例子

1.1 定义注解

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

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface MyAnnotation {
    String value();
}

1.2 使用注解

public class MyClass {
    @MyAnnotation(value = "This is a test method")
    public void testMethod() {
        // 方法实现
    }
}

2.注解用途

2.1编译时检查

例如，@Override注解可以帮助编译器检查方法是否正确地重写了父类的方法。

2.2代码生成

例如，@Entity注解可以用于标记一个类是JPA实体，框架可以根据这些注解生成相应的数据库表结构。

2.3运行时处理

例如，依赖注入框架可以通过反射机制在运行时处理@Inject注解，实现依赖注入。

3.常见的内置注解

• @Override：用于标示方法重写。
• @Deprecated：用于标示过时的方法或类。
• @SuppressWarnings：用于抑制编译器警告。

注解的引入极大地增强了Java语言的灵活性和可扩展性，使得许多框架和工具能够更方便地进行元数据处理。

4.通用注解

4.1 @Documented
表示该注解会被包含在Javadoc中。
如果一个注解类型被@Documented修饰，那么在生成Javadoc文档时，该注解的信息会被包含在内。

4.2 @Retention：
指定注解的保留策略，即注解在什么级别可用。
取值包括：
RetentionPolicy.SOURCE：注解只在源代码中保留，编译时会被丢弃。
RetentionPolicy.CLASS：注解在编译时保留在类文件中，但在运行时不可见（默认值）。
RetentionPolicy.RUNTIME：注解在运行时保留，可以通过反射机制读取。

4.3@Target：
指定注解可以应用的程序元素。
取值包括：
ElementType.TYPE：可以应用于类、接口（包括注解类型）或枚举声明。
ElementType.FIELD：可以应用于字段或枚举常量。
ElementType.METHOD：可以应用于方法。
ElementType.PARAMETER：可以应用于方法参数。
ElementType.CONSTRUCTOR：可以应用于构造函数。
ElementType.LOCAL_VARIABLE：可以应用于局部变量。
ElementType.ANNOTATION_TYPE：可以应用于注解类型。
ElementType.PACKAGE：可以应用于包声明。