学习书籍

JAVA编程思想(第四版)第20章

java SE5中引入的新特性之一，并在java.lang中内置了几种注解：

@Override 表示重写父类方法
@Deprecated 表示方法过期
@SuppressWarnings 关闭不当的编译器警号信息

基本语法

定义注解

@Target({ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Hi {
  int id();
}

注解的定义与java接口的定义很像，最终也会编译成class文件

元注解

@Target

表示注解可以使用的地方。可能的ElementType参数包括:

CONSTRUCTOR: 构造器声明
FIELD：属性声明
LOCAL_VARIABLE：局部变量声明
METHOD: 方法声明
PARAMETER：参数声明
PACKAGE：包声明
TYPE：类、接口或enum声明
ANNOTATION_TYPE: 注解声明

@Retention

表示在什么级别保存该注解信息。可选的RetentionPolicy参数包括：

SOURCE: 源码级别，将被编译器丢弃
CLASS: 注解在class文件中可用，但会被VM丢弃，此为默认级别
RUNTIME: VM运行期也保留，因此可通过反射机制读取注解的信息

@Documented

将此注解包含在Javadoc中

@Inherited

允许子类继承父类中的注解

编写注解处理器

# 使用注解
public class HiEntity {
  @Hi(id=22)
  public void tetst() {

  }
}

# 注解处理器
public class HiChecker {
  public static void checker(Class<?> cl) {
    for (Method m: cl.getDeclaredMethods()) {
      Hi hi = m.getAnnotation(Hi.class);
      if (hi != null) {
        System.out.println(hi.id());
      }
    }

  }
  public static void main(String[] args) {
    checker(HiEntity.class);
  }

注解元素

注解元素（属性）可用的类型如下:

所有基本类型（int、float、boolean等）
String
Class
enum
Annotation
以上类型的数组

如果使用其它类，编译会报错，也不能使用包装类型

默认值

注解的元素必须要具有值，要么元素必须有默认值，要么使用注解时必须指定值
非基本类型的元素，不可指定为null值，可自定义一些特殊的值，如空字符串或负数
属性名为value时，使用注解指定value值时可省略，如@XX('aa')等价@XX(value='aa'),指定多个属性时，都不能省略变量名