JAVA注解学习笔记

学习书籍

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'),指定多个属性时，都不能省略变量名