注解介绍

讲到 注解 我们就必须知道 在Java世界中，注解的分类。

• 元注解
• 自定义注解

注解修饰的范围

注解用来修饰，类、方法、变量、参数、包

什么是元注解？（JDK 只提供4个）

一般我们把元注解理解为描述注解的注解，元数据理解为描述数据的数据，元类理解为描述类的类…

元注解分别是 @Target、@Retention、@Documented、@Inherited。

什么是自定义注解？

除了4个元注解，其余的所有注解，都叫自定义注解

元注解详解

@Target：说明注解标记的对象，一般通过枚举ElementType 选值

ElementType枚举可选的值有：

• CONSTRUCTOR: 用于描述构造器
• FIELD: 用于描述域
• LOCAL_VARIABLE: 用于描述局部变量
• METHOD: 用于描述方法，大白话就是，可以修饰在方法上
• PACKAGE: 用于描述包
• PARAMETER: 用于描述参数
• TYPE: 用于描述类、接口(包括注解类型) 或enum声明，大白话就是能修饰在类、接口、枚举上，其他方法上不可用！

案例

@Target(ElementType.TYPE)   // 设置 只能修饰在类上

@Target(ElementType.METHOD) // 注解 此 注解 只能注解在方法上

@Target({ElementType.TYPE,ElementType.METHOD}) //多个注解，用数组形式 含义是：该注解标记在类上、方法上

@Retention：用于描述注解的生命周期（即：被描述的注解在什么范围内有效）一般通过枚举 RetentionPoicy获取

• SOURCE: 在源文件中有效（即源文件保留）
• CLASS: 在class文件中有效（即class保留）
• RUNTIME: 在运行时有效（即运行时保留）

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

@Documented: 指明修饰的注解，可以被例如javadoc此类的工具文档化，只负责标记，没有成员取值。

代码实现自定义注解

步骤：

使用 @Interface 定义一个注解

使用反射包 reflections 获得被标记的所有类，以及执行它们被标记的方法

        <dependency>
            <groupId>org.reflections</groupId>
            <artifactId>reflections</artifactId>
            <version>0.9.11</version>
        </dependency>

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

@Target({ElementType.TYPE,ElementType.METHOD}) //多个注解，用数组形式 含义是：该注解标记在类上、方法上
@Retention(RetentionPolicy.RUNTIME) //设置作用时间
public @interface DiyAnno {
    @AliasFor("name") // 注解起别名，将来指定任意一个值，相当于同时赋值多个！
    String value() default ""; // 设置注解 可传递的参数，默认值是 ""

    @AliasFor("value")
    String name() default "";
}

注意，注解我们一般需要是@DiyAnno、@DiyAnno()或者@DiyAnno(value = "abc")，当注解属性为value可省略！切记。直接可用@DiyAnno("abc")。否则我们必须指定注解的参数值！如@DiyAnno(value = "abc")