Java注解

元注解分为@Retention、@Documented、@Target、@Inherited、@Repeatable 5 种。
    @Retention 作用域（作用的阶段）：
        RetentionPolicy.SOURCE 注解只在源码阶段保留，在编译器进行编译时它将被丢弃忽视。
        RetentionPolicy.CLASS 注解只被保留到编译进行的时候，它并不会被加载到 JVM 中。
        RetentionPolicy.RUNTIME 注解可以保留到程序运行的时候，它会被加载进入到 JVM 中，所以在程序运行时可以获取到它们
    @Documented 将注解中的元素包含到 Javadoc 中去
    @Target 作用在成员属性上（比如注解上，成员属性上，构造方法上，局部变量上等）
        ElementType.ANNOTATION_TYPE 可以给一个注解进行注解
        ElementType.CONSTRUCTOR 可以给构造方法进行注解
        ElementType.FIELD 可以给属性进行注解
        ElementType.LOCAL_VARIABLE 可以给局部变量进行注解
        ElementType.METHOD 可以给方法进行注解
        ElementType.PACKAGE 可以给一个包进行注解
        ElementType.PARAMETER 可以给一个方法内的参数进行注解
        ElementType.TYPE 可以给一个类型进行注解，比如类、接口、枚举
    @Inherited 标注该注解可以被其它注解继承
    @Repeatable 可重复的标注
        结合代码解释
        @interface Persons {
            Person[]  value();
        }
        @Repeatable(Persons.class)
        @interface Person{
            String role default "";
        }
        @Person(role="artist")
        @Person(role="coder")
        @Person(role="PM")
        public class SuperMan{
        }
        
        注意上面的代码，@Repeatable 注解了 Person。而 @Repeatable 后面括号中的类相当于一个容器注解。
        什么是容器注解呢？就是用来存放其它注解的地方。它本身也是一个注解。
        我们再看看代码中的相关容器注解。
        @interface Persons {
            Person[]  value();
        }
        按照规定，它里面必须要有一个 value 的属性，属性类型是一个被 @Repeatable 注解过的注解数组，注意它是数组。
        如果不好理解的话，可以这样理解。Persons 是一张总的标签，上面贴满了 Person 这种同类型但内容不一样的标签。把 Persons 给一个 SuperMan 贴上，相当于同时给他贴了程序员、产品经理、画家的标签
注解的属性
    注解的属性也叫做成员变量。注解只有成员变量，没有方法。注解的成员变量在注解的定义中以“无形参的方法”形式来声明，其方法名定义了该成员变量的名字，其返回值定义了该成员变量的类型。

    @Target(ElementType.TYPE)
    @Retention(RetentionPolicy.RUNTIME)
    public @interface TestAnnotation {
        int id();
        String msg();
    }
    
    上面代码定义了 TestAnnotation 这个注解中拥有 id 和 msg 两个属性。在使用的时候，我们应该给它们进行赋值。
    
    赋值的方式是在注解的括号内以 value=”” 形式，多个属性之前用 ，隔开。
    
    @TestAnnotation(id=3,msg="hello annotation")
    public class Test {
    }
    
    需要注意的是，在注解中定义属性时它的类型必须是 8 种基本数据类型外加 类、接口、注解及它们的数组。
    
    注解中属性可以有默认值，默认值需要用 default 关键值指定。比如：
    
    @Target(ElementType.TYPE)
    @Retention(RetentionPolicy.RUNTIME)
    public @interface TestAnnotation {
        public int id() default -1;
        public String msg() default "Hi";
    }
    
    TestAnnotation 中 id 属性默认值为 -1，msg 属性默认值为 Hi。
    它可以这样应用。
    
    @TestAnnotation()
    public class Test {}
    
    因为有默认值，所以无需要再在 @TestAnnotation 后面的括号里面进行赋值了，这一步可以省略。
    
    另外，还有一种情况。如果一个注解内仅仅只有一个名字为 value 的属性时，应用这个注解时可以直接接属性值填写到括号内。
    
    public @interface Check {
        String value();
    }
    
    上面代码中，Check 这个注解只有 value 这个属性。所以可以这样应用。
    
    @Check("hi")
    int a;
    
    这和下面的效果是一样的
    
    @Check(value="hi")
    int a;
    
    最后，还需要注意的一种情况是一个注解没有任何属性。比如
    
    public @interface Perform {}
    
    那么在应用这个注解的时候，括号都可以省略。
    
    @Perform
    public void testMethod(){}

通过java注解-最通俗易懂的讲解_java 注解-CSDN整理所得