再有人問Java中的註解就把這篇文章丟給他！

什麼是註解？

用一個詞就能夠描述註解，那就是元數據，即一種描述數據的數據。因此，能夠說註解就是源代碼的元數據。好比，下面這段代碼：

 

上面的代碼中，我重寫了toString()方法並使用了@Override註解。可是，即便我不使用@Override註解標記代碼，程序也可以正常執行。那麼，該註解表示什麼？這麼寫有什麼好處嗎？事實上，@Override告訴編譯器這個方法是一個重寫方法(描述方法的元數據)，若是父類中不存在該方法，編譯器便會報錯，提示該方法沒有重寫父類中的方法。若是我不當心拼寫錯誤，例如將toString()寫成了toStrring(){double r}，並且我也沒有使用@Override註解，那程序依然能編譯運行。但運行結果會和我指望的大不相同。如今咱們瞭解了什麼是註解，而且使用註解有助於閱讀程序。

Annotation是一種應用於類、方法、參數、變量、構造器及包聲明中的特殊修飾符。它是一種由JSR-175標準選擇用來描述元數據的一種工具。

爲何要引入註解？

使用Annotation以前(甚至在使用以後)，XML被普遍的應用於描述元數據。不知什麼時候開始一些應用開發人員和架構師發現XML的維護愈來愈糟糕了。他們但願使用一些和代碼緊耦合的東西，而不是像XML那樣和代碼是鬆耦合的(在某些狀況下甚至是徹底分離的)代碼描述。若是你在Google中搜索「XML vs. annotations」，會看到許多關於這個問題的辯論。最有趣的是XML配置其實就是爲了分離代碼和配置而引入的。上述兩種觀點可能會讓你很疑惑，二者觀點彷佛構成了一種循環，但各有利弊。下面咱們經過一個例子來理解這二者的區別。

假如你想爲應用設置不少的常量或參數，這種狀況下，XML是一個很好的選擇，由於它不會同特定的代碼相連。若是你想把某個方法聲明爲服務，那麼使用Annotation會更好一些，由於這種狀況下須要註解和方法緊密耦合起來，開發人員也必須認識到這點。

另外一個很重要的因素是Annotation定義了一種標準的描述元數據的方式。在這以前，開發人員一般使用他們本身的方式定義元數據。例如，使用標記interfaces，註釋，transient關鍵字等等。每一個程序員按照本身的方式定義元數據，而不像Annotation這種標準的方式。

目前，許多框架將XML和Annotation兩種方式結合使用，平衡二者之間的利弊。

Annotation是如何工做的？怎麼編寫自定義的Annotation？

在講述這部分以前，建議你首先下載Annotation的示例代碼AnnotationsSample.zip 。下載以後放在你習慣使用的IDE中，這些代碼會幫助你更好的理解Annotation機制。

編寫Annotation很是簡單，能夠將Annotation的定義同接口的定義進行比較。咱們來看兩個例子：一個是標準的註解@Override，另外一個是用戶自定義註解@Todo。

 

對於@Override註釋你可能有些疑問，它什麼都沒作，那它是如何檢查在父類中有一個同名的函數呢。固然，不要驚訝，我是逗你玩的。@Override註解的定義不只僅只有這麼一點代碼。這部份內容很重要，我不得再也不次重複：Annotations僅僅是元數據，和業務邏輯無關。理解起來有點困難，但就是這樣。若是Annotations不包含業務邏輯，那麼必須有人來實現這些邏輯。元數據的用戶來作這個事情。Annotations僅僅提供它定義的屬性(類/方法/包/域)的信息。Annotations的用戶(一樣是一些代碼)來讀取這些信息並實現必要的邏輯。

當咱們使用Java的標註Annotations(例如@Override)時，JVM就是一個用戶，它在字節碼層面工做。到這裏，應用開發人員還不能控制也不能使用自定義的註解。所以，咱們講解一下如何編寫自定義的Annotations。

咱們來逐個講述編寫自定義Annotations的要點。上面的例子中，你看到一些註解應用在註解上。

J2SE5.0版本在 java.lang.annotation提供了四種元註解，專門註解其餘的註解：

@Documented –註解是否將包含在JavaDoc中

@Retention –何時使用該註解

@Target? –註解用於什麼地方

@Inherited – 是否容許子類繼承該註解

@Documented–一個簡單的Annotations標記註解，表示是否將註解信息添加在java文檔中。

@Retention– 定義該註解的生命週期。

RetentionPolicy.SOURCE– 在編譯階段丟棄。這些註解在編譯結束以後就再也不有任何意義，因此它們不會寫入字節碼。@Override, @SuppressWarnings都屬於這類註解。

