java 注解,從名字上看是注釋,解釋。但功能卻不僅僅是注釋那麼簡單。注解(Annotation) 為我們在代碼中添加資訊提供了一種形式化的方法,是我們可以在稍後 某個時刻友善地使用這些資料(通過 解析注解 來使用這些資料),常見的作用有以下幾種:
1.生成文檔。這是最常見的,也是java 最早提供的注解。常用的有@see @param @return 等;
2.跟蹤代碼依賴性,實作替代配置檔案功能。比較常見的是spring 2.5 開始的基于注解配置。作用就是減少配置。現在的架構基本都使用了這種配置來減少配置檔案的數量;
3.在編譯時進行格式檢查。如@Override放在方法前,如果你這個方法并不是覆寫了超類方法,則編譯時就能檢查出;
包 java.lang.annotation 中包含所有定義自定義注解所需用到的原注解和接口。如接口 java.lang.annotation.Annotation 是所有注解繼承的接口,并且是自動繼承,不需要定義時指定,類似于所有類都自動繼承Object。
該包同時定義了四個元注解,Documented,Inherited,Target(作用範圍,方法,屬性,構造方法等),Retention(生命範圍,源代碼,class,runtime)。下面将在執行個體中逐個講解他們的作用,及使用方法。
Inherited : 在您定義注解後并使用于程式代碼上時,預設上父類别中的注解并不會被繼承至子類别中,您可以在定義注解時加上java.lang.annotation.Inherited 限定的Annotation,這讓您定義的Annotation型别被繼承下來。注意注解繼承隻針對class 級别注解有效(這段建議看完全文後在來回顧)。 多說無益,下面就一步步從零開始建一個我們自己的注解。
建立第一個注解
package com.tmser.annotation;
public @interface TestA {
//這裡定義了一個空的注解,它能幹什麼呢。我也不知道,但他能用。
}
在下面這個程式中使用它:
import java.util.HashMap;
import java.util.Map;
@TestA //使用了類注解
public class UserAnnotation {
@TestA //使用了類成員注解
private Integer age;
@TestA //使用了構造方法注解
public UserAnnotation(){
}
@TestA //使用了類方法注解
public void a(){
@TestA //使用了局部變量注解
Map m = new HashMap(0);
public void b(@TestA Integer a){ //使用了方法參數注解
編譯沒有報錯,ok,一個注解實驗完成。這個注解也太簡單了吧,好像什麼資訊也不能傳遞。别急下面就來一步步完善它,也該四位元注解依次開始上場了。
四個元注解分别是:@Target,@Retention,@Documented,@Inherited ,再次強調下元注解是java API提供,是專門用來定義注解的注解,其作用分别如下:
@Target 表示該注解用于什麼地方,可能的值在枚舉類 ElemenetType 中,包括:
ElemenetType.CONSTRUCTOR----------------------------構造器聲明
ElemenetType.FIELD --------------------------------------域聲明(包括 enum 執行個體)
ElemenetType.LOCAL_VARIABLE------------------------- 局部變量聲明
ElemenetType.METHOD ----------------------------------方法聲明
ElemenetType.PACKAGE --------------------------------- 包聲明
ElemenetType.PARAMETER ------------------------------參數聲明
ElemenetType.TYPE--------------------------------------- 類,接口(包括注解類型)或enum聲明
@Retention 表示在什麼級别儲存該注解資訊。可選的參數值在枚舉類型 RetentionPolicy 中,包括:
RetentionPolicy.SOURCE ---------------------------------注解将被編譯器丢棄
RetentionPolicy.CLASS -----------------------------------注解在class檔案中可用,但會被VM丢棄
RetentionPolicy.RUNTIME VM-------将在運作期也保留注釋,是以可以通過反射機制讀取注解的資訊。
@Documented 将此注解包含在 javadoc 中 ,它代表着此注解會被javadoc工具提取成文檔。在doc文檔中的内容會因為此注解的資訊内容不同而不同。相當與@see,@param 等。
@Inherited 允許子類繼承父類中的注解。
學習最忌好高骛遠,最重要的還是動手實踐,我們就一個一個來實驗。
第一個:@Target,動手在前面我們編寫的注解上加上元注解。
import java.lang.annotation.ElementType;
import java.lang.annotation.Target;
@Target(ElementType.PACKAGE) //與前面定義的注解不同的地方,這裡使用了元注解Target
ctrl+ s 儲存,今天電腦比較給力,我們的測試類那邊立馬出現了一堆錯誤,除了類注解。我想到這,聰明的你立刻明白了這個元注解的意義了。是不是想當然的偷起懶來了。?難道還有意外?細心的朋友應該發現了,我們的測試類少了一個屬性沒用,就是ElemenetType.PACKAGE。在我們的注解加上這個屬性的元注解後,我們測試程式的元注解全部陣亡,不對,還有一個沒加呢,好加上。package 包,想當然是加載 package 前面。即
@TestA package com.tmser.annotation;
什麼也報錯。這就搞不明白了,不加在這加哪去呢。我也不知道了,不過這是編譯錯誤,我們的eclipse 将錯誤給我們指出了,就是Package annotations must be in file package-info.java ,e 文雖然不好,但這個簡單的還是難不倒幾個人的,package 注解必須定義在 package-info.java 中。package-info 又是什麼東西,好了為節省你們的時間幫你百度好了(在另一篇我的另一篇博文裡面,自己找吧,咔咔)。ok,到此 target 元注解就全部完成了。
第二個元注解: @Retention 參數 RetentionPolicy。有了前面的經驗這個注解了解起來就簡單多了,并且幸運的是這個注解還沒有特殊的屬性值。 簡單示範下如何使用:
@Target(ElementType.PACKAGE)
@Retention(RetentionPolicy.RUNTIME)
第三和第四個元注解就不再舉例了。比較簡單,也沒有值,相信看過上面的解釋也就清楚了。下面我們還是繼續來深入的探讨下注解的使用。上面的例子都非常簡單,注解連屬性都沒有。ok,下面我們就來定義一個有屬性的注解,并在例子程式中擷取都注解中定義的值。
開始之前将下定義屬性的規則:
@interface用來聲明一個注解,其中的每一個方法實際上是聲明了一個配置參數。方法的名稱就是參數的名稱,傳回值類型就是參數的類型(傳回值類型隻能是基本類型、Class、String、enum)。可以通過default來聲明參數的預設值。
代碼:
@Target({TYPE,METHOD,FIELD,CONSTRUCTOR})
String name();
int id() default 0;
Class gid();
下面改下我們的測試類:
@TestA(name="type",gid=Long.class) //類成員注解
@TestA(name="param",id=1,gid=Long.class) //類成員注解
private Integer age;
@TestA (name="construct",id=2,gid=Long.class)//構造方法注解
public UserAnnotation(){
@TestA(name="public method",id=3,gid=Long.class) //類方法注解
public void a(){
Map m = new HashMap(0);
@TestA(name="protected method",id=4,gid=Long.class) //類方法注解
protected void b(){
@TestA(name="private method",id=5,gid=Long.class) //類方法注解
private void c(){
public void b(Integer a){
下面到了最重要的一步了,就是如何讀取我們在類中定義的注解。隻要讀取出來了使用的話就簡單了。
import java.lang.annotation.Annotation;
import java.lang.reflect.Constructor;
import java.lang.reflect.Method;
public class ParseAnnotation {
public static void parseTypeAnnotation() throws ClassNotFoundException {
Class clazz = Class.forName("com.tmser.annotation.UserAnnotation");
Annotation[] annotations = clazz.getAnnotations();
for (Annotation annotation : annotations) {
TestA testA = (TestA)annotation;
System.out.println("id= ""+testA.id()+""; name= ""+testA.name()+""; gid = "+testA.gid());
}
}
public static void parseMethodAnnotation(){
Method[] methods = UserAnnotation.class.getDeclaredMethods();
for (Method method : methods) {
boolean hasAnnotation = method.isAnnotationPresent(TestA.class);
if (hasAnnotation) {
TestA annotation = method.getAnnotation(TestA.class);
System.out.println("method = " + method.getName()
+ " ; id = " + annotation.id() + " ; description = "
+ annotation.name() + "; gid= "+annotation.gid());
}
public static void parseConstructAnnotation(){
Constructor[] constructors = UserAnnotation.class.getConstructors();
for (Constructor constructor : constructors) {
boolean hasAnnotation = constructor.isAnnotationPresent(TestA.class);
TestA annotation =(TestA) constructor.getAnnotation(TestA.class);
System.out.println("constructor = " + constructor.getName()
public static void main(String[] args) throws ClassNotFoundException {
parseTypeAnnotation();
parseMethodAnnotation();
parseConstructAnnotation();
先别說話,運作:
id= "0"; name= "type"; gid = class java.lang.Long
method = c ; id = 5 ; description = private method; gid= class java.lang.Long
method = a ; id = 3 ; description = public method; gid= class java.lang.Long
method = b ; id = 4 ; description = protected method; gid= class java.lang.Long
constructor = com.tmser.annotation.UserAnnotation ; id = 2 ; description = construct; gid= class java.lang.Long
看到了吧,我們定義的注解都完整的輸出了,你要使用哪個,直接拿去用就好了。
為了不讓這篇文章打開太慢,我省略了類屬性注解,及參數注解的解析。其實都大同小異。
另外,我也沒有舉使用例子。因為我認為好的教程是講的詳細的同時,還會留有擴充。如果我全部寫出來,而你隻是學習的話,那基本不會自己去動腦了,而是複制粘貼運作一遍完事。
最後提醒下:
1. 要用好注解,必須熟悉java 的反射機制,從上面的例子可以看出,注解的解析完全依賴于反射。
2. 不要濫用注解。平常我們程式設計過程很少接觸和使用注解,隻有做設計,且不想讓設計有過多的配置時
這個網址可以給你參考一些注解的例子:http://blog.sina.com.cn/s/blog_7540bf5f0100t3mv.html
本文轉自 h2appy 51CTO部落格,原文連結:http://blog.51cto.com/h2appy/1784054,如需轉載請自行聯系原作者