Java基礎(chǔ)之理解Annotation
一、概念
Annontation是Java5開始引入的新特征。中文名稱一般叫注解。它提供了一種安全的類似注釋的機(jī)制，用來將任何的信息或元數(shù)據(jù)（metadata）與程序元素（類、方法、成員變量等）進(jìn)行關(guān)聯(lián)。
更通俗的意思是為程序的元素（類、方法、成員變量）加上更直觀更明了的說明，這些說明信息是與程序的業(yè)務(wù)邏輯無關(guān)，并且是供指定的工具或框架使用的。
Annontation像一種修飾符一樣，應(yīng)用于包、類型、構(gòu)造方法、方法、成員變量、參數(shù)及本地變量的聲明語句中。
二、原理
Annotation其實(shí)是一種接口。通過Java的反射機(jī)制相關(guān)的API來訪問annotation信息。相關(guān)類（框架或工具中的類）根據(jù)這些信息來決定如何使用該程序元素或改變它們的行為。
annotation是不會(huì)影響程序代碼的執(zhí)行，無論annotation怎么變化，代碼都始終如一地執(zhí)行。
Java語言解釋器在工作時(shí)會(huì)忽略這些annotation，因此在JVM 中這些annotation是“不起作用”的，只能通過配套的工具才能對(duì)這些annontaion類型的信息進(jìn)行訪問和處理。
Annotation與interface的異同：
1）、Annotation類型使用關(guān)鍵字@interface而不是interface。
這個(gè)關(guān)鍵字聲明隱含了一個(gè)信息：它是繼承了java.lang.annotation.Annotation接口，并非聲明了一個(gè)interface
2）、Annotation類型、方法定義是獨(dú)特的、受限制的。
Annotation 類型的方法必須聲明為無參數(shù)、無異常拋出的。這些方法定義了annotation的成員：方法名成為了成員名，而方法返回值成為了成員的類型。而方法返回值類型必須為primitive類型、Class類型、枚舉類型、annotation類型或者由前面類型之一作為元素的一維數(shù)組。方法的后面可以使用 default和一個(gè)默認(rèn)數(shù)值來聲明成員的默認(rèn)值，null不能作為成員默認(rèn)值，這與我們?cè)诜莂nnotation類型中定義方法有很大不同。
Annotation類型和它的方法不能使用annotation類型的參數(shù)、成員不能是generic。只有返回值類型是Class的方法可以在annotation類型中使用generic，因?yàn)榇朔椒軌蛴妙愞D(zhuǎn)換將各種類型轉(zhuǎn)換為Class。
3）、Annotation類型又與接口有著近似之處。
它們可以定義常量、靜態(tài)成員類型（比如枚舉類型定義）。Annotation類型也可以如接口一般被實(shí)現(xiàn)或者繼承。
三、應(yīng)用場合
annotation一般作為一種輔助途徑，應(yīng)用在軟件框架或工具中，在這些工具類中根據(jù)不同的 annontation注解信息采取不同的處理過程或改變相應(yīng)程序元素（類、方法及成員變量等）的行為。
例如：Junit、Struts、Spring等流行工具框架中均廣泛使用了annontion。使代碼的靈活性大提高。
四、常見標(biāo)準(zhǔn)的Annotation
從java5版本開始，自帶了三種標(biāo)準(zhǔn)annontation類型,
?。?）、Override
java.lang.Override 是一個(gè)marker annotation類型，它被用作標(biāo)注方法。它說明了被標(biāo)注的方法重載了父類的方法，起到了斷言的作用。如果我們使用了這種annotation在一個(gè)沒有覆蓋父類方法的方法時(shí)，java編譯器將以一個(gè)編譯錯(cuò)誤來警示。
這個(gè)annotaton常常在我們?cè)噲D覆蓋父類方法而確又寫錯(cuò)了方法名時(shí)加一個(gè)保障性的校驗(yàn)過程。
（2）、Deprecated
Deprecated也是一種marker annotation。當(dāng)一個(gè)類型或者類型成員使用@Deprecated修飾的話，編譯器將不鼓勵(lì)使用這個(gè)被標(biāo)注的程序元素。所以使用這種修飾具有一定的 “延續(xù)性”：如果我們?cè)诖a中通過繼承或者覆蓋的方式使用了這個(gè)過時(shí)的類型或者成員，雖然繼承或者覆蓋后的類型或者成員并不是被聲明為 @Deprecated，但編譯器仍然要報(bào)警。
注意：@Deprecated這個(gè)annotation類型和javadoc中的 @deprecated這個(gè)tag是有區(qū)別的：前者是java編譯器識(shí)別的，而后者是被javadoc工具所識(shí)別用來生成文檔（包含程序成員為什么已經(jīng)過時(shí)、它應(yīng)當(dāng)如何被禁止或者替代的描述）。
（3）、SuppressWarnings
此注解能告訴Java編譯器關(guān)閉對(duì)類、方法及成員變量的警告。
有時(shí)編譯時(shí)會(huì)提出一些警告，對(duì)于這些警告有的隱藏著Bug，有的是無法避免的，對(duì)于某些不想看到的警告信息，可以通過這個(gè)注解來屏蔽。
SuppressWarning不是一個(gè)marker annotation。它有一個(gè)類型為String[]的成員，這個(gè)成員的值為被禁止的警告名。對(duì)于javac編譯器來講，被-Xlint選項(xiàng)有效的警告名也同樣對(duì)@SuppressWarings有效，同時(shí)編譯器忽略掉無法識(shí)別的警告名。
annotation語法允許在annotation名后跟括號(hào)，括號(hào)中是使用逗號(hào)分割的name=value對(duì)用于為annotation的成員賦值：
代碼：
|
1
2
3
|
@SuppressWarnings(value={"unchecked","fallthrough"})public void lintTrap() { /* sloppy method body omitted */ } |
在這個(gè)例子中SuppressWarnings annotation類型只定義了一個(gè)單一的成員，所以只有一個(gè)簡單的value={...}作為name=value對(duì)。又由于成員值是一個(gè)數(shù)組，故使用大括號(hào)來聲明數(shù)組值。
注意：我們可以在下面的情況中縮寫annotation：當(dāng)annotation只有單一成員，并成員命名為"value="。這時(shí)可以去"value="。比如將上面的SuppressWarnings annotation進(jìn)行縮寫：
代碼：
|
1
|
@SuppressWarnings({"unchecked","fallthrough"}) |
如果SuppressWarnings所聲明的被禁止警告?zhèn)€數(shù)為一個(gè)時(shí)，可以省去大括號(hào)：
|
1
|
@SuppressWarnings("unchecked") |
五、自定義annontation示例
示例共涉及四個(gè)類：
清單1:Author.java
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
package com.magc.annotation;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; /** * 定義作者信息，name和group * @author magc * */ @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.METHOD) @Documentedpublic @interface Author { String name(); String group();} |
清單2:Description.java
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
|
/** * */package com.magc.annotation;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;/** * @author magc * * 定義描述信息 value */ @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.TYPE) @Documented public @interface Description { String value();} |
清單3:Utility.java
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
package com.magc.annotation; @Description(value = "這是一個(gè)有用的工具類")public class Utility { @Author(name = "haoran_202",group="com.magc") public String work() { return "work over!"; } } |
注：這是個(gè)普通的Java類，運(yùn)行了@Description和@Author注解。
清單3:AnalysisAnnotation.java
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
|
package com.magc.annotation;import java.lang.reflect.Method;public class AnalysisAnnotation { /** * 在運(yùn)行時(shí)分析處理annotation類型的信息 * * */ public static void main(String[] args) { try { //通過運(yùn)行時(shí)反射API獲得annotation信息 Class rt_class = Class.forName("com.magc.annotation.Utility"); Method[] methods = rt_class.getMethods(); boolean flag = rt_class.isAnnotationPresent(Description.class); if(flag) { Description description = (Description)rt_class.getAnnotation(Description.class); System.out.println("Utility's Description--->"+description.value()); for (Method method : methods) { if(method.isAnnotationPresent(Author.class)) { Author author = (Author)method.getAnnotation(Author.class); System.out.println("Utility's Author--->"+author.name()+" from "+author.group()); } } } } catch (ClassNotFoundException e) { e.printStackTrace(); } }} |
注：這是個(gè)與自定義@Description和@Author配套的基礎(chǔ)框架或工具類，通過此類來獲得與普通Java類Utility.java關(guān)聯(lián)的信息,即描述和作者。
運(yùn)行AnalysisAnnotation,輸出結(jié)果為：
Utility's Description--->這是一個(gè)有用的工具類
Utility's Author--->haoran_202 from com.magc
感謝閱讀，希望能幫助到大家，謝謝大家對(duì)本站的支持！
原文鏈接：http://blog.csdn.net/feixiaoxing/article/details/6885657
