Java Annotation详解与应用

Annotation

百科名片

java.lang.annotation，接口 Annotation。对于Annotation，是Java5的新特性，JDK5引入了Metedata(元数据)很容易的就能够调用Annotations.Annotations提供一些本来不属于程序的数据，比如:一段代码的作者或者告诉编译器禁止一些特殊的错误。An annotation 对代码的执行没有什么影响。Annotations使用@annotation的形势应用于代码：类(class),属性(field),方法(method)等等。一个Annotation出现在上面提到的开始位置，而且一般只有一行,也可以包含有任意的参数。

目录

所有已知实现类
从以下版本开始
方法摘要
方法详细信息
覆盖
另请参见
返回
编辑本段
所有已知实现类

　　Deprecated, Documented, Inherited, Override, Retention, SuppressWarnings, Target
　　--------------------------------------------------------------------------------
　　public interface Annotation所有 annotation 类型都要扩展的公共接口。注意，手动扩展该公共接口的接口不 定义 annotation 类型。还要注意此接口本身不定义 annotation 类型。
　　对于Annotation，是Java5的新特性，下面是Sun的Tutorial的描述，因为是英文，这里我翻译下，希望能够比较清晰的描述一下Annotation的语法以及思想。Annotation:Release 5.0 of the JDK introduced a metadata facility called annotations. Annotations provide data about a program that is not part of the program, such as naming the author of a piece of code or instructing the compiler to suppress specific errors. An annotation has no effect on how the code performs. Annotations use the form @annotation and may be applied to a program's declarations: its classes, fields, methods, and so on. The annotation appears first and often (by convention) on its own line, and may include optional arguments: JDK5引入了Metedata(元数据)很容易的就能够调用Annotations.Annotations提供一些本来不属于程序的数据，比如:一段代码的作者或者告诉编译器禁止一些特殊的错误。An annotation 对代码的执行没有什么影响。Annotations使用@annotation的形势应用于代码：类(class),属性(field),方法(method)等等。一个Annotation出现在上面提到的开始位置，而且一般只有一行,也可以包含有任意的参数。@Author("MyName")class myClass() { }
　　or @SuppressWarnings("unchecked")void MyMethod() { }
　　Defining your own annotation is an advanced technique that won't be described here, but there are three built-in annotations that every Java programmer should know: @Deprecated, @Override, and @SuppressWarnings. The following example illustrates all three annotation types, applied to methods:
　　定义自己的Annotation是一个比较高级的技巧，这里我们不做讨论，这里我们仅仅讨论每一个Java programer都应该知道的内置的annotations:@Deprecated, @Override, and @SuppressWarnings。下面的程序阐述了这三种annotation如何应用于methods。import java.util.List;
　　class Food {}
　　class Hay extends Food {}
　　class Animal {
　　Food getPreferredFood() {
　　return null; } /** * @deprecated document why the method was deprecated */