Java注解基礎(chǔ)概念總結(jié)

http://blog.csdn.net/github_35180164/article/details/52107204

注解的概念
注解(Annotation),也叫元數(shù)據(jù)(Metadata),是Java5的新特性,JDK5引入了Metadata很容易的就能夠調(diào)用Annotations。注解與類(lèi)、接口、枚舉在同一個(gè)層次,并可以應(yīng)用于包、類(lèi)型、構(gòu)造方法、方法、成員變量、參數(shù)、本地變量的聲明中,用來(lái)對(duì)這些元素進(jìn)行說(shuō)明注釋。

注解的語(yǔ)法與定義形式
(1)以@interface關(guān)鍵字定義(2)注解包含成員,成員以無(wú)參數(shù)的方法的形式被聲明。其方法名和返回值定義了該成員的名字和類(lèi)型。(3)成員賦值是通過(guò)@Annotation(name=value)的形式。(4)注解需要標(biāo)明注解的生命周期,注解的修飾目標(biāo)等信息,這些信息是通過(guò)元注解實(shí)現(xiàn)。
Java.lang.annotation 中定義的 **Target **注解來(lái)說(shuō)明:

@Retention(value = RetentionPolicy.RUNTIME)  
@Target(value = { ElementType.ANNOTATION_TYPE } )  
public @interface Target {  
    ElementType[] value();  
}  

源碼分析如下:第一:元注解@Retention,成員value的值為RetentionPolicy.RUNTIME。第二:元注解@Target,成員value是個(gè)數(shù)組,用{}形式賦值,值為ElementType.ANNOTATION_TYPE第三:成員名稱(chēng)為value,類(lèi)型為ElementType[]另外,需要注意一下,如果成員名稱(chēng)是value,在賦值過(guò)程中可以簡(jiǎn)寫(xiě)。如果成員類(lèi)型為數(shù)組,但是只賦值一個(gè)元素,則也可以簡(jiǎn)寫(xiě)。如上面的簡(jiǎn)寫(xiě)形式為:

@Retention(RetentionPolicy.RUNTIME)  
@Target(ElementType.ANNOTATION_TYPE)  
public @interface Target {  
    ElementType[] value();  
} 

注解的分類(lèi)
注解的分類(lèi)有兩種分法:
第一種分法
1、基本內(nèi)置注解,是指Java自帶的幾個(gè)Annotation,如@Override、Deprecated、@SuppressWarnings等;
2、元注解(meta-annotation),是指負(fù)責(zé)注解其他注解的注解,JDK 1.5及以后版本定義了4個(gè)標(biāo)準(zhǔn)的元注解類(lèi)型,如下:
@Target
@Retention
@Documented
@Inherited

3、自定義注解,根據(jù)需要可以自定義注解,自定義注解需要用到上面的meta-annotation
第二種分法
注解需要標(biāo)明注解的生命周期,這些信息是通過(guò)元注解 @Retention 實(shí)現(xiàn),注解的值是 **enum **類(lèi)型的 RetentionPolicy,包括以下幾種情況:

public enum RetentionPolicy {  
    /** 
     * 注解只保留在源文件,當(dāng)Java文件編譯成class文件的時(shí)候,注解被遺棄. 
     * 這意味著:Annotation僅存在于編譯器處理期間,編譯器處理完之后,該Annotation就沒(méi)用了 
     */  
    SOURCE,  
  
    /** 
     * 注解被保留到class文件,但jvm加載class文件時(shí)候被遺棄,這是默認(rèn)的生命周期. 
     */  
    CLASS,  
  
    /** 
     * 注解不僅被保存到class文件中,jvm加載class文件之后,仍然存在, 
     * 保存到class對(duì)象中,可以通過(guò)反射來(lái)獲取 
     */  
    RUNTIME  
}  

元注解
如上所介紹的Java定義了4個(gè)標(biāo)準(zhǔn)的元注解:

@Documented:標(biāo)記注解,用于描述其它類(lèi)型的注解應(yīng)該被作為被標(biāo)注的程序成員的公共API,因此可以被例如javadoc此類(lèi)的工具文檔化。

@Documented  
@Retention(RetentionPolicy.RUNTIME)  
@Target(ElementType.ANNOTATION_TYPE)  
public @interface Documented {  
}  

@Inherited:標(biāo)記注解,允許子類(lèi)繼承父類(lèi)的注解

