“注解”這個(gè)詞，可謂是在Java編程中出鏡率比較高，而且也是一個(gè)老生常談的話題。我們之前在聊Spring相關(guān)的東西時(shí)，注解是無處不在，之前我們簡(jiǎn)單的聊過一些“注解”的相關(guān)內(nèi)容，比如在Spring中是如何進(jìn)行“注解”組合的。因?yàn)樽⒔庠贘ava編程中還是比較重要的，所以我們今天的博客就把注解的東西給系統(tǒng)的介紹一下，當(dāng)然我們會(huì)依托于具體的實(shí)例。

“注解”說白了就是存儲(chǔ)數(shù)據(jù)的一種方式，如果注解單拎出來功能也就一般，如果將“注解”與Java的“反射機(jī)制”相結(jié)合，那么可以做的事情就多了。也就是說，你可以通過反射來讀取“注解”提供的信息，然后來根據(jù)你的具體需求來做一些事情。當(dāng)然，之前我們常用XML來為反射機(jī)制提供信息，不過“XML”的配置還是沒有“注解”這種數(shù)據(jù)形式好管理，好維護(hù)，所以“注解”的地位還是比較重要的。

下方我們先聊一下“元注解”，然后在根據(jù)這些“元注解”來自定義注解，并使用Java的“反射機(jī)制”來讀取各種類型的注解信息。

一、元注解

在本篇博客的第一部分，我們先來整體的看一下“元注解”，然后下方的內(nèi)容再根據(jù)這些元注解進(jìn)行展開。

1、@Target

使用方式：@Target(ElementType.CONSTRUCTOR)

@Target注解是比較重要的，Target的中文是“目標(biāo)、位置”的意思，見名知意。@Target就用來聲明我們創(chuàng)建的注解所放置的位置，也就是我們所創(chuàng)建的注解可以修飾什么樣的元素。@Target的參數(shù)是一個(gè)ElementType的枚舉，每個(gè)枚舉項(xiàng)代表著一個(gè)位置。下方就是幾個(gè)ElementType枚舉比較常用的值：

• TYPE: 類，如果@Target的參數(shù)是TYPE，那么我們創(chuàng)建的這個(gè)注解只能修飾類、接口、枚舉等這些類型上。

• FIELD: 字段修飾，如果我們的自定義注解是FIELD類型的話，那么我們的注解只能用來修飾類或者枚舉的字段，也就是成員變量。

• CONSTRUCTOR：構(gòu)造器類型，該類型的“注解”只能修飾構(gòu)造器。

• METHOD：修飾“方法”的注解。

• PARAMETER：修飾“方法”中的參數(shù)的注解。

• LOCAL_VARIABLE: 修飾“局部變量”的注解。

當(dāng)然，上面是簡(jiǎn)單一聊，下方會(huì)給出上述類型注解的具體實(shí)例。下面截圖是ElementType中所有的選項(xiàng)以及每個(gè)枚舉值的作用。具體如下所示，下方兩個(gè)是1.8后新加的枚舉項(xiàng)，如下所示：

2、@Retention

使用方式：@Retention(RetentionPolicy.RUNTIME)

上面是@Retention的使用方式，Retention的中文意思是“保留”，也就是說該元注解給出了“注解”的保留周期。@Retention也是接收一個(gè)枚舉類型的參數(shù)，下方就是該枚舉所包含的類型。下方的英文注釋已經(jīng)具體的給出了每個(gè)枚舉項(xiàng)所對(duì)應(yīng)的意思。

• SOURCE：說明我們的注解只會(huì)留在我們的源碼中，并不會(huì)被編譯。

• CLASS: 說明我們的注解會(huì)被編譯成字節(jié)碼存儲(chǔ)到.class文件中，但不會(huì)在虛擬機(jī)中鏈接運(yùn)行。

• RUNTIME：這個(gè)就說明我們的注解會(huì)一直保留到程序的運(yùn)行時(shí)，如果你想在運(yùn)行時(shí)根據(jù)注解的信息通過反射機(jī)制做一些事情的話，那么必須得將我們的注解保留到這一階段。

3、@Document與@Inherited

這兩個(gè)注解就比較簡(jiǎn)單了，@Document說明將此注解包含在Javadoc中，而@Inherited則表示，該注解可以被子類繼承。

上述的介紹可能會(huì)有些抽象，接下來我我們就根據(jù)實(shí)例，利用反射機(jī)制來操作相應(yīng)類型的自定義注解。

二、測(cè)試用例介紹

下方截圖是本篇博客所涉及Demo的目錄以及主要的操作類。

• AnnotationTracker：該類負(fù)責(zé)通過Java的“反射機(jī)制”來獲取相應(yīng)類型的注解的對(duì)象以及注解中的相關(guān)信息。在AnnotationTracker的類中，全是靜態(tài)方法，靜態(tài)方法傳入的是相關(guān)注解修飾的Class。大體結(jié)構(gòu)如下所示。

