读书人

Java Annotation引见

发布时间: 2012-06-27 14:20:09 作者: rapoo

Java Annotation介绍
Java Annotation是Sun公司自JDK 1.5版本以来推出的一个新的语言特性,中文可以将其翻译成Java标记。什么是标记特性呢?如果你使用Java编写过一些程序,那么你可能已经接触过这一特性了。比如JavaDoc语法中使用的@return,@param这些就是Java标记。又比如说,大家经常用到的用来抑制Java编译器警告信息的@SuppressWarning标记,以及标识某方法或某类过期的@Deprecated标记。从Java 1.5版本开始,用户可以自已制作各种标记。

使用标记的好处是什么呢?最大的好处就是这一特性使得代码之间的耦合度变得非常之低。那么Annotation到底如何制作,如何使用?下面我们来亲自动手做一个自己的Annotation来玩玩看。

实例
我们来做一个图书数据管理的项目。在这个项目中,有图书类Book,每一本书都有自己的书名bookname。除书名外,图书还有附加的版权信息Copyright,但是出于设计角度考虑,版权这个属性由出版社定义,它与书本身的关系不大,因此不想做成Book的一个属性信息。因此把Copyright独立设计成一个类,然后嵌入到Book类中去。如果使用传统的方法,那么Copyright类将成为Book的一个私有成员:



由于我们定义Copyright的Retention类别为RUNTIME,因此在程序的逻辑中应该能够通过Java所提供Clazz.getAnnotations()方法取到Book中的Copyright信息。运行这个代码得到:



运行结果如下:



在这个例子中,我们在UseBookV3类中定义了两个Book的实例:book及book2。由于CopyrightV2的作用域FIELD恰恰是用来标记类中的成员,因此我们分别对book和book2进行了各自独立的标记声明。然后在主程序中,从UseBookV3的实例ub中取得类中的所有变量,java提供的getDeclaredFields()方法可以实现这一目的。当系统找到ub的两个成员book及book2后,把它们所包含的标记及其值打印出来,程序具体输出如下:

fields found.interface CopyrightV2value: All Rights Reservedfields found.interface CopyrightV2value: GNU Public License


小结
我们这次学习了标记的概念,并亲身体会了标记的制作过程及使用方法。使用这一特性,我们将类与类之间的耦合度大大降低,为系统设计达到OCP的标准提供了强有力的工具。

读书人网 >开源软件

热点推荐