Java注解详解-优快云博客

本文深入讲解Java中的注解，包括JDK自带注解、第三方注解及自定义注解的创建与使用。涵盖注解分类、元注解、自定义注解的语法要求及其应用场景。

一、Java中的常见注解

1.JDK自带注解

@Override 表示覆盖或重写父类的方法；

@Deprecated 表示该方法已经过时了。（当方法或是类上面有@Deprecated注解时，说明该方法或是类都已经过期不能再用，但不影响以前项目使用，提醒你新替代待的方法或是类。如果程序员不小心使用了它的元素,那么编译器会发出警告信息。）

@SuppressWarnings 表示忽略指定警告，比如@Suppvisewarnings("Deprecation")

2.常见第三方注解

举例一下@Autowired

定义一个dao成员变量要在xml文件里配置，如果用@Autowired注解则自动配置，将成员变量自动注入进来

二、注解的分类

按运行机制（注解存在于程序的那个阶段）将注解分为三类：源码注解(只在源码存在)、编译注解(在class文件中也存在)、运行时注解(在运行阶段仍然起作用)

jdk自带的注解都是编译注解

按照来源来分的话，有如下三类：
1：JDK自带的注解（Java目前只内置了三种标准注解：@Override、@Deprecated、@SuppressWarnings，以及四种元注解：@Target、@Retention、@Documented、@Inherited）
2：第三方的注解——这一类注解是我们接触最多和作用最大的一类
3：自定义注解——也可以看作是我们编写的注解，其他的都是他人编写注解

元注解：注解的注解

三、自定义注解

1.自定义注解的语法要求

注意：

访问修饰符必须为public，不写默认public；
成员的类型是受限制的，只能是基本数据类型、Class、String、Enumeration(枚举类型)、Annotation(注解类型)
该元素的名称一般定义为名词，如果注解中只有一个元素，请把名字起为value（后面使用会带来便利操作）；
（ )不是定义方法参数的地方，也不能在括号中定义任何参数，仅仅只是一个特殊的语法；
注解类可以没有成员，没有成员的注解称为标识注解
default代表默认值，值必须和第2点定义的类型一致；

2.元注解

2.1@Target注解，是专门用来限定某个自定义注解能够被应用在哪些Java元素上面的。它使用一个枚举类型定义如下：

public enum ElementType {
    /** 类，接口（包括注解类型）或枚举的声明 */
    TYPE,

    /** 属性的声明 */
    FIELD,

    /** 方法的声明 */
    METHOD,

    /** 方法形式参数声明 */
    PARAMETER,

    /** 构造方法的声明 */
    CONSTRUCTOR,

    /** 局部变量声明 */
    LOCAL_VARIABLE,

    /** 注解类型声明 */
    ANNOTATION_TYPE,

    /** 包的声明 */
    PACKAGE
}

//@CherryAnnotation被限定只能使用在类、接口或方法上面
@Target(value = {ElementType.TYPE,ElementType.METHOD})
public @interface CherryAnnotation {
    String name();
    int age() default 18;
    int[] array();
}

2.2@Retention注解，翻译为持久力、保持力。即用来修饰自定义注解的生命力。
注解的生命周期有三个阶段：1、Java源文件阶段；2、编译到class文件阶段；3、运行期阶段。同样使用了RetentionPolicy枚举类型定义了三个阶段：

public enum RetentionPolicy {
    /**
     * Annotations are to be discarded by the compiler.
     * （注解将被编译器忽略掉）
     */
    SOURCE,

    /**
     * Annotations are to be recorded in the class file by the compiler
     * but need not be retained by the VM at run time.  This is the default
     * behavior.
     * （注解将被编译器记录在class文件中，但在运行时不会被虚拟机保留，这是一个默认的行为）
     */
    CLASS,

    /**
     * Annotations are to be recorded in the class file by the compiler and
     * retained by the VM at run time, so they may be read reflectively.
     * （注解将被编译器记录在class文件中，而且在运行时会被虚拟机保留，因此它们能通过反射被读取到）
     * @see java.lang.reflect.AnnotatedElement
     */
    RUNTIME
}

注意：

如果一个注解被定义为RetentionPolicy.SOURCE，则它将被限定在Java源文件中，那么这个注解即不会参与编译也不会在运行期起任何作用，这个注解就和一个注释是一样的效果，只能被阅读Java文件的人看到；
如果一个注解被定义为RetentionPolicy.CLASS，则它将被编译到Class文件中，那么编译器可以在编译时根据注解做一些处理动作，但是运行时JVM（Java虚拟机）会忽略它，我们在运行期也不能读取到；
如果一个注解被定义为RetentionPolicy.RUNTIME，那么这个注解可以在运行期的加载阶段被加载到Class对象中。那么在程序运行阶段，我们可以通过反射得到这个注解，并通过判断是否有这个注解或这个注解中属性的值，从而执行不同的程序代码段。我们实际开发中的自定义注解几乎都是使用的RetentionPolicy.RUNTIME；
在默认的情况下，自定义注解是使用的RetentionPolicy.CLASS。

2.3 @Documented注解，是被用来指定自定义注解是否能随着被定义的java文件生成到JavaDoc文档当中。

2.4 @Inherited注解，是指表示当前注解可以由子注解来继承。@Inherited注解只对那些@Target被定义为ElementType.TYPE的自定义注解起作用。

3.使用自定义注解

格式：

@<注解名>(<成员1>=<值1>,<成员2>=<值2>)

@Description(desc="1234",name="ff",age=18)

4.解析注解

概念：通过反射获取类、函数或成员上运行时注解信息，从而实现动态控制程序运行的逻辑。