java註解

from url: http://yelinsen.iteye.com/blog/1051772

註解(Annotation) 爲我們在代碼中天界信息提供了一種形式化的方法,是我們可以在稍後

某個時刻方便地使用這些數據(通過 解析註解 來使用這些數據)。

    註解的語法比較簡單,除了@符號的使用以外,它基本上與java的固有語法一致,java內置了三種

註解,定義在java.lang包中。

      @Override 表示當前方法是覆蓋父類的方法。

      @Deprecated 表示當前元素是不贊成使用的。

      @SuppressWarnings 表示關閉一些不當的編譯器警告信息。

下面是一個定義註解的實例

Java代碼
package Test_annotation; 

import java.lang.annotation.Documented; 
import java.lang.annotation.Inherited; 
import java.lang.annotation.Retention; 
import java.lang.annotation.Target; 
import java.lang.annotation.ElementType; 
import java.lang.annotation.RetentionPolicy; 

/*
* 元註解@Target,@Retention,@Documented,@Inherited

*     @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 中
*     
*     @Inherited 允許子類繼承父類中的註解
*   
*/
@Target(ElementType.METHOD) 
@Retention(RetentionPolicy.RUNTIME) 
@Documented
@Inherited
/*
* 定義註解 Test
* 註解中含有兩個元素 id 和 description
* description 元素 有默認值 "no description"
*/
public @interface Test { 
    public int id(); 
    public String description() default "no description"; 
}
package Test_annotation;

import java.lang.annotation.Documented;
import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
import java.lang.annotation.Target;
import java.lang.annotation.ElementType;
import java.lang.annotation.RetentionPolicy;

/*
* 元註解@Target,@Retention,@Documented,@Inherited
*
*     @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 中
*   
*     @Inherited 允許子類繼承父類中的註解

*/
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
/*
* 定義註解 Test
* 註解中含有兩個元素 id 和 description
* description 元素 有默認值 "no description"
*/
public @interface Test {
public int id();
public String description() default "no description";
}

  
下面是一個使用註解 和 解析註解的實例

Java代碼
package Test_annotation; 

import java.lang.reflect.Method; 

public class Test_1 { 
    /*
     * 被註解的三個方法
     */
    @Test(id = 1, description = "hello method_1") 
    public void method_1() { 
    } 

    @Test(id = 2) 
    public void method_2() { 
    } 

    @Test(id = 3, description = "last method") 
    public void method_3() { 
    } 

    /*
     * 解析註解,將Test_1類 所有被註解方法 的信息打印出來
     */
    public static void main(String[] args) { 
        Method[] methods = Test_1.class.getDeclaredMethods(); 
        for (Method method : methods) { 
            /*
             * 判斷方法中是否有指定註解類型的註解
             */
            boolean hasAnnotation = method.isAnnotationPresent(Test.class); 
            if (hasAnnotation) { 
                /*
                 * 根據註解類型返回方法的指定類型註解
                 */
                Test annotation = method.getAnnotation(Test.class); 
                System.out.println("Test( method = " + method.getName() 
                        + " , id = " + annotation.id() + " , description = "
                        + annotation.description() + " )"); 
            } 
        } 
    } 

}
package Test_annotation;

import java.lang.reflect.Method;

public class Test_1 {
/*
* 被註解的三個方法
*/
@Test(id = 1, description = "hello method_1")
public void method_1() {
}

@Test(id = 2)
public void method_2() {
}

@Test(id = 3, description = "last method")
public void method_3() {
}

/*
* 解析註解,將Test_1類 所有被註解方法 的信息打印出來
*/
public static void main(String[] args) {
   Method[] methods = Test_1.class.getDeclaredMethods();
   for (Method method : methods) {
    /*
    * 判斷方法中是否有指定註解類型的註解
    */
    boolean hasAnnotation = method.isAnnotationPresent(Test.class);
    if (hasAnnotation) {
     /*
     * 根據註解類型返回方法的指定類型註解
     */
     Test annotation = method.getAnnotation(Test.class);
     System.out.println("Test( method = " + method.getName()
       + " , id = " + annotation.id() + " , description = "
       + annotation.description() + " )");
    }
   }
}

}

  
輸出結果如下:


    Test( method = method_1 , id = 1 , description = hello method_1 )
    Test( method = method_2 , id = 2 , description = no description )
    Test( method = method_3 , id = 3 , description = last method )


