【面試加分項】java自訂註解之申明註解

標籤：註解   java   

之前的部落格http://blog.csdn.net/u010590685/article/details/47029447介紹了java的註解的基本知識今天我們學習如何使用自訂註解。
首先我們要聲明一個註解，聲明代碼如下：

import java.lang.annotation.Documented;import java.lang.annotation.ElementType;import java.lang.annotation.Inherited;import java.lang.annotation.Retention;import java.lang.annotation.RetentionPolicy;import java.lang.annotation.Target;@Target(ElementType.TYPE)//註解的作用範圍，就是註解是用在什麼地方的@Retention(RetentionPolicy.RUNTIME)//註解的層級，就是註解能留存到什麼時候@Documented@Inheritedpublic @interface MyAnnaation {    public String value();//註解可以接收的參數}

在我們聲明的註解上面有四個註解他們分別是幹嘛的呢？

@Target：

　　　@Target說明了Annotation所修飾的物件範圍：Annotation可被用於 packages、types（類、介面、枚舉、Annotation類型）、類型成員（方法、構造方法、成員變數、枚舉值）、方法參數和本地變數（如迴圈變數、catch參數）。在Annotation類型的聲明中使用了target可更加明晰其修飾的目標。

　　作用：用於描述註解的使用範圍（即：被描述的註解可以用在什麼地方）

　　取值(ElementType)有：

　　　　1.CONSTRUCTOR:用於描述構造器
　　　　2.FIELD:用於描述域
　　　　3.LOCAL_VARIABLE:用於描述局部變數
　　　　4.METHOD:用於描述方法
　　　　5.PACKAGE:用於描述包
　　　　6.PARAMETER:用於描述參數
　　　　7.TYPE:用於描述類、介面(包括註解類型) 或enum聲明

@Retention：

　　@Retention定義了該Annotation被保留的時間長短：某些Annotation僅出現在原始碼中，而被編譯器丟棄；而另一些卻被編譯在class檔案中；編譯在class檔案中的Annotation可能會被虛擬機器忽略，而另一些在class被裝載時將被讀取（請注意並不影響class的執行，因為Annotation與class在使用上是被分離的）。使用這個meta-Annotation可以對 Annotation的“生命週期”限制。

　　作用：表示需要在什麼層級儲存該注釋資訊，用於描述註解的生命週期（即：被描述的註解在什麼範圍內有效）

　　取值（RetentionPoicy）有：

　　　　1.SOURCE:在源檔案中有效（即源檔案保留）
　　　　2.CLASS:在class檔案中有效（即class保留）
　　　　3.RUNTIME:在運行時有效（即運行時保留）
　　

@Documented:

　　@Documented用於描述其它類型的annotation應該被作為被標註的程式成員的公用API，因此可以被例如javadoc此類的工具文檔化。Documented是一個標記註解，沒有成員。

@Inherited：

　　@Inherited 元註解是一個標記註解，@Inherited闡述了某個被標註的類型是被繼承的。如果一個使用了@Inherited修飾的annotation類型被用於一個class，則這個annotation將被用於該class的子類。
　　注意：介面和方法上的註解不能被繼承

接下來我們再來看看註解可以接受的參數類型,在上面的代碼中我們只有一個參數，這兒我們要注意一定當只有一個參數是參數的名稱預設為value，這樣當我們再使用時可以不用謝參數名，直接傳入，具體我們之後再討論。下面我們看參數的類型：
　　　　1.所有基礎資料型別 (Elementary Data Type)（int,float,boolean,byte,double,char,long,short)
　　　　2.String類型
　　　　3.Class類型
　　　　4.enum類型
　　　　5.Annotation類型
　　　　6.以上所有類型的數組
好了註解的申明就到這兒，下一回我們將討論註解申明之後我們如何?自己想要的功能。到時候需要用到java的反射機制，感興趣的同學可以先瞭解一下。

著作權聲明：本文為博主原創文章，轉載請註明來源

【面試加分項】java自訂註解之申明註解