Java高級特性——Java注解介紹與底層實現原理(上)

每天進步一點,不做curd工程師與Api調用工程師!

歡迎大家訪問我的博客:https://coder-programming.cn/

為了防止篇幅過長不易閱讀,在介紹Java注解時。分為兩篇文章進行詳細介紹。

Java高級特性——注解介紹與底層原理(上)

內容如下

Java注解

Java注解基本介紹

簡介

注解也叫元數據,例如我們常見的@Override和@Deprecated,注解是JDK1.5版本開始引入的一個特性,用于對代碼進行說明,可以對包、類、接口、字段、方法參數、局部變量等進行注解。

功能

  • 作為特定的標記,用于告訴編譯器一些信息
  • 編譯時動態處理,如動態生成代碼
  • 運行時動態處理,作為額外信息的載體,如獲取注解信息

其中了解下XML與注解的區別:

注解:是一種分散式的元數據,與源代碼緊綁定。

XML:是一種集中式的元數據,與源代碼無綁定

分類

  • 標準注解:@Override@Deprecated@SuppresWarnings
  • 元注解:@Retention@Target@Inherited@Documented
  • 自定義注解:可以根據自己的需求定義注解

注:
@Override(標明重寫某個方法)、
@Deprecated(標明某個類或方法過時)
@SuppressWarnings(標明要忽略的警告)

元注解詳細介紹

元注解的作用就是負責注解其他注解。Java5.0定義了4個標準的meta-annotation類型,它們被用來提供對其它 annotation類型作說明。Java5.0定義的元注解有以下幾種:

  • @Target
  • @Retention
  • @Documented
  • @Inherited

元注解 @Target

用于描述注解的范圍,即注解在哪用。它說明了Annotation所修飾的對象范圍:Annotation可被用于 packages、types(類、接口、枚舉、Annotation類型)、類型成員(方法、構造方法、成員變量、枚舉值)、方法參數和本地變量(如循環變量、catch參數)等。通過源碼我們可以看到取值類型(ElementType)有以下幾種:

package java.lang.annotation;

public enum ElementType {
    TYPE, //用于描述類、接口(包括注解類型) 或enum聲明
    FIELD, //用于描述域即類成員變量
    METHOD, //用于描述方法
    PARAMETER, //用于描述參數
    CONSTRUCTOR, //用于描述構造器
    LOCAL_VARIABLE, //用于描述局部變量
    ANNOTATION_TYPE, //描述注解
    PACKAGE,//用于描述包
    TYPE_PARAMETER,//1.8版本開始,描述類、接口或enum參數的聲明
    TYPE_USE, //1.8版本開始,描述一種類、接口或enum的使用聲明
    MODULE; //表示作用在部分模塊中(Java9引入的概念)

    private ElementType() {
    }
}

舉例:

///表示Log注解可以用在類、接口、enum和方法上
@Target({ElementType.METHOD, ElementType.TYPE})
public @interface Log {
    ......
}

元注解 @Retention

用于描述注解的生命周期,表示需要在什么級別保存該注解,即保留的時間長短。取值類型(RetentionPolicy)有以下幾種:

1
  • SOURCE:在源文件中有效(即源文件保留)
  • CLASS:在class文件中有效(即class保留)
  • RUNTIME:在運行時有效(即運行時保留)

舉例:

//使用RetentionPolicy.RUNTIME,這樣注解處理器可以通過反射,獲取到該注解的屬性值,從而去做一些運行時的邏輯處理。
@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
public @interface Log {
  ......
}

元注解 @Documented

用于描述其它類型的annotation應該被作為被標注的程序成員的公共API,因此可以被例如javadoc此類的工具文檔化。它是一個標記注解,沒有成員。

@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Log {
  ......
}

元注解 @Inherited

用于表示某個被標注的類型是被繼承的。如果一個使用了@Inherited修飾的annotation類型被用于一個class,則這個annotation將被用于該class的子類。

文末

文章收錄至
Github: https://github.com/CoderMerlin/coder-programming
Gitee: https://gitee.com/573059382/coder-programming

歡迎關注并star~

?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,412評論 6 532
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,514評論 3 416
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,373評論 0 374
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,975評論 1 312
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,743評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,199評論 1 324
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,262評論 3 441
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,414評論 0 288
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,951評論 1 336
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,780評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,983評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,527評論 5 359
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,218評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,649評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,889評論 1 286
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,673評論 3 391
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,967評論 2 374

推薦閱讀更多精彩內容