Annotation在java的世界正鋪天蓋地展開,有空寫這一篇簡單的annotations的文章,算是關於Annotation入門的文章吧,希望能各位們能拋磚,共同學習......
   不講廢話了,實踐纔是硬道理.

   第一部分:瞭解一下java1.5起默認的三個annotation類型:
   一個是@Override:只能用在方法之上的,用來告訴別人這一個方法是改寫父類的。
   一個是@Deprecated:建議別人不要使用舊的API的時候用的,編譯的時候會用產生警告信息,可以設定在程序裏的所有的元素上.
   一個是@SuppressWarnings:這一個類型可以來暫時把一些警告信息消息關閉.
   如果不清楚上面三個類型的具體用法,各位可以baidu或google一下的,很簡單的。

   第二部分:講一下annotation的概念先,再來講一下怎樣設計自己的annotation.
   首先在jdk自帶的java.lang.annotation包裏,打開如下幾個源文件:
 
   1、源文件Target.java
Java代碼 複製代碼

   1. @Documented 
   2. @Retention(RetentionPolicy.RUNTIME)  
   3. @Target(ElementType.ANNOTATION_TYPE)  
   4. public @interface Target {  
   5.    ElementType[] value();  
   6. } 

   @Documented
   @Retention(RetentionPolicy.RUNTIME)
   @Target(ElementType.ANNOTATION_TYPE)
   public @interface Target {
      ElementType[] value();
   }


 
   其中的@interface是一個關鍵字,在設計annotations的時候必須把一個類型定義爲@interface,而不能用class或interface關鍵字(會不會覺得sun有點吝嗇,偏偏搞得與interface這麼像).
 
   2、源文件Retention.java
Java代碼 複製代碼

   1. @Documented 
   2. @Retention(RetentionPolicy.RUNTIME)  
   3. @Target(ElementType.ANNOTATION_TYPE)  
   4. public @interface Retention {  
   5.    RetentionPolicy value();  
   6. } 

   @Documented
   @Retention(RetentionPolicy.RUNTIME)
   @Target(ElementType.ANNOTATION_TYPE)
   public @interface Retention {
      RetentionPolicy value();
   }



   看到這裏,大家可能都模糊了,都不知道在說什麼,別急,往下看一下.
   在上面的文件都用到了RetentionPolicy,ElementType這兩個字段,你可能就會猜到這是兩個java文件.的確,這兩個文件的源代碼如下:
 
   3、源文件RetentionPolicy.java
Java代碼 複製代碼

   1. public enum RetentionPolicy {  
   2.  SOURCE,  
   3.  CLASS,  
   4.  RUNTIME  
   5. } 

    public enum RetentionPolicy {
     SOURCE,
     CLASS,
     RUNTIME
    }


   這是一個enum類型,共有三個值,分別是SOURCE,CLASS 和 RUNTIME.
   SOURCE代表的是這個Annotation類型的信息只會保留在程序源碼裏,源碼如果經過了編譯之後,Annotation的數據就會消失,並不會保留在編譯好的.class文件裏面。
   ClASS的意思是這個Annotation類型的信息保留在程序源碼裏,同時也會保留在編譯好的.class文件裏面,在執行的時候,並不會把這一些信 息加載到虛擬機(JVM)中去.注意一下,當你沒有設定一個Annotation類型的Retention值時,系統默認值是CLASS.
   第三個,是RUNTIME,表示在源碼、編譯好的.class文件中保留信息,在執行的時候會把這一些信息加載到JVM中去的.
  舉一個例子,如@Override裏面的Retention設爲SOURCE,編譯成功了就不要這一些檢查的信息;相反,@Deprecated裏面的 Retention設爲RUNTIME,表示除了在編譯時會警告我們使用了哪個被Deprecated的方法,在執行的時候也可以查出該方法是否被 Deprecated.


   4、源文件ElementType.java
