Java基礎——註解
一、概述
引自百度百科:
定義:註解(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基礎——註解