注解
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;
}