Java代碼 複製代碼

   1. public enum ElementType {  
   2.  TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR,  
   3.  LOCAL_VARIABLE, ANNOTATION_TYPE,PACKAGE  
   4. } 

   public enum ElementType {
    TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR,
    LOCAL_VARIABLE, ANNOTATION_TYPE,PACKAGE
   }


   @Target裏面的ElementType是用來指定Annotation類型可以用在哪一些元素上的.說明一下:TYPE(類型), FIELD(屬性), METHOD(方法), PARAMETER(參數), CONSTRUCTOR(構造函數),LOCAL_VARIABLE(局部變量), ANNOTATION_TYPE,PACKAGE(包),其中的TYPE(類型)是指可以用在Class,Interface,Enum和 Annotation類型上.
   另外,從1的源代碼可以看出,@Target自己也用了自己來聲明自己,只能用在ANNOTATION_TYPE之上.
   如果一個Annotation類型沒有指明@Target使用在哪些元素上,那麼它可以使用在任何元素之上,這裏的元素指的是上面的八種類型.
   舉幾個正確的例子:
   @Target(ElementType.METHOD)
   @Target(value=ElementType.METHOD)
   @Target(ElementType.METHOD,ElementType.CONSTRUCTOR) 
   具體參考一下javadoc文檔
 
   上面一下1和2的源文件,它們都使用了@Documented,@Documented的目的就是讓這一個Annotation類型的信息能夠顯示在 javaAPI說明文檔上;沒有添加的話,使用javadoc生成API文檔的時候就會找不到這一個類型生成的信息.
   另外一點,如果需要把Annotation的數據繼承給子類,那麼就會用到@Inherited這一個Annotation類型.
 
   第三部分:下面講的設計一個最簡單的Annotation例子,這一例子共用四個文件;
   1、Description.java
Java代碼 複製代碼

   1. package lighter.javaeye.com;  
   2.  
   3. import java.lang.annotation.Documented;  
   4. import java.lang.annotation.ElementType;  
   5. import java.lang.annotation.Retention;  
   6. import java.lang.annotation.RetentionPolicy;  
   7. import java.lang.annotation.Target;  
   8.  
   9. @Target(ElementType.TYPE)  
  10. @Retention(RetentionPolicy.RUNTIME)  
  11. @Documented 
  12. public @interface Description {  
  13.     String value();  
  14. } 

   package lighter.javaeye.com;

   import java.lang.annotation.Documented;
   import java.lang.annotation.ElementType;
   import java.lang.annotation.Retention;
   import java.lang.annotation.RetentionPolicy;
   import java.lang.annotation.Target;

   @Target(ElementType.TYPE)
   @Retention(RetentionPolicy.RUNTIME)
   @Documented
   public @interface Description {
       String value();
   }


 
   說明:所有的Annotation會自動繼承java.lang.annotation這一個接口,所以不能再去繼承別的類或是接口.
   最重要的一點,Annotation類型裏面的參數該怎麼設定:
   第一,只能用public或默認(default)這兩個訪問權修飾.例如,String value();這裏把方法設爲defaul默認類型.
   第二,參數成員只能用基本類型byte,short,char,int,long,float,double,boolean八種基本數據類型和 String,Enum,Class,annotations等數據類型,以及這一些類型的數組.例如,String value();這裏的參數成員就爲String.
   第三,如果只有一個參數成員,最好把參數名稱設爲"value",後加小括號.例:上面的例子就只有一個參數成員.

   2、Name.java
Java代碼 複製代碼

   1. package lighter.javaeye.com;  
   2.  
   3. import java.lang.annotation.Documented;  
   4. import java.lang.annotation.ElementType;  
   5. import java.lang.annotation.Retention;  
   6. import java.lang.annotation.RetentionPolicy;  
   7. import java.lang.annotation.Target;  
   8.  
   9.  //注意這裏的@Target與@Description裏的不同,參數成員也不同  
  10. @Target(ElementType.METHOD)  
  11. @Retention(RetentionPolicy.RUNTIME)  
  12. @Documented 
  13. public @interface Name {  
  14.     String originate();  
  15.     String community();  
  16. } 

   package lighter.javaeye.com;

   import java.lang.annotation.Documented;
   import java.lang.annotation.ElementType;
   import java.lang.annotation.Retention;
   import java.lang.annotation.RetentionPolicy;
   import java.lang.annotation.Target;

    //注意這裏的@Target與@Description裏的不同,參數成員也不同
   @Target(ElementType.METHOD)
   @Retention(RetentionPolicy.RUNTIME)
   @Documented
   public @interface Name {
       String originate();
       String community();
   }



   3、JavaEyer.java
