Java基礎——註解

標籤：註解   代碼   泛型   源檔案   存在   request   div   rri   logs   

一、概述

　　　引自百度百科：

定義：註解（Annotation），也叫中繼資料。一種代碼層級的說明。它是JDK1.5及以後版本引入的一個特性，與類、介面、枚舉是在同一個層次。它可以聲明在包、類、欄位、方法、局部變數、方法參數等的前面，用來對這些元素進行說明，注釋。

二、JDK內建註解

　　Java提供了三種內建註解。

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

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

　　3. @SuppressWarnings——這個僅僅是告訴編譯器忽略特定的警告資訊，例如在泛型中使用原生資料類型。它的保留原則是SOURCE（譯者註：在源檔案中有效）並且被編譯器丟棄。

三、元註解

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

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

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

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

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

　　更多詳細介紹與講解，參見（推薦）：http://www.cnblogs.com/peida/archive/2013/04/24/3036689.html    （包含註解處理器等，推薦！）

四、自訂註解

　　還是像之前一樣，我們找到一個已經存在的註解來看看它怎麼寫的（例如：@SuppressWarnings）

　　1.定義：可以看到使用 @interface來聲明一個註解

public @interface SuppressWarnings {

　　2.成員：注意定義的格式，後面需要帶小括弧,如果需要預設值，可以後接default ""等形式

 String[] value();

　　　//完整的資料類型支援，請參見上文連結

　　　//之後使用的註解中也可以看到，如果註解只有一個成員且為 value，可以省略，不用寫@RequestMapping(value = "/add")，可以簡寫為("/add")

Java基礎——註解