注解介绍

讲到 注解 我们就必须知道 在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")

特殊说明:
上述文章均是作者实际操作后产出。烦请各位,请勿直接盗用!转载记得标注原文链接:www.zanglikun.com
第三方平台不会及时更新本文最新内容。如果发现本文资料不全,可访问本人的Java博客搜索:标题关键字。以获取全部资料 ❤