註解實現原理

一、什麼是註解?

對於很多初次接觸的開發者來說應該都有這個疑問?Annontation是Java5開始引入的新特徵,中文名稱叫註解。它提供了一種安全的類似註釋的機制,用來將任何的資訊或元資料(metadata)與程式元素(類、方法、成員變數等)進行關聯。為程式的元素(類、方法、成員變數)加上更直觀更明瞭的說明,這些說明資訊是與程式的業務邏輯無關,並且供指定的工具或框架使用。Annontation像一種修飾符一樣,應用於包、型別、構造方法、方法、成員變數、引數及本地變數的宣告語句中。

二、註解的用處:

1、生成文件。這是最常見的,也是java 最早提供的註解。常用的有@param @return 等

2、跟蹤程式碼依賴性,實現替代配置檔案功能。比如Dagger 2 依賴注入,未來java 開發,將大量註解配置,具有很大用處;

3、在編譯時進行格式檢查。如@override 放在方法前,如果你這個方法並不是覆蓋了超類方法,則編譯時就能檢查出。

三、註解的原理:

註解本質是一個繼承了Annotation 的特殊介面,其具體實現類是Java 執行時生成的動態代理類。而我們透過反射獲取註解時,返回的是Java 執行時生成的動態代理物件$Proxy1。透過代理物件呼叫自定義註解(介面)的方法,會最終呼叫AnnotationInvocationHandler 的invoke 方法。該方法會從memberValues 這個Map 中索引出對應的值。而memberValues 的來源是Java 常量池。

四、元註解:

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

● RetentionPolicy。SOURCE : 在編譯階段丟棄。這些註解在編譯結束之後就不再有任何意義,所以它們不會寫入位元組碼。@Override, @SuppressWarnings都屬於這類註解。

● RetentionPolicy。CLASS : 在類載入的時候丟棄。在位元組碼檔案的處理中有用。註解預設使用這種方式

● RetentionPolicy。RUNTIME : 始終不會丟棄,執行期也保留該註解,因此可以使用反射機制讀取該註解的資訊。我們自定義的註解通常使用這種方式。

2。)Target – 表示該註解用於什麼地方。預設值為任何元素,表示該註解用於什麼地方。可用的ElementType 引數包括

● ElementType。CONSTRUCTOR: 用於描述構造器

● ElementType。FIELD: 成員變數、物件、屬性(包括enum例項)

● ElementType。LOCAL_VARIABLE: 用於描述區域性變數

● ElementType。METHOD: 用於描述方法

● ElementType。PACKAGE: 用於描述包

● ElementType。PARAMETER: 用於描述引數

● ElementType。TYPE: 用於描述類、介面(包括註解型別) 或enum宣告

3。)@Documented – 一個簡單的Annotations 標記註解,表示是否將註解資訊新增在java 文件中。

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

@Inherited 元註解是一個標記註解,@Inherited 闡述了某個被標註的型別是被繼承的。如果一個使用了@Inherited 修飾的annotation 型別被用於一個class,則這個annotation 將被用於該class 的子類。

五、常見標準的Annotation:

1。)Override

java。lang。Override 是一個標記型別註解,它被用作標註方法。它說明了被標註的方法過載了父類的方法,起到了斷言的作用。如果我們使用了這種註解在一個沒有覆蓋父類方法的方法時,java 編譯器將以一個編譯錯誤來警示。

2。)Deprecated

Deprecated 也是一種標記型別註解。當一個型別或者型別成員使用@Deprecated 修飾的話,編譯器將不鼓勵使用這個被標註的程式元素。所以使用這種修飾具有一定的“延續性”:如果我們在程式碼中透過繼承或者覆蓋的方式使用了這個過時的型別或者成員,雖然繼承或者覆蓋後的型別或者成員並不是被宣告為@Deprecated,但編譯器仍然要報警。

3。)SuppressWarnings

SuppressWarning 不是一個標記型別註解。它有一個型別為String[] 的成員,這個成員的值為被禁止的警告名。對於javac 編譯器來講,被-Xlint 選項有效的警告名也同樣對@SuppressWarings 有效,同時編譯器忽略掉無法識別的警告名。

@SuppressWarnings(“unchecked”)

六、自定義註解:

自定義註解類編寫的一些規則:

1。 Annotation 型定義為@interface, 所有的Annotation 會自動繼承java。lang。Annotation這一介面,並且不能再去繼承別的類或是介面。

2。 引數成員只能用public 或預設(default) 這兩個訪問權修飾

3。 引數成員只能用基本型別byte、short、char、int、long、float、double、boolean八種基本資料型別和String、Enum、Class、annotations等資料型別,以及這一些型別的陣列。

4。 要獲取類方法和欄位的註解資訊,必須透過Java的反射技術來獲取 Annotation 物件,因為你除此之外沒有別的獲取註解物件的方法

5。 註解也可以沒有定義成員,,不過這樣註解就沒啥用了

PS:自定義註解需要使用到元註解

七、spring中註解@Resource原始碼分析

註解代表的是某種業務意義,註解背後處理器的工作原理如上原始碼實現:首先解析所有屬性,判斷屬性上是否存在指定註解,如果存在則根據搜尋規則取得bean,然後利用反射原理注入。如果標註在欄位上面,也可以透過欄位的反射技術取得註解,根據搜尋規則取得bean,然後利用反射技術注入。

以上內容作為筆記轉自

https://www。cnblogs。com/acm-bingzi/p/javaAnnotation。html

https://www。cnblogs。com/fanheyan/articles/5691659。html

後續自己封裝框架的業務操作日誌,會藉助自定義註解來封裝,如有時間,會繼續分享封裝的思想。

——————END——————-

TAG: 註解ElementType方法型別自定義