注解

注解

import org.junit.Test;
import java.lang.annotation.*;
import java.util.ArrayList;
import static java.lang.annotation.ElementType.*;

/*
自定义Annotation
使用 @interface 关键字声明。
如果只有一个参数成员，建议使用value，指定初始值可使用default关键字。
自定义注解自动继承了java.lang.annotation.Annotation接口。
没有成员定义的 Annotation 称为标记; 包含成员变量的 Annotation 称为元数据 Annotation。
成员变量以无参数方法的形式来声明。其方法名和返回值定义了该成员的名字和类型，称为配置参数。
如果定义的注解含有配置参数，那么使用时必须指定参数值，除非它有默认值,
 格式是“参数名 = 参数值”，如果只有一个参数成员，且名称为value，可以省略“value=” 。
注意：自定义注解必须配上注解的信息处理流程（反射）才有意义。

元注解:修饰注解的注解
@Retention:用于指定注解的生命周期
    RetentionPolicy.SOURCE:在源文件中有效
    RetentionPolicy.CLASS:在class文件中有效
    RetentionPolicy.RUNTIME:在运行时有效
@Target：用于指定能用于修饰哪些程序元素
    TYPE,               //类,接口(包括注解类型), 或枚举声明
    FIELD,              //属性声明(包括枚举常量)
    METHOD,             //方法声明
    PARAMETER,          //正式的参数声明
    CONSTRUCTOR,        //构造器声明
    LOCAL_VARIABLE,     //局部变量声明
    ANNOTATION_TYPE,    //注解类型声明
    PACKAGE,            //包声明
    TYPE_PARAMETER,     //类型参数声明
    TYPE_USE            //类型的使用
@Documented：用于指定能被javadoc工具提取成文档。默认情况下，javadoc是不包括注解的，使用时Retention值必须为RUNTIME
@@Inherited：被它修饰的将具有继承性，其子类将自动具有该注解。
 */
//自定义Annotation
@Repeatable(MyAnnotations.class)
@Inherited
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ANNOTATION_TYPE,FIELD,TYPE,METHOD,CONSTRUCTOR,TYPE_PARAMETER,TYPE_USE})
public @interface MyAnnotation {
    String value() default "hello";
}
//自定义注解使用，value没有默认值时必须赋值，否则报错
@MyAnnotation("HiHi")
class Person{
}
@MyAnnotation()
class Student{
    //利用反射获取注解信息
    @Test
    public static void test(){
        Class clazz = Student.class;
        Annotation[] annotations = clazz.getAnnotations();
        for (int i = 0; i < annotations.length; i++) {
            System.out.println(annotations[i]);
        }
    }
}

@Inherited
@Retention(RetentionPolicy.RUNTIME)
@Target({ANNOTATION_TYPE,FIELD,TYPE,METHOD,CONSTRUCTOR})
//jdk8新特性，可重复注解：MyAnnotation的@Retention和@Target的值与 MyAnnotations相同
@interface MyAnnotations{
    MyAnnotation[] value();
}
//jdk8新特性，可重复注解示例
@MyAnnotation("hi")
@MyAnnotation("hello")
//jdk8新特性，类型注解：ElementType.TYPE_PARAMETER
class Generic<@MyAnnotation T>{
    //jdk8新特性，类型注解：ElementType.TYPE_USE
    ArrayList<@MyAnnotation String> list = new ArrayList<>();
    int num = (@MyAnnotation int) 10l;

}