RetentionPolicy.CLASS– 在類加載的時候丟棄。在字節碼文件的處理中有用。註解默認使用這種方式。

RetentionPolicy.RUNTIME– 始終不會丟棄，運行期也保留該註解，所以可使用反射機制讀取該註解的信息。咱們自定義的註解一般使用這種方式。

@Target– 表示該註解用於什麼地方。若是不明確指出，該註解能夠放在任何地方。如下是一些可用的參數。須要說明的是：屬性的註解是兼容的，若是你想給7個屬性都添加註解，僅僅排除一個屬性，那麼你須要在定義target包含全部的屬性。

ElementType.TYPE:用於描述類、接口或enum聲明

ElementType.FIELD:用於描述實例變量

ElementType.METHOD

ElementType.PARAMETER

ElementType.CONSTRUCTOR

ElementType.LOCAL_VARIABLE

ElementType.ANNOTATION_TYPE另外一個註釋

ElementType.PACKAGE用於記錄java文件的package信息

@Inherited– 定義該註釋和子類的關係

那麼，註解的內部究竟是如何定義的呢？Annotations只支持基本類型、String及枚舉類型。註釋中全部的屬性被定義成方法，並容許提供默認值。

 

下面的例子演示瞭如何使用上面的註解。

@Todo(priority = Todo.Priority.MEDIUM, author ="Yashwant", status = Todo.Status.STARTED)

publicvoidincompleteMethod1(){

}

若是註解中只有一個屬性，能夠直接命名爲「value」，使用時無需再標明屬性名。

 

但目前爲止一切看起來都還不錯。咱們定義了本身的註解並將其應用在業務邏輯的方法上。如今咱們須要寫一個用戶程序調用咱們的註解。這裏咱們須要使用反射機制。若是你熟悉反射代碼，就會知道反射能夠提供類名、方法和實例變量對象。全部這些對象都有getAnnotation()這個方法用來返回註解信息。咱們須要把這個對象轉換爲咱們自定義的註釋(使用 instanceOf()檢查以後)，同時也能夠調用自定義註釋裏面的方法。看看如下的實例代碼，使用了上面的註解:

 

註解用例

註解的功能很強大，Spring和Hebernate這些框架在日誌和有效性中大量使用了註解功能。註解能夠應用在使用標記接口的地方。不一樣的是標記接口用來定義完整的類，但你能夠爲單個的方法定義註釋，例如是否將一個方法暴露爲服務。

在最新的servlet3.0中引入了不少新的註解，尤爲是和servlet安全相關的註解。

HandlesTypes–該註解用來表示一組傳遞給ServletContainerInitializer的應用類。

HttpConstraint– 該註解表明全部HTTP方法的應用請求的安全約束，和ServletSecurity註釋中定義的HttpMethodConstraint安全約束不一樣。

HttpMethodConstraint – 指明不一樣類型請求的安全約束，和ServletSecurity 註解中描述HTTP協議方法類型的註釋不一樣。

MultipartConfig–該註解標註在Servlet上面，表示該Servlet但願處理的請求的 MIME 類型是 multipart/form-data。

ServletSecurity該註解標註在Servlet繼承類上面，強制該HTTP協議請求遵循安全約束。

WebFilter– 該註解用來聲明一個Server過濾器；

WebInitParam– 該註解用來聲明Servlet或是過濾器的中的初始化參數，一般配合 @WebServlet 或者 @WebFilter 使用。

WebListener–該註解爲Web應用程序上下文中不一樣類型的事件聲明監聽器。

WebServlet–該註解用來聲明一個Servlet的配置。

ADF (應用程序框架)和註解

如今咱們開始討論文章的最後一部分了。應用程序框架，被稱爲ADF，由Oracle開發用來建立Oracle融合應用。咱們已經瞭解了註解的優缺點，也知道如何編寫自定義的註解，但咱們應該將註解應用在ADF的哪部分呢？ADF是否提供了一些樸素的註解？很好的問題，確實在ADF中大量使用註解有一些限制。以前提到的應用框架如Spring和Hibernate使用AOP(面向側面的程序設計)。在AOP中，框架提供了一種機制，在事件的預處理和後續處理中注入代碼。例如：你有一個鉤子用來在方法執行以前和以後添加代碼，因此你能夠在這些地方編寫你的用戶代碼。ADF不使用AOP。若是咱們有任何註解的用例可用，咱們可能須要經過繼承的方式實現。

歡迎工做一到五年的Java工程師朋友們加入Java架構開發：744677563

本羣提供免費的學習指導 架構資料 以及免費的解答

不懂得問題均可以在本羣提出來 以後還會有職業生涯規劃以及面試指導