Java註解提供了關於代碼的一些信息，但並不直接作用於它所註解的代碼內容。在這個教程當中，我們將學習Java的註解，如何定制註解，註解的使用以及如何通過反射解析註解。

Java1.5引入了註解，當前許多java框架中大量使用註解，如Hibernate、Jersey、Spring。註解作為程序的元數據嵌入到程序當中。註解可以被一些解析工具或者是編譯工具進行解析。我們也可以聲明註解在編譯過程或執行時產生作用。

在使用註解之前，程序源數據只是通過java註釋和javadoc，但是註解提供的功能要遠遠超過這些。註解不僅包含了元數據，它還可以作用於程序運行過程中、註解解釋器可以通過註解決定程序的執行順序。例如，在Jersey webservice 我們為方法添加URI字符串的形式的**PATH**註解，那麽在程序運行過程中jerser解釋程序將決定該方法去調用所給的URI。

創建Java自定義註解

創建自定義註解和創建一個接口相似，但是註解的interface關鍵字需要以@符號開頭。我們可以為註解聲明方法。

• 註解方法不能帶有參數；
• 註解方法返回值類型限定為：基本類型、String、Enums、Annotation或者是這些類型的數組；
• 註解方法可以有默認值；
• 註解本身能夠包含元註解，元註解被用來註解其它註解。

這裏有四種類型的元註解：

1. @Documented —— 指明擁有這個註解的元素可以被javadoc此類的工具文檔化。這種類型應該用於註解那些影響客戶使用帶註釋的元素聲明的類型。如果一種聲明使用Documented進行註解，這種類型的註解被作為被標註的程序成員的公共API。

2. @Target——指明該類型的註解可以註解的程序元素的範圍。該元註解的取值可以為TYPE,METHOD,CONSTRUCTOR,FIELD等。如果Target元註解沒有出現，那麽定義的註解可以應用於程序的任何元素。

3. @Inherited——指明該註解類型被自動繼承。如果用戶在當前類中查詢這個元註解類型並且當前類的聲明中不包含這個元註解類型，那麽也將自動查詢當前類的父類是否存在Inherited元註解，這個動作將被重復執行知道這個標註類型被找到，或者是查詢到頂層的父類。

4.@Retention——指明了該Annotation被保留的時間長短。RetentionPolicy取值為SOURCE,CLASS,RUNTIME。

Java內建註解

Java提供了三種內建註解。

1. @Override——當我們想要復寫父類中的方法時，我們需要使用該註解去告知編譯器我們想要復寫這個方法。這樣一來當父類中的方法移除或者發生更改時編譯器將提示錯誤信息。

2. @Deprecated——當我們希望編譯器知道某一方法不建議使用時，我們應該使用這個註解。Java在javadoc 中推薦使用該註解，我們應該提供為什麽該方法不推薦使用以及替代的方法。

3. @SuppressWarnings——這個僅僅是告訴編譯器忽略特定的警告信息，例如在泛型中使用原生數據類型。它的保留策略是SOURCE（譯者註：在源文件中有效）並且被編譯器丟棄。

JAVA - Annotation 註解 入門