目录
一、@Target
用于指定被修饰的自定义注解只能用于修饰程序中哪些元素,该元注解有如下属性值:
1、ElementType.ANNOTATION_TYPE:应用于其他注解的元注解
2、ElementType.CONSTRUCTOR:应用于构造函数
3、ElementType.FIELD:应用于全局属性
4、ElementType.LOCAL_VARIABLE:应用于方法中的本地变量
5、ElementType.METHOD:应用于方法
6、ElementType.PACKAGE:应用于包
7、ElementType.PARAMETER:应用于方法的参数
8、ElementType.TYPE:应用于类、接口或者枚举声明
自定义@SuppressWarnings注解,限制该注解只能用于修饰属性、方法
二、@Retention
用于指定被修饰的自定义注解可以保留多久,该元注解有如下属性值:
1、RetentionPolicy.SOURCE:编译器将直接丢弃被修饰的注解。
2、RetentionPolicy.CLASS:默认值,编译器将把注解记录在class文件中,当运行Java程序时,虚拟机不再保留注解;
3、RetentionPolicy.RUNTIME:编译器将把注解记录在class文件中,当运行java程序时,虚拟机保留注解,程序可以通过反射获取该注解;
三、@Documented
执行javadoc命令时,被该元注解修饰的自定义注解也会生成在文档中,如下例:
Eclipse中进行如下操作:
1、选中java工程鼠标右键点击“Export…”,出现下图:
3、在上图红框处输入javadoc点击“Next >”按钮,出现下图:
说明:如果@Documented元注解没有修饰前面Override自定义注解,则生成的文档不会有如上图红框框起的部分。
四、@Inherited
如果父类所使用的注解有@Inherited修饰,则子类可以继承该注解,否则不能继承。
五、@Repeatable
所修饰的自定义注解可以重复在同一类、方法或变量上使用。
代码3的等效(非“同”)于如下代码:
代码3等同(非“效”)于如下代码: