【ACCESS精品源码栏目提醒】:网学会员鉴于大家对ACCESS精品源码十分关注,论文会员在此为大家搜集整理了“java教程之JAVA_注解 - 其它资料”一文,供大家参考学习
JAVA 注解 在开发 Java 程序,尤其是 Java EE 应用的时候,总是免不了与各种配置文件打交道。
Java EE 中典型的 SpringStrutsHibernate架构来说, 以 Spring、Struts 和 Hibernate 这三个框架都有自己的 XML 格式的配置文件。
这些配置文件需要与 Java 源代码保存同步,否则的话就可能出现错误。
而且这些错误有可能到了运行时刻才被发现。
把同一份信息保存在两个地方,总是个坏的主意。
理想的情况是在一个地方维护这些信息就好了。
其它部分所需的信息则通过自动的方式来生成。
JDK 5 中引入了源代码中的注解annotation这一机制。
注解使得 Java 源代码中不但可以包含功能性的实现代码,还可以添加元数据。
注解的功能类似于代码中的注释,所不同的是注解不是提供代码功能的说明,而是实现程序功能的重要组成部分。
Java 注解已经在很多框架中得到了广泛的使用,用来简化程序中的配置。
使用注解 在一般的 Java 开发中,最常接触到的可能就是Override 和SupressWarnings 这两个注解了。
使用Override 的时候只需要一个简单的声明即可。
这种称为标记注解marker annotation ,它的出现就代表了某种配置语义。
而其它的注解是可以有自己的配置参数的。
配置参数以名值对的方式出现。
使用SupressWarnings 的时候需要类似SupressWarningsuncheck unused这样的语法。
在括号里面的是该注解可供配置的值。
由于这个注解只有一个配置参数,该参数的名称默认为 value,并且可以省略。
而花括号则表示是数组类型。
在 JPA 中的Table 注解使用类似Tablename Customerschema APP这样的语法。
从这里可以看到名值对的用法。
在使用注解时候的配置参数的值必须是编译时刻的常量。
从某种角度来说,可以把注解看成是一个 XML 元素,该元素可以有不同的预定义的属性。
而属性的值是可以在声明该元素的时候自行指定的。
在代码中使用注解,就相当于把一部分元数据从 XML 文件移到了代码本身之中,在一个地方管理和维护。
开发注解 在一般的开发中,只需要通过阅读相关的 API
文档来了解每个注解的配置参数的含义,并在代码中正确使用即可。
在有些情况下,可能会需要开发自己的注解。
这在库的开发中比较常见。
注解的定义有点类似接口。
下面的代码给出了一个简单的描述代码分工安排的注解。
通过该注解可以在源代码中记录每个类或接口的分工和进度情况。
以下是代码片段: RetentionRetentionPolicy.RUNTIME TargetElementType.TYPE public interface Assignment String assignee int effort double finished default 0 interface 用来声明一个注解,其中的每一个方法实际上是声明了一个配置参数。
方法的名称就是参数的名称,返回值类型就是参数的类型。
可以通过default 来声明参数的默认值。
在这里可以看到Retention 和Target 这样的元注解,用来声明注解本身的行为。
Retention 用来声明注解的保留策略,有 CLASS、RUNTIME 和 SOURCE 这三种,分别表示注解保存在类文件、JVM 运行时刻和
源代码中。
只有当声明为 RUNTIME 的时候,才能够在运行时刻通过反射 API 来获取到注解的信息。
Target 用来声明注解可以被添加在哪些类型的元素上,如类型、方法和域等。
处理注解 在
程序中添加的注解,可以在编译时刻或是运行时刻来进行处理。
在编译时刻处理的时候,是分成多趟来进行的。
如果在某趟处理中产生了新的
Java 源文件,那么就需要另外一趟处理来处理新生成的源文件。
如此往复,直到没有新文件被生成为止。
在完成处理之后,再对 Java 代码进行编译。
JDK 5 中提供了 apt工具用来对注解进行处理。
apt 是一个命令行工具,与之配套的还有一套用来描述程序语义结构的 Mirror API。
Mirror APIcom.sun.mirror.描述的是程序在编译时刻的静态结构。
通过 Mirror API 可以获取到被注解的 Java 类型元素的信息,从而提供相应的处理逻辑。
具体的处理
工作交给 apt 工具来完成。
编写注解处理器的核心是 AnnotationProcessorFactory 和 AnnotationProcessor 两个接口。
后者表示的是注解处理器,而前者则是为某些注解类型创建注解处理器的工厂。
以上面的注解 Assignment 为例,当每个开发人员都在源代码中更新进度的话,就可以通过一个注解处理器来生成一个项目整体进度的
报告。
首先是注解处理器工厂的实现。
以下是代码片段: public class AssignmentApf implements AnnotationProcessorFactory public AnnotationProcessor getProcessorForSet atds AnnotationProcessorEnvironment env if atds.isEmpty return AnnotationProcessors.NO_OP return new AssignmentApenv //返回注解处理器 public Collection supportedAnnotationTypes return Collections.