java在自定义注解的时候常用到上面的三个注解,下面简单记录一下分别的作用。
@Documented : 该注解的作用就是在生产文档的时候,保留自定义注解的存在,例如:
javadoc -d doc Test.java ; 如果Test.java中有自定义的注解,然后该注解上面有@Documented,那么生成的文档中就会包含自定义注解部分,反之就没有。
@Retention : 定义自定义注解存在的时间节点在哪里;java文件大致的时间节点是:
.java文件 --> 被编译为.class文件 --〉被jvm加载的.class文件
@Retention 注解中有三个值: RetentionPolicy.SOURCE ;RetentionPolicy.CLASS; RetentionPolicy.RUNTIME; 分别对应上面的三个时间节点,过了该时间节点,对应的注解就不存在了或者说无作用了
@Target : 定义注解使用的位置,也是一些枚举值;
@Target(ElementType.TYPE)——接口、类、枚举、注解
@Target(ElementType.FIELD)——类的属性、枚举的常量
@Target(ElementType.METHOD)——方法
@Target(ElementType.PARAMETER)——方法参数
@Target(ElementType.CONSTRUCTOR) ——构造函数
@Target(ElementType.LOCAL_VARIABLE)——局部变量
@Target(ElementType.ANNOTATION_TYPE)——注解
@Target(ElementType.PACKAGE)——包