Java代碼 複製代碼

   1. package lighter.javaeye.com;  
   2.  
   3. @Description("javaeye,做最棒的軟件開發交流社區")  
   4. public class JavaEyer {  
   5.     @Name(originate="創始人:robbin",community="javaEye")  
   6.     public String getName()  
   7.     {  
   8.         return null;  
   9.     }  
  10.       
  11.     @Name(originate="創始人:江南白衣",community="springside")  
  12.     public String getName2()  
  13.     {  
  14.         return "借用兩位的id一用,寫這一個例子,請見諒!";  
  15.     }  
  16. } 

package lighter.javaeye.com;

@Description("javaeye,做最棒的軟件開發交流社區")
public class JavaEyer {
@Name(originate="創始人:robbin",community="javaEye")
public String getName()
{
return null;
}

@Name(originate="創始人:江南白衣",community="springside")
public String getName2()
{
return "借用兩位的id一用,寫這一個例子,請見諒!";
}
}


   4、最後,寫一個可以運行提取JavaEyer信息的類TestAnnotation
Java代碼 複製代碼

   1.  package lighter.javaeye.com;  
   2.  
   3.   import java.lang.reflect.Method;  
   4.   import java.util.HashSet;  
   5.   import java.util.Set;  
   6.  
   7.   public class TestAnnotation {  
   8.     /** 
   9.      * author lighter 
  10.      * 說明:具體關天Annotation的API的用法請參見javaDoc文檔 
  11.      */ 
  12.        public static void main(String[] args) throws Exception {  
  13.        String  CLASS_NAME = "lighter.javaeye.com.JavaEyer";  
  14.        Class  test = Class.forName(CLASS_NAME);  
  15.        Method[] method = test.getMethods();  
  16.        boolean flag = test.isAnnotationPresent(Description.class);  
  17.         if(flag)  
  18.         {  
  19.             Description des = (Description)test.getAnnotation(Description.class);  
  20.             System.out.println("描述:"+des.value());  
  21.             System.out.println("-----------------");  
  22.         }  
  23.           
  24.         //把JavaEyer這一類有利用到@Name的全部方法保存到Set中去  
  25.         Set<Method> set = new HashSet<Method>();  
  26.         for(int i=0;i<method.length;i++)  
  27.         {  
  28.             boolean otherFlag = method[i].isAnnotationPresent(Name.class);  
  29.             if(otherFlag) set.add(method[i]);  
  30.         }  
  31.         for(Method m: set)  
  32.         {  
  33.             Name name = m.getAnnotation(Name.class);  
  34.             System.out.println(name.originate());  
  35.             System.out.println("創建的社區:"+name.community());  
  36.         }  
  37.      }  
  38. } 

package lighter.javaeye.com;

  import java.lang.reflect.Method;
  import java.util.HashSet;
  import java.util.Set;

  public class TestAnnotation {
/**
* author lighter
* 說明:具體關天Annotation的API的用法請參見javaDoc文檔
*/
       public static void main(String[] args) throws Exception {
       String  CLASS_NAME = "lighter.javaeye.com.JavaEyer";
       Class  test = Class.forName(CLASS_NAME);
       Method[] method = test.getMethods();
       boolean flag = test.isAnnotationPresent(Description.class);
        if(flag)
        {
        Description des = (Description)test.getAnnotation(Description.class);
        System.out.println("描述:"+des.value());
        System.out.println("-----------------");
        }
       
        //把JavaEyer這一類有利用到@Name的全部方法保存到Set中去
        Set<Method> set = new HashSet<Method>();
        for(int i=0;i<method.length;i++)
        {
        boolean otherFlag = method[i].isAnnotationPresent(Name.class);
        if(otherFlag) set.add(method[i]);
        }
        for(Method m: set)
        {
        Name name = m.getAnnotation(Name.class);
        System.out.println(name.originate());
        System.out.println("創建的社區:"+name.community());
        }
     }
}


    5、運行結果:
     描述:javaeye,做最棒的軟件開發交流社區
     -----------------
    創始人:robbin
    創建的社區:javaEye
    創始人:江南白衣
     創建的社區:springside

