自定义annotation
先看一个注解实例:
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
/*-----------------定义注解--------------------*/
@Retention(RetentionPolicy.SOURCE)//声明注释保留时长
@Target(ElementType.METHOD)//声明可以使用此注解的元素级别类型(如类、方法变量等)
@Documented//表示当标注了NeedRecord注解的对象在被javadoc生成文档时,NeedRecord注解将会被API文档记录
public @interface NeedRecord {//定义注解
String userName() default "anonymous";//定义注解成员,同时用default声明默认值,如果不想声明默认值,去掉default部分即可
String value() ;
}
/*------------------使用注解实例1-----------------*/
@NeedRecord("login")
public void login(){
System.out.println("I'm zenghao ,I'm logining");
}
/*------------------使用注解实例2-----------------*/
@NeedRecord(userName = "zenghao",value = "login")
public void login(){
System.out.println("I'm zenghao ,I'm logining");
}
除了程序中注释提到的细节外,还有几点是需要注意的:
1. 使用注解的格式为@注解名(key1 = value1,key2 = value2 …..),当以@注解名(thisValue)来标注注解时,thisValue默认对应与注解内的value属性,如果注解内未定义value属性,则会编译出错。
2. 注解属性不能有入参(如value(name)
),也不能声明异常(如value() throws Exception
)
3. 属性的类型只能为原始类型及其包装类或相应的数组类型,不能是自定义类型,如声明MyClass myClass()
;则会出现编译错误Invalid type MyClass for the annotation attribute NeedRecord.myClass; only primitive type, String, Class, annotation, enumeration are permitted or 1-dimensional arrays thereof
元注解
上面实例中我们用到的@Retention,@Target,@Documented都是Java预定义的元注解,他们只能在我们自定义注解的时候使用,下面来分析分析这些注解的用法。
1. @Retention
用于声明我们自定义的注解的存活时间,它的属性value有三个对应的值
1. RetentionPolicy.SOURCE:在编译阶段丢弃。这些注解在编译结束之后就不再有任何意义,所以它们不会写入字节码。@Override, @SuppressWarnings都属于这类注解。
2. RetentionPolicy.CLASS:默认值,编译器仅把注解保存在class文件中,在运行java程序时,JVM不会保留注释,即不能用反射(在运行期)来获取注释
3. RetentionPolicy.RUNTIME:编译器不仅把注解保存在class文件中,同时在运行java程序时,JVM也会保留注释,即可以通过反射来获取注释
2. @Target
用于指定自定义的注解能够修饰哪些元素,其value属性指明了注解对象,有如下几个值供选择:
- ElementType.TYPE:修饰类、接口或枚举(enum)
- ElementType.FIELD:注解成员变量
- ElementType.METHOD:注解方法
- ElementType.PARAMETER:注解方法参数
- ElementType.CONSTRUCTOR:注解构造函数
- ElementType.LOCAL_VARIABLE :注解局部变量
- ElementType.ANNOTATION_TYPE 注解另一个自定义注解
- ElementType.PACKAGE 注解包
3. @Documented
比如注解A被标注@Documented,B被A标注,则用javadoc对B类生成API文档时,在类声明上会出现注解A记录。