@Documented  
@Retention(RetentionPolicy.RUNTIME)  
@Target(ElementType.ANNOTATION_TYPE)  
public @interface Inherited {  
} 

@Retention:指Annotation被保留的時(shí)間長(zhǎng)短,標(biāo)明注解的生命周期,3種**RetentionPolicy**取值含義上面以說(shuō)明

@Documented  
@Retention(RetentionPolicy.RUNTIME)  
@Target(ElementType.ANNOTATION_TYPE)  
public @interface Retention {  
    RetentionPolicy value();  
}  

@Target:標(biāo)明注解的修飾目標(biāo),共有

@Documented  
@Retention(RetentionPolicy.RUNTIME)  
@Target(ElementType.ANNOTATION_TYPE)  
public @interface Target {  
    ElementType[] value();  
}  
  
// ElementType取值  
public enum ElementType {  
    /** 類(lèi)、接口(包括注解類(lèi)型)或枚舉 */  
    TYPE,  
    /** field屬性,也包括enum常量使用的注解 */  
    FIELD,  
    /** 方法 */  
    METHOD,  
    /** 參數(shù) */  
    PARAMETER,  
    /** 構(gòu)造函數(shù) */  
    CONSTRUCTOR,  
    /** 局部變量 */  
    LOCAL_VARIABLE,  
    /** 注解上使用的元注解 */  
    ANNOTATION_TYPE,  
    /** 包 */  
    PACKAGE  
} 
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書(shū)系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 230,563評(píng)論 6 544
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡,警方通過(guò)查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 99,694評(píng)論 3 429
  • 文/潘曉璐 我一進(jìn)店門(mén),熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái),“玉大人,你說(shuō)我怎么就攤上這事。” “怎么了?”我有些...
    開(kāi)封第一講書(shū)人閱讀 178,672評(píng)論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)。 經(jīng)常有香客問(wèn)我,道長(zhǎng),這世上最難降的妖魔是什么? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 63,965評(píng)論 1 318
  • 正文 為了忘掉前任,我火速辦了婚禮,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 72,690評(píng)論 6 413
  • 文/花漫 我一把揭開(kāi)白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上,一...
    開(kāi)封第一講書(shū)人閱讀 56,019評(píng)論 1 329
  • 那天,我揣著相機(jī)與錄音,去河邊找鬼。 笑死,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 44,013評(píng)論 3 449
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來(lái)了?” 一聲冷哼從身側(cè)響起,我...
    開(kāi)封第一講書(shū)人閱讀 43,188評(píng)論 0 290
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒(méi)想到半個(gè)月后,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 49,718評(píng)論 1 336
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 41,438評(píng)論 3 360
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 43,667評(píng)論 1 374
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 39,149評(píng)論 5 365
  • 正文 年R本政府宣布,位于F島的核電站,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 44,845評(píng)論 3 351
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 35,252評(píng)論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)。三九已至,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 36,590評(píng)論 1 295
  • 我被黑心中介騙來(lái)泰國(guó)打工, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 52,384評(píng)論 3 400
  • 正文 我出身青樓,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 48,635評(píng)論 2 380

推薦閱讀更多精彩內(nèi)容

  • 什么是注解(Annotation):Annotation(注解)就是Java提供了一種元程序中的元素關(guān)聯(lián)任何信息和...
    九尾喵的薛定諤閱讀 3,206評(píng)論 0 2
  • 本文章涉及代碼已放到github上annotation-study 1.Annotation為何而來(lái) What:A...
    zlcook閱讀 29,230評(píng)論 15 116
  • 注解 創(chuàng)建注解 下面代碼創(chuàng)建了一個(gè)名為MyAnno的注解,有兩個(gè)成員str和val。@Retention(…)注解...
    kylinxiang閱讀 3,654評(píng)論 0 2
  • 1、概述 Annotation(注解)是JDK5.0及以后版本引入的。它用來(lái)修飾編程元素,如:包、類(lèi)、構(gòu)造方法、方...
    M_JCs閱讀 656評(píng)論 0 0
  • 你斜臥在湖邊的石頭上, 桂樹(shù)為你撐傘,鳥(niǎo)兒為你歡唱, 連近旁的湖畔也來(lái)為你獻(xiàn)殷勤, 清水,...
    夜行俠de印記閱讀 285評(píng)論 2 0