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

  • 元注解
  • 自定义注解

注解修饰的范围

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

什么是元注解?(JDK 只提供4个)

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

分别是 @Target@Retention@Documented@Inherited

什么是自定义注解?

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

元注解详解

@Target:说明注解标记的对象,一般通过枚举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 {
    String value() default ""; // 设置注解 可传递的参数,默认值是 ""
}