Java元数据总结：Java注释的使用和定义

核心提示： @Target 表示该注释可以用于什么地方，可用的ElementType参数包括：CONSTRUCTOR : 构造器的声明FIELD : 域声明（包括enum实例）LOCAL_VARIABLE : 局部变量声明METHOD : 方法声明PACKAGE : 包声明PARAMETER : 参数声明T

@Target　　 表示该注释可以用于什么地方。可用的ElementType参数包括：

CONSTRUCTOR : 构造器的声明

FIELD : 域声明（包括enum实例）

LOCAL_VARIABLE : 局部变量声明

METHOD : 方法声明

PACKAGE : 包声明

PARAMETER : 参数声明

TYPE : 类、接口 （包括注解类型) 或enum声明

@Retention 表示需要在什么级别保存该注释信息。可选的RetentionPoicy参数包括：

SOURCE : 注释将被编译器丢掉

CLASS : 注释在class文件中可用，但会被VM丢弃

RUNTIME : VM将在运行时也保留注释，因此可以通过反射机制读取注释的信息。

@Documented 将注释包含在JavaDoc中

@Inheried　 允许子类继承父类中的注释。

3. 在Java中定义自己的注释

Java语言支持一种新的类型——注释类型（annotation type），跟普通类差不多，在类中以符号（ @ ）的形式注释其他 Java 代码

下面将通过一个简单的例子来实现（代码是Brett McLaughlin 的）

@interface 申明

i.简单的注释类型

package　com.oreilly.tiger.ch06;　　
/**　　
　*　Marker　annotation　to　indicate　that　a　method　or　class　　
　*　is　still　in　progress.　　
　*/　
public　@interface　InProgress　{　}　　

ii.使用定制的注释类型

@com.oreilly.tiger.ch06.InProgress　　
public　void　calculateInterest(float　amout,float　rate)　　
{　　
　　　　　　//Need　to　finish　this　method　later　　
}　　

iii.添加成员

package　com.oreilly.tiger.ch06;　　
/**　　
　*　Marker　annotation　to　indicate　that　a　method　or　class　　
　*　is　still　in　progress.　　
　*/　
public　@interface　InProgress　{　　
　　String　value();　　　
　}　　
　
@com.oreilly.tiger.ch06.InProgress　　
@TODO("Figure　out　the　amount　of　interest　per　month")　　
//或者@TODO(value="Figure　out　the　amount　of　interest　per　month")　　
public　void　calculateInterest(float　amount,float　rate)　　
{　　
}　　

iv.设置默认值

package　com.oreilly.tiger.ch06;　　
public　@interface　GroupTODO　{　　
　　public　enum　Serverity　{　CRITICAL,IMPORTANT,IRIVIAL,DOCMENTATION　};　　
　　Severity　severity()　　
　　　　　　　　　　default　Severity.IMPORTANT;　　
　　String　item　();　　
　　String　assignedTo();　　
　　String　dateAssigned();　　
}　　
}　　

v.使用默认值

@com.oreilly.tiger.ch06.InProgress　　
@GroupTODO(　　
　item="Figure　out　the　amount　of　interest　per　month",　　
　assignedTo　=　"Brett　McLaughlin",　　
　dateAssigned　=　"08/04/2004"　
)　　
　
public　void　calculateInterest(float　amount,　float　rate)　　
{　　
　　　//Need　to　finish　this　method　later　　
}　　

vi.改写默认值

@com.oreilly.tiger.ch06.InProgress　　
@GroupTODO　
{　　
　　　severity　=　GroupTODO.Severity.DOCUMENTATION,　　
　　　item　=　"Need　to　explain　how　this　rather　unusal　method　works",　　
　　　assignedTo　=　"Jon　Stevens",　　
　　　dateAssigned　=　"07/30/2004"　
}　

这样就对Java元数据/Java注释进行了总结。