详解JDK 5 Annotation 注解之@Target的用法介绍

前言

目前，越来越多的架构设计在使用注解，例如spring3.0、struts2等框架。让我们先来看看注解的定义。如下是一段使用了jdk 5 annotation @target的代码：

@target({elementtype.method})
@retention(retentionpolicy.runtime)
@inherited
@documented
public @interface asynlog {
 

} 

一、@target的用法

java.lang.annotation.target

用于设定注解使用范围

java.lang.annotation.elementtype

target通过elementtype来指定注解可使用范围的枚举集合

二、elementtype的用法

取值	注解使用范围
method	可用于方法上
type	可用于类或者接口上
annotation_type	可用于注解类型上（被@interface修饰的类型）
constructor	可用于构造方法上
field	可用于域上
local_variable	可用于局部变量上
package	用于记录java文件的package信息
parameter	可用于参数上

这里重点说明下：elementtype. package。它并不是使用在一般的类中，而是用在固定的文件package-info.java中。这里需要强调命名一定是“package-info”。由于package-info.java并不是一个合法的类，使用eclipse创建类的方式会提示不合法，所以需要以创建文件的方式来创建package-info.java。

例如，定义可使用范围package：

@target({elementtype.package,elementtype.method})
@retention(retentionpolicy.runtime)
@inherited
@documented
public @interface asynlog {
 
} 

那么，创建文件：package-info.java，内容如下：

@asynlog
package org.my.commons.logs.annotation;

重点说明：注解只能在elementtype设定的范围内使用，否则将会编译报错。例如：范围只包含elementtype.method ，则表明该注解只能使用在类的方法上，超出使用范围将编译异常。