上篇文章简单的介绍了注解的2个基本属性;
了解了这2个基础的属性,加一点反射的知识就可以自定义一个简单的注解;这篇文章主要是介绍一下注解的另一些简单的东西:元注解,自定义注解@interface
用于注解 自定义注解 的注解。
指定注解的位置;target的值是一个数组类型,也就是说可以定义多个值;有多个值时,用{},每个值之间使用",";只有一个值时可以不用{}
@Documented @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.ANNOTATION_TYPE) public @interface Target { /** * Returns an array of the kinds of elements an annotation type * can be applied to. * @return an array of the kinds of elements an annotation type * can be applied to */ ElementType[] value(); }
@Retention(RetentionPolicy.RUNTIME) @Target({ElementType.FIELD,ElementType.TYPE}) public @interface MyAnno { boolean NOTNULL() default false; } @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.FIELD) public @interface MyAnno { boolean NOTNULL() default false; }
注解保留到什么时候,是定义注解的生命周期;
注解使用了@Documented的注解,在用过该注解的类中,用javadoc命令生成API文档后idea生成doc文档,文档中会显示注解信息;有点绕,下面直接看图;
自定义注解类使用:
@Retention(RetentionPolicy.RUNTIME) @Target(ElementType.FIELD) @Documented public @interface MyAnno { boolean NOTNULL() default false; }
用了@MyAnno 的类AnnoTest
public class AnnoTest { @MyAnno(NOTNULL = true) public String name; @MyAnno public String id; @MyAnno(NOTNULL = true) public int number; }
AnnoTest 生成的javadoc文档,自定义注解MyAnno使用@Documented和不使用@Documented的对比
继承性,当自定义注解注解@MyAnno使用了@Inherited ,使用过@MyAnno注解的类:Father,其子类Son可以获取到@MyAnno的信息;
可重复注解;什么意思呢?如果没有该注解,同一个地方不能重复出现2次及以上的该注解;
@MyAnno(NOTNULL = true) @MyAnno(NOTNULL = true) public String name; 如果MyAnno没有@Repeatable,这种写法就会报错, 在MyAnno上添加@Repeatable,这种写法就不会报错;
注解的本质其实是一个Annotation接口,所有的注解类都会继承这个接口;
也就是说注解中其实是可以有属性和方法,但是接口中的属性都是static final的,对于注解来说没什么意义,而我们定义接口的方法就相当于注解的属性;这也是为什么注解变量会有括号;
注解的属性类型: