Spring（二）注释详解（@Target,@Retention,@Documented）

╰+攻爆jí腚メ 2022-03-11 08:19 232阅读 0赞

要深入学习spring就要定义自己的注解，并使用注解，在定义自己的注解之前，我们必须要了解Java为我们提供的元注解和相关定义注解的语句

1、元注解（meta-annotation）:

元注解的作用就是负责注解其他注解，Java5定义了元注解类型，他们被用来提供对其它annotation类型做说明。

*  @Target
 *  @Retention
 *  @Documented

这些类型和它们所支持的类在java.lang.annotation包中可以找到。

1.1、@Target（用于描述注解的适用范围 \{被描述的注解可以用在什么地方\}）

@Target说明了Annotation所修饰的对象范围：Annotation可用于 packages、type（类、接口、枚举、Annotation类型）、类型成员（方法、构造方法、成员变量、枚举值）、方法参数和本地变量（如循环变量、catch参数）。

取值（ElementType）：

ElementType.CONSTRUCTOR：用于描述构造器。

ElementType.FLELD：用于描述域

ElementType.LOCAL\_VARIABLE:用于描述局部变量

ElementType.METHOD:用于描述方法

ElementType.PACKAGE:用于描述包

ElementType.PARAMETER:用于描述参数

ElementType.TYPE:用于描述类、接口(包括注解类型) 或enum声明

使用示例：

@Target({ ElementType.PARAMETER, ElementType.METHOD })
    public @interface Log
    {
      
    }

**@Retention（表示需要在什么级别保存该注释信息，用于描述注解的声明周期\{被描述的注解在什么范围内有效\}）**

**       @Retention**定义了该 Annotation  被保留的时间长短：某些 Annotation 仅出现在源代码中，而被编译器丢弃；而另一些却被编译在class文件中；编译在class文件中Annotation可能会被虚拟机忽略，而另一些在class被装载时将被读取（并不影响class的执行，因为Annotation与class在使用上被分离的）。使用这个meta-Annotation 可以对 Annotation 的“生命周期”限制

**            取值（RetentionPoicy）：**

**                   ** RetentionPoicy.SOURCE:在源文件中有效（即源文件保留）

RetentionPoicy.CLASS:在class文件中有效（即class保留）

RetentionPoicy.RUNTIME:在运行时有效（即运行时保留）

Retention meta-annotation类型有唯一的value作为成员，它的取值来自java.lang.annotation.RetentionPolicy的枚举类型值。具体实例如下：

@Target({ ElementType.PARAMETER, ElementType.METHOD })
    @Retention(RetentionPolicy.RUNTIME)
    public @interface Log
    {
       
    }

Column注解的RetentionPolicy的属性值是RUTIME,这样注解处理器可以通过反射，获取到该注解的属性值，从而去做一些运行时的逻辑处理

**@Documented（用于描述其他类型的annotation应该被做为被标注的程序成员的公告Api）:**

**          @**Documented 可以被例如 javadoc此类的工具文档化，Documented是一个标注注解，没有成员

@Target({ ElementType.PARAMETER, ElementType.METHOD })
    @Retention(RetentionPolicy.RUNTIME)
    @Documented
    public @interface Log
    {
       
    }