自定义注解---元注解

深碍√TFBOYSˉ_ 2022-12-08 01:50 256阅读 0赞

# 定义注解 #

package com.jt.anno;
    
    import lombok.Builder;
    
    import java.lang.annotation.ElementType;
    import java.lang.annotation.Retention;
    import java.lang.annotation.RetentionPolicy;
    import java.lang.annotation.Target;
    //元注解
    @Retention(RetentionPolicy.RUNTIME) 
    @Target(ElementType.METHOD)
    public @interface CacheFind { 
    	String key();
    	int seconds() default 0;
    }

# 元注解 #

## @Target注解 ##

Target注解的作用是：描述注解的使用范围（即：被修饰的注解可以用在什么地方 。

Target注解用来说明那些被它所注解的注解类可修饰的对象范围：注解可以用于修饰 packages、types（类、接口、枚举、注解类）、类成员（方法、构造方法、成员变量、枚举值）、方法参数和本地变量（如循环变量、catch参数），在定义注解类时使用了@Target 能够更加清晰的知道它能够被用来修饰哪些对象，它的取值范围定义在ElementType 枚举中。

public enum ElementType { 
     
        TYPE, // 类、接口、枚举类
     
        FIELD, // 成员变量（包括：枚举常量）
     
        METHOD, // 成员方法
     
        PARAMETER, // 方法参数
     
        CONSTRUCTOR, // 构造方法
     
        LOCAL_VARIABLE, // 局部变量
     
        ANNOTATION_TYPE, // 注解类
     
        PACKAGE, // 可用于修饰：包
     
        TYPE_PARAMETER, // 类型参数，JDK 1.8 新增
     
        TYPE_USE // 使用类型的任何地方，JDK 1.8 新增
    }

## @Retention注解 ##

Reteniton注解的作用是：描述注解保留的时间范围（即：被描述的注解在它所修饰的类中可以被保留到何时） 。

Reteniton注解用来限定那些被它所注解的注解类在注解到其他类上以后，可被保留到何时，一共有三种策略，定义在RetentionPolicy枚举中。

public enum RetentionPolicy { 
     
        SOURCE,    // 源文件保留
        CLASS,       // 编译期保留，默认值
        RUNTIME   // 运行期保留，可通过反射去获取注解信息
    }

## @Documented注解 ##

Documented注解的作用是：描述在使用 javadoc 工具为类生成帮助文档时是否要保留其注解信息

## @Inherited注解 ##

Inherited注解的作用是：使被它修饰的注解具有继承性（如果某个类使用了被@Inherited修饰的注解，则其子类将自动具有该注解）