Java编程思想学习课时（七）第20章-注解

  注解（也被称为元数据）为我们在代码中添加信息提供了一种形式化的方法，使我们可以在稍后某个时刻非常方便地使用这些数据。

1 基本语法

  被注解的方法与其他的方法没有区别。注解可以与任何修饰符共同作用于方法，例如，public, static或void。从语法的角度来看，注解的使用方式几乎与修饰符的使用一模一样。

1.1 定义注解

  注解的定义看起来很像接口的定义。事实上，与其他任何Java接口一样，注解也将会编译成class文件。

  定义注解时会需要一些元注解（meta-annotation），如@Target，@Retention。

  在注解中，一般都会包含一些元素以表示某些值。当分析处理注解时，程序或工具可以利用这些值。注解的元素看起来就像接口的方法，唯一的区别是你可以为其指定默认值。元素的类型有限制。

  没有元素的注解称为标记注解（marker annotation）。

  所有注解都继承了annotation。

package net.mrliuli.annotations;import java.lang.annotation.*;@Target(ElementType.METHOD)@Retention(RetentionPolicy.RUNTIME)public @interface Test {} //(marker annotation)

1.2 三种标准注解和四种元注解

  定义在java.lang中的三种标准注解：

• @Overrided

• @Deprecated

• @SuppressWarnings

  四种元注解：

• @Target 表示该注解可以用于什么地方。

• @Retension 表示需要在什么级别保存该注解信息。

• @Documented 将此注解包含在Javadoc中。

• @Inherited 允许子类继承父类中的注解。

1.3 关于注解

• 注解元素的类型有限制，不可以是任意类型，使用除允许类型以外的类型编译器会报错。

• 默认值限制：

  @Target(ElementType.METHOD)@Retention(RetentionPolicy.RUNTIME)public @interface SimulationNull{
      public int id() default -1;    public String description() default "";
  }

• 首先，元素不能有不确定的值。也就是说，元素必须要么具有默认值，要么在使用注解时提供元素的值。

• 其次，对于非基本类型的元素，无论是在源代码中声明时，或是在注解接口中定义默认值时，都不能以null作为其值。这个约束使得注解处理器很难表现一个元素的存在或缺失的状态，因为在每个注解的声明中，所有的元素都存在，并且都具有相应的值。为了绕开这个约束，我们只能自己定义一些特殊的值例如空字符串或负数，以此表示某个元素不存在：

• 生成外部文件。有些framework需要一些额外的信息才能与你的源代码协同工作，而这种情况最适合注解表现其价值了。像Enterprise JavaBean这样的技术，需要部署描述文件。Web Service、自定义标签库以及对象/关系映射工具（如Toplink和Hibernate）等，一般都需要XML描述文件，而这些描述文件脱离于源代码之外。

2 编写注解处理器

  使用注解的过程中，很重要的一部分就是创建与使用注解处理器，用来读取注解。

• 反射机制的API可以构造注解处理器

• 外部工具apt可以解析带有注解的Java源代码

相关文章：

Java编程思想学习课时（五）第18章-Java IO系统

Java编程思想学习课时（六）第19章-枚举类型

以上是Java编程思想学习课时（七）第20章-注解的详细内容。更多信息请关注PHP中文网其他相关文章！