Java註解(Annotation)
Annotation(註釋)是JDK5.0及以後版本引入的。它可以用於創建文檔,跟蹤代碼中的依賴性,甚至執行基本編譯時檢查。註釋是以‘@ 註釋名’在代碼中存在的,根據註釋參數的個數,我們可以將註釋分爲:標記註釋、單值註釋、完整註釋三類。它們都不會直接影響到程序的語義,只是作爲註釋 (標識)存在,我們可以通過反射機制編程實現對這些元數據的訪問。另外,你可以在編譯時選擇代碼裏的註釋是否只存在於源代碼級,或者它也能在class文 件中出現。
元數據的作用
如果要對於元數據的作用進行分類,目前還沒有明確的定義,不過我們可以根據它所起的作用,大致可分爲三類:
編寫文檔:通過代碼裏標識的元數據生成文檔。
代碼分析:通過代碼裏標識的元數據對代碼進行分析。
編譯檢查:通過代碼裏標識的元數據讓編譯器能實現基本的編譯檢查。
1. 基本內置註釋
@Override
Java代碼
package com.iwtxokhtd.annotation;
/**
* 測試Override註解
* @author Administrator
*
*/
public class OverrideDemoTest {

//@Override
public String tostring(){
return "測試註釋";
}
}
@Deprecated的作用是對不應該在使用的方法添加註釋,當編程人員使用這些方法時,將會在編譯時顯示提示信息,它與javadoc裏的 @deprecated標記有相同的功能,準確的說,它還不如javadoc @deprecated,因爲它不支持參數,使用@Deprecated的示例代碼示例如下:
Java代碼
package com.iwtxokhtd.annotation;
/**
* 測試Deprecated註解
* @author Administrator
*
*/
public class DeprecatedDemoTest {
public static void main(String[] args) {
//使用DeprecatedClass裏聲明被過時的方法
DeprecatedClass.DeprecatedMethod();
}
}
class DeprecatedClass{
@Deprecated
public static void DeprecatedMethod() {    
}
}
@SuppressWarnings,其參數有:
deprecation,使用了過時的類或方法時的警告
unchecked,執行了未檢查的轉換時的警告
fallthrough,當 Switch 程序塊直接通往下一種情況而沒有 Break 時的警告
path,在類路徑、源文件路徑等中有不存在的路徑時的警告
serial,當在可序列化的類上缺少 serialVersionUID 定義時的警告
finally ,任何 finally 子句不能正常完成時的警告
all,關於以上所有情況的警告
Java代碼
package com.iwtxokhtd.annotation;
import java.util.ArrayList;
import java.util.List;
public class SuppressWarningsDemoTest {
public static List list=new ArrayList();
@SuppressWarnings("unchecked")
public void add(String data){
list.add(data);
}
}
2. 自定義註釋
它類似於新創建一個接口類文件,但爲了區分,我們需要將它聲明爲@interface,如下例:
Java代碼
package com.iwtxokhtd.annotation;
public @interface NewAnnotation {
}
使用自定義的註釋類型
Java代碼
package com.iwtxokhtd.annotation;
public class AnnotationTest {
@NewAnnotation
public static void main(String[] args) {
}
}
爲自定義註釋添加變量
Java代碼
package com.iwtxokhtd.annotation;
public @interface NewAnnotation {
String value();
}
Java代碼
public class AnnotationTest {
@NewAnnotation("main method")
public static void main(String[] args) {
saying();
}
@NewAnnotation(value = "say method")
public static void saying() {
}
}
定義一個枚舉類型,然後將參數設置爲該枚舉類型,並賦予默認值
public @interface Greeting {
public enum FontColor {
BLUE, RED, GREEN
};
String name();
FontColor fontColor() default FontColor.RED;
}
這裏有兩種選擇,其實變數也就是在賦予默認值的參數上,我們可以選擇使用該默認值,也可以重新設置一個值來替換默認值
Java代碼
public class AnnotationTest {
@NewAnnotation("main method")
public static void main(String[] args) {
saying();
sayHelloWithDefaultFontColor();
sayHelloWithRedFontColor();
}

@NewAnnotation("say method")
public static void saying() {
}

// 此時的fontColor爲默認的RED
@Greeting(name = "defaultfontcolor")
public static void sayHelloWithDefaultFontColor() {
}

// 現在將fontColor改爲BLUE
@Greeting(name = "notdefault", fontColor = Greeting.FontColor.BLUE)
public static void sayHelloWithRedFontColor() {
}
}
3. 註釋的高級應用
3.1. 限制註釋的使用範圍
用@Target指定ElementType屬性
Java代碼(jdk)
package java.lang.annotation;  
public enum ElementType {  
TYPE,  
// 用於類,接口,枚舉但不能是註釋
FIELD,  
// 字段上,包括枚舉值 
METHOD,  
// 方法,不包括構造方法
PARAMETER,  
// 方法的參數
CONSTRUCTOR,  
//構造方法
LOCAL_VARIABLE,  
// 本地變量或catch語句
ANNOTATION_TYPE,  
// 註釋類型(無數據) 
PACKAGE  
// Java包 

3.2. 註解保持性策略
Java代碼
//限制註解使用範圍
@Target({ElementType.METHOD,ElementType.CONSTRUCTOR})
public @interface Greeting {
//使用枚舉類型
public enum FontColor{
BLUE,RED,GREEN
};
String name();
FontColor fontColor() default FontColor.RED;
}
在Java編譯器編譯時,它會識別在源代碼裏添加的註釋是否還會保留,這就是RetentionPolicy。下面是Java定義的RetentionPolicy枚舉:
編譯器的處理有三種策略:
將註釋保留在編譯後的類文件中,並在第一次加載類時讀取它
將註釋保留在編譯後的類文件中,但是在運行時忽略它
按照規定使用註釋,但是並不將它保留到編譯後的類文件中
Java代碼

package java.lang.annotation;  
public enum RetentionPolicy {  
SOURCE,  
// 此類型會被編譯器丟棄 
CLASS,  
// 此類型註釋會保留在class文件中,但JVM會忽略它 
RUNTIME  
// 此類型註釋會保留在class文件中,JVM會讀取它  

Java代碼
//讓保持性策略爲運行時態,即將註解編碼到class文件中,讓虛擬機讀取
@Retention(RetentionPolicy.RUNTIME)
public @interface Greeting {
//使用枚舉類型
public enum FontColor{
BLUE,RED,GREEN
};
String name();
FontColor fontColor() default FontColor.RED;
}
3.3. 文檔化功能
Java提供的Documented元註釋跟Javadoc的作用是差不多的,其實它存在的好處是開發人員可以定製Javadoc不支持的文檔屬性,並在開發中應用。它的使用跟前兩個也是一樣的,簡單代碼示例如下:
Java代碼
//讓它定製文檔化功能
//使用此註解時必須設置RetentionPolicy爲RUNTIME
@Documented
public @interface Greeting {
//使用枚舉類型
public enum FontColor{
BLUE,RED,GREEN
};
String name();
FontColor fontColor() default FontColor.RED;
}
3.4. 標註繼承
Java代碼
//讓它允許繼承,可作用到子類
@Inherited
public @interface Greeting {

//使用枚舉類型
public enum FontColor{
BLUE,RED,GREEN
};
String name();
FontColor fontColor() default FontColor.RED;
}
4. 讀取註解信息
屬於重點,在系統中用到註解權限時非常有用,可以精確控制權限的粒度
注意: 要想使用反射去讀取註解,必須將Retention的值選爲Runtime
Java代碼
package com.iwtxokhtd.annotation;
import java.lang.annotation.Annotation;
import java.lang.reflect.Method;
//讀取註解信息
public class ReadAnnotationInfoTest {
public static void main(String[] args) throws Exception {
// 測試AnnotationTest類,得到此類的類對象
Class c = Class.forName("com.iwtxokhtd.annotation.AnnotationTest");
// 獲取該類所有聲明的方法
Method[] methods = c.getDeclaredMethods();
// 聲明註解集合
Annotation[] annotations;
// 遍歷所有的方法得到各方法上面的註解信息
for (Method method : methods) {
// 獲取每個方法上面所聲明的所有註解信息
annotations = method.getDeclaredAnnotations();
// 再遍歷所有的註解,打印其基本信息
System.out.println(method.getName());
for (Annotation an : annotations) {
System.out.println("方法名爲:" + method.getName() + " 其上面的註解爲:"
+ an.annotationType().getSimpleName());
Method[] meths = an.annotationType().getDeclaredMethods();
// 遍歷每個註解的所有變量
for (Method meth : meths) {
System.out.println("註解的變量名爲:" + meth.getName());
}
}
}
}
}

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章