自定义注解 @Target @Retention 参数含义

示例：

@Target(value = {ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {

    long time() default 2L;

}

 

@Target 注解

功能：指明了修饰的这个注解的使用范围，即被描述的注解可以用在哪里。

ElementType的取值包含以下几种： 

ElementType.TYPE //类，接口或者枚举

ElementType.FIELD //域，包含枚举常量

ElementType.METHOD //方法

ElementType.PARAMETER //参数

ElementType.CONSTRUCTOR //构造方法

ElementType.LOCAL_VARIABLE //局部变量

ElementType.ANNOTATION_TYPE //注解类型

ElementType.PACKAGE //包

ElementType.TYPE_PARAMETER //类型参数声明(1.8)

ElementType.TYPE_USE //使用类型(1.8)

 

@Retention 注解

功能：指明修饰的注解的生存周期，即会保留到哪个阶段。

RetentionPolicy的取值包含以下三种：

RetentionPolicy.SOURCE //源码级别保留，编译后即丢弃。

RetentionPolicy.CLASS //编译级别保留，编译后的class文件中存在，在jvm运行时丢弃，这是默认值。

RetentionPolicy.RUNTIME // 运行级别保留，编译后的class文件中存在，在jvm运行时保留，可以被反射调用。

 

@Documented 注解

功能：指明修饰的注解，可以被例如javadoc此类的工具文档化，只负责标记，没有成员取值。

 

@Inherited注解

功能：允许子类继承父类中的注解。