前言
目前,越來越多的架構設計在使用注解,例如spring3.0、struts2等框架。讓我們先來看看注解的定義。如下是一段使用了JDK 5 Annotation @Target的代碼:
1
2
3
4
5
6
7
8
|
@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:
1
2
3
4
5
6
7
|
@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 ,則表明該注解只能使用在類的方法上,超出使用范圍將編譯異常。