定义注解


Java语言使用@interface语法来定义注解(Annotation),它的格式如下:

  1. public @interface Report {
  2. int type() default 0;
  3. String level() default "info";
  4. String value() default "";
  5. }

注解的参数类似无参数方法,可以用default设定一个默认值(强烈推荐)。最常用的参数应当命名为value

元注解

有一些注解可以修饰其他注解,这些注解就称为元注解(meta annotation)。Java标准库已经定义了一些元注解,我们只需要使用元注解,通常不需要自己去编写元注解。

@Target

最常用的元注解是@Target。使用@Target可以定义Annotation能够被应用于源码的哪些位置:

  • 类或接口:ElementType.TYPE
  • 字段:ElementType.FIELD
  • 方法:ElementType.METHOD
  • 构造方法:ElementType.CONSTRUCTOR
  • 方法参数:ElementType.PARAMETER

例如,定义注解@Report可用在方法上,我们必须添加一个@Target(ElementType.METHOD)

  1. @Target(ElementType.METHOD)
  2. public @interface Report {
  3. int type() default 0;
  4. String level() default "info";
  5. String value() default "";
  6. }

定义注解@Report可用在方法或字段上,可以把@Target注解参数变为数组{ ElementType.METHOD, ElementType.FIELD }

  1. @Target({
  2. ElementType.METHOD,
  3. ElementType.FIELD
  4. })
  5. public @interface Report {
  6. ...
  7. }

实际上@Target定义的valueElementType[]数组,只有一个元素时,可以省略数组的写法。

@Retention

另一个重要的元注解@Retention定义了Annotation的生命周期:

  • 仅编译期:RetentionPolicy.SOURCE
  • 仅class文件:RetentionPolicy.CLASS
  • 运行期:RetentionPolicy.RUNTIME

如果@Retention不存在,则该Annotation默认为CLASS。因为通常我们自定义的Annotation都是RUNTIME,所以,务必要加上@Retention(RetentionPolicy.RUNTIME)这个元注解:

  1. @Retention(RetentionPolicy.RUNTIME)
  2. public @interface Report {
  3. int type() default 0;
  4. String level() default "info";
  5. String value() default "";
  6. }

@Repeatable

使用@Repeatable这个元注解可以定义Annotation是否可重复。这个注解应用不是特别广泛。

  1. @Repeatable(Reports.class)
  2. @Target(ElementType.TYPE)
  3. public @interface Report {
  4. int type() default 0;
  5. String level() default "info";
  6. String value() default "";
  7. }
  8. @Target(ElementType.TYPE)
  9. public @interface Reports {
  10. Report[] value();
  11. }

经过@Repeatable修饰后,在某个类型声明处,就可以添加多个@Report注解:

  1. @Report(type=1, level="debug")
  2. @Report(type=2, level="warning")
  3. public class Hello {
  4. }

@Inherited

使用@Inherited定义子类是否可继承父类定义的Annotation@Inherited仅针对@Target(ElementType.TYPE)类型的annotation有效,并且仅针对class的继承,对interface的继承无效:

  1. @Inherited
  2. @Target(ElementType.TYPE)
  3. public @interface Report {
  4. int type() default 0;
  5. String level() default "info";
  6. String value() default "";
  7. }

在使用的时候,如果一个类用到了@Report

  1. @Report(type=1)
  2. public class Person {
  3. }

则它的子类默认也定义了该注解:

  1. public class Student extends Person {
  2. }

如何定义Annotation

我们总结一下定义Annotation的步骤:

第一步,用@interface定义注解:

  1. public @interface Report {
  2. }

第二步,添加参数、默认值:

  1. public @interface Report {
  2. int type() default 0;
  3. String level() default "info";
  4. String value() default "";
  5. }

把最常用的参数定义为value(),推荐所有参数都尽量设置默认值。

第三步,用元注解配置注解:

  1. @Target(ElementType.TYPE)
  2. @Retention(RetentionPolicy.RUNTIME)
  3. public @interface Report {
  4. int type() default 0;
  5. String level() default "info";
  6. String value() default "";
  7. }

其中,必须设置@Target@Retention@Retention一般设置为RUNTIME,因为我们自定义的注解通常要求在运行期读取。一般情况下,不必写@Inherited@Repeatable

小结

Java使用@interface定义注解:

可定义多个参数和默认值,核心参数使用value名称;

必须设置@Target来指定Annotation可以应用的范围;

应当设置@Retention(RetentionPolicy.RUNTIME)便于运行期读取该Annotation

读后有收获可以支付宝请作者喝咖啡:

定义注解 - 图1