• CE…Annotation：這些類是不同類型的注解，稍后我們會(huì)詳細(xì)討論。

• TestClass：該類是注解所修飾的測(cè)試類。

• Main：我們本Demo的測(cè)試用例的執(zhí)行方法。

三、類型注解：@Target(ElementType.TYPE)

接下來，我們來看一下類型注解的創(chuàng)建與使用。下方內(nèi)容我們下創(chuàng)建一個(gè)修飾類型的注解，然后再相關(guān)類中添加上該注解的修飾，最后使用Java的反射機(jī)制來獲取相應(yīng)的注解信息。

1、創(chuàng)建注解

首先創(chuàng)建我們的注解，具體步驟如下所示，選擇Annotation后鍵入注解名點(diǎn)擊回車即可。

下方代碼段就是所創(chuàng)建注解中的詳細(xì)內(nèi)容。我們可以看出@Target元注解的參數(shù)是ElementType.TYPE類型的。也就是說明我們創(chuàng)建的這個(gè)注解是修飾類型的注解，可以作用域類、接口、枚舉等類型。然后我們還看到@Retention的參數(shù)是RetentionPolicy.RUNTIME類型的，說明該注解一直被保留到運(yùn)行時(shí)。

注解是使用@Interface來聲明的，這與接口的什么類似。@Interface后方跟著的就是注解的名稱，本注解的名稱為CETypeAnnotation。其中有一個(gè)公有的（public）整數(shù)（int）類型的id屬性。該屬性的默認(rèn)值是0，具體如下所示。

2、注解的使用

下方代碼段是對(duì)上述注解的使用。因?yàn)樯鲜鰟?chuàng)建的注解是ElementType.TYPE類型的，所以我們就用該注解來修飾我們創(chuàng)建的一個(gè)類，也就是下方的TestClass。在注解修飾時(shí)，我們給id設(shè)置了一個(gè)值，也就是下方的id = 10。

3、使用反射獲取修飾類型注解的相關(guān)信息

接下來，我們就要在AnnotationTracker類中添加利用Java的“反射機(jī)制”來獲取相應(yīng)的TestClass類的注解的相關(guān)信息了，關(guān)鍵代碼如下所示。trackTypeAnnotation()方法的參數(shù)是一個(gè)Class類型，然后可以通過Class的getAnnotation()方法來獲取相應(yīng)類中的注解對(duì)象。如下方的紅框所示。

獲取完相應(yīng)的注解對(duì)象后，我們就可以獲取到相應(yīng)注解中的配置信息了。

4、測(cè)試用例以及測(cè)試結(jié)果

接下來我們就在Main方法中來調(diào)用AnnotationTracker類中的上述方法，并傳入TestClass，如下所示。下方是其打印結(jié)果。

四、其他類型的注解

上述我們?cè)敿?xì)的聊了ElementType.TYPE類型的注解，接下來我們來看一下其他類型的注解，以及這些注解的使用方式。

1、@Target(ElementType.CONSTRUCTOR)

接下來我們來創(chuàng)建一個(gè)修飾構(gòu)造器的注解。下方的CEConstructorAnnotation就是我們創(chuàng)建的用來修飾類構(gòu)造器的注解。其中的value字段的默認(rèn)值是一個(gè)空字符串。

2、@Target(ElementType.FIELD)

接下來我們就來創(chuàng)建一個(gè)修飾字段的注解，我們將該字段命名為CEFieldAnnotation，具體代碼如下所示：

3、@Target(ElementType.METHOD)

下方是我們創(chuàng)建的修飾方法的注解，我們將其命名為CEMethodAnnotation，具體代碼如下所示。

4、@Target(ElementType.PARAMETER)

下方是修飾方法中參數(shù)的注解，我們將其命名為，如下所示：

五、上述相關(guān)注解的使用

下方就是上述所定義的各種類型的注解的使用方式，各司其職。具體就不做過多贅述了。

六、使用反射機(jī)制獲取不同類型的注解信息

之前我們已經(jīng)聊了如何使用“Java”的反射機(jī)制來獲取相關(guān)注解的信息，下方我們將會(huì)分別獲取上述各種類型的注解的相關(guān)信息。下方代碼主要是AnnotationTracker中的相關(guān)代碼。

1、獲取修飾構(gòu)造器類型的注解信息

2、獲取修飾方法和方法參數(shù)的注解信息

3、獲取修飾字段的注解信息

4、測(cè)試用例以及輸出結(jié)果

今天的文章就先到這兒吧。

如果文中有什么錯(cuò)誤，歡迎指出。以免更多的人被誤導(dǎo)。

學(xué)習(xí)Java的同學(xué)注意了！?。?/strong>

學(xué)習(xí)過程中遇到什么問題或者想獲取學(xué)習(xí)資源的話，歡迎加入Java學(xué)習(xí)交流群495273252，我們一起學(xué)Java！