我上家公司php框架就是模仿java的註解路由，其實很簡單:就是透過方法獲取到類中的註解內容，然後透過字串解析，再進行呼叫方法

1、自定義註解與自定義xml實現功能相同，自定義註解應用方向很多，例如；系統監控、服務註冊(Dubbo)、登陸攔截等。

2、所有的java程式碼無論是不是自定義註解，都需要透過jvm執行。jvm就是一臺能執行位元組碼的虛擬機器器，它透過；載入、驗證、準備、解析、初始化、使用、解除安裝七個步驟。

3、程式碼學習最主要的是先執行出結果，然後分析原理。如果樓主沒有找到對應例子，可以找我要；

4、最後建議認真學習jvm，可以閱讀《java虛擬機器規範》與《用python實現jvm》，另外我個人寫了一版用java實現虛擬機器，更適合java程式設計師歡迎閱讀學習；https://github.com/fuzhengwei/itstack-demo-jvm

註解語法

因為平常開發少見，相信有不少的人員會認為註解的地位不高。其實同 classs 和 interface 一樣，註解也屬於一種型別。它是在 Java SE 5.0 版本中開始引入的概念。

註解的定義

註解透過 @interface 關鍵字進行定義。

它的形式跟介面很類似，不過前面多了一個 @ 符號。上面的程式碼就建立了一個名字為 TestAnnotaion 的註解。

你可以簡單理解為建立了一張名字為 TestAnnotation 的標籤。

註解的應用

上面建立了一個註解，那麼註解的的使用方法是什麼呢。

建立一個類 Test,然後在類定義的地方加上 @TestAnnotation 就可以用 TestAnnotation 註解這個類了。

你可以簡單理解為將 TestAnnotation 這張標籤貼到 Test 這個類上面。

不過，要想註解能夠正常工作，還需要介紹一下一個新的概念那就是元註解。

元註解

元註解是什麼意思呢？

元註解是可以註解到註解上的註解，或者說元註解是一種基本註解，但是它能夠應用到其它的註解上面。

如果難於理解的話，你可以這樣理解。元註解也是一張標籤，但是它是一張特殊的標籤，它的作用和目的就是給其他普通的標籤進行解釋說明的。

元標籤有 @Retention、@Documented、@Target、@Inherited、@Repeatable 5 種。

@Retention

Retention 的英文意為保留期的意思。當 @Retention 應用到一個註解上的時候，它解釋說明了這個註解的的存活時間。

它的取值如下：

RetentionPolicy.SOURCE 註解只在原始碼階段保留，在編譯器進行編譯時它將被丟棄忽視。RetentionPolicy.CLASS 註解只被保留到編譯進行的時候，它並不會被載入到 JVM 中。RetentionPolicy.RUNTIME 註解可以保留到程式執行的時候，它會被載入進入到 JVM 中，所以在程式執行時可以獲取到它們。

我們可以這樣的方式來加深理解，@Retention 去給一張標籤解釋的時候，它指定了這張標籤張貼的時間。@Retention 相當於給一張標籤上面蓋了一張時間戳，時間戳指明瞭標籤張貼的時間週期。

上面的程式碼中，我們指定 TestAnnotation 可以在程式執行週期被獲取到，因此它的生命週期非常的長。

@Documented

顧名思義，這個元註解肯定是和文件有關。它的作用是能夠將註解中的元素包含到 Javadoc 中去。

@Target

Target 是目標的意思，@Target 指定了註解運用的地方。

你可以這樣理解，當一個註解被 @Target 註解時，這個註解就被限定了運用的場景。

類比到標籤，原本標籤是你想張貼到哪個地方就到哪個地方，但是因為 @Target 的存在，它張貼的地方就非常具體了，比如只能張貼到方法上、類上、方法引數上等等。@Target 有下面的取值

ElementType.ANNOTATION_TYPE 可以給一個註解進行註解ElementType.CONSTRUCTOR 可以給構造方法進行註解ElementType.FIELD 可以給屬性進行註解ElementType.LOCAL_VARIABLE 可以給區域性變數進行註解ElementType.METHOD 可以給方法進行註解ElementType.PACKAGE 可以給一個包進行註解ElementType.PARAMETER 可以給一個方法內的引數進行註解ElementType.TYPE 可以給一個型別進行註解，比如類、介面、列舉

@Inherited

Inherited 是繼承的意思，但是它並不是說註解本身可以繼承，而是說如果一個超類被 @Inherited 註解過的註解進行註解的話，那麼如果它的子類沒有被任何註解應用的話，那麼這個子類就繼承了超類的註解。 說的比較抽象。程式碼來解釋。

註解 Test 被 @Inherited 修飾，之後類 A 被 Test 註解，類 B 繼承 A,類 B 也擁有 Test 這個註解。

可以這樣理解：

老子非常有錢，所以人們給他貼了一張標籤叫做富豪。

老子的兒子長大後，只要沒有和老子斷絕父子關係，雖然別人沒有給他貼標籤，但是他自然也是富豪。

老子的孫子長大了，自然也是富豪。

這就是人們口中戲稱的富一代，富二代，富三代。雖然叫法不同，好像好多個標籤，但其實事情的本質也就是他們有一張共同的標籤，也就是老子身上的那張富豪的標籤。

@Repeatable

Repeatable 自然是可重複的意思。@Repeatable 是 Java 1.8 才加進來的，所以算是一個新的特性。

什麼樣的註解會多次應用呢？通常是註解的值可以同時取多個。

舉個例子，一個人他既是程式設計師又是產品經理,同時他還是個畫家。

注意上面的程式碼，@Repeatable 註解了 Person。而 @Repeatable 後面括號中的類相當於一個容器註解。

什麼是容器註解呢？就是用來存放其它註解的地方。它本身也是一個註解。

我們再看看程式碼中的相關容器註解。

按照規定，它裡面必須要有一個 value 的屬性，屬性型別是一個被 @Repeatable 註解過的註解陣列，注意它是陣列。

如果不好理解的話，可以這樣理解。Persons 是一張總的標籤，上面貼滿了 Person 這種同類型但內容不一樣的標籤。把 Persons 給一個 SuperMan 貼上，相當於同時給他貼了程式設計師、產品經理、畫家的標籤。

我們可能對於 @Person(role=”PM”) 括號裡面的內容感興趣，它其實就是給 Person 這個註解的 role 屬性賦值為 PM ，大家不明白正常，馬上就講到註解的屬性這一塊。

註解的屬性

註解的屬性也叫做成員變數。註解只有成員變數，沒有方法。註解的成員變數在註解的定義中以“無形參的方法”形式來宣告，其方法名定義了該成員變數的名字，其返回值定義了該成員變數的型別。@Target(ElementType.TYPE)@Retention(RetentionPolicy.RUNTIME)public @interface TestAnnotation { int id(); String msg();}

上面程式碼定義了 TestAnnotation 這個註解中擁有 id 和 msg 兩個屬性。在使用的時候，我們應該給它們進行賦值。

賦值的方式是在註解的括號內以 value=”” 形式，多個屬性之前用 ，隔開。

需要注意的是，在註解中定義屬性時它的型別必須是 8 種基本資料型別外加 類、介面、註解及它們的陣列。

註解中屬性可以有預設值，預設值需要用 default 關鍵值指定。比如：

TestAnnotation 中 id 屬性預設值為 -1，msg 屬性預設值為 Hi。 它可以這樣應用。

因為有預設值，所以無需要再在 @TestAnnotation 後面的括號裡面進行賦值了，這一步可以省略。

另外，還有一種情況。如果一個註解內僅僅只有一個名字為 value 的屬性時，應用這個註解時可以直接接屬性值填寫到括號內。

上面程式碼中，Check 這個註解只有 value 這個屬性。所以可以這樣應用。

這和下面的效果是一樣的

最後，還需要注意的一種情況是一個註解沒有任何屬性。比

那麼在應用這個註解的時候，括號都可以省略。

Java 預置的註解

學習了上面相關的知識，我們已經可以自己定義一個註解了。其實 Java 語言本身已經提供了幾個現成的註解。

@Deprecated

這個元素是用來標記過時的元素，想必大家在日常開發中經常碰到。編譯器在編譯階段遇到這個註解時會發出提醒警告，告訴開發者正在呼叫一個過時的元素比如過時的方法、過時的類、過時的成員變數。

@Override

這個大家應該很熟悉了，提示子類要複寫父類中被 @Override 修飾的方法

@SuppressWarnings

阻止警告的意思。之前說過呼叫被 @Deprecated 註解的方法後，編譯器會警告提醒，而有時候開發者會忽略這種警告，他們可以在呼叫的地方透過 @SuppressWarnings 達到目的。

@SafeVarargs

引數安全型別註解。它的目的是提醒開發者不要用引數做一些不安全的操作,它的存在會阻止編譯器產生 unchecked 這樣的警告。它是在 Java 1.7 的版本中加入的。

Java 官方文件說，未來的版本會授權編譯器對這種不安全的操作產生錯誤警告。

@FunctionalInterface

函式式介面註解，這個是 Java 1.8 版本引入的新特性。函數語言程式設計很火，所以 Java 8 也及時添加了這個特性。

函式式介面 (Functional Interface) 就是一個具有一個方法的普通介面。

我們進行執行緒開發中常用的 Runnable 就是一個典型的函式式介面，上面原始碼可以看到它就被 @FunctionalInterface 註解。

可能有人會疑惑，函式式介面標記有什麼用，這個原因是函式式介面可以很容易轉換為 Lambda 表示式。這是另外的主題了，有興趣的同學請自己搜尋相關知識點學習。

註解的提取

博文前面的部分講了註解的基本語法，現在是時候檢測我們所學的內容了。

我透過用標籤來比作註解，前面的內容是講怎麼寫註解，然後貼到哪個地方去，而現在我們要做的工作就是檢閱這些標籤內容。 形象的比喻就是你把這些註解標籤在合適的時候撕下來，然後檢閱上面的內容資訊。

要想正確檢閱註解，離不開一個手段，那就是反射。

註解與反射。

註解透過反射獲取。首先可以透過 Class 物件的 isAnnotationPresent() 方法判斷它是否應用了某個註解。

註解的使用場景

我相信博文講到這裡大家都很熟悉了註解，但是有不少同學肯定會問，註解到底有什麼用呢？

對啊註解到底有什麼用？

我們不妨將目光放到 Java 官方文件上來。

文章開始的時候，我用標籤來類比註解。但標籤比喻只是我的手段，而不是目的。為的是讓大家在初次學習註解時能夠不被那些抽象的新概念搞懵。既然現在，我們已經對註解有所瞭解，我們不妨再仔細閱讀官方最嚴謹的文件。

註解是一系列元資料，它提供資料用來解釋程式程式碼，但是註解並非是所解釋的程式碼本身的一部分。註解對於程式碼的執行效果沒有直接影響。

註解有許多用處，主要如下：

提供資訊給編譯器： 編譯器可以利用註解來探測錯誤和警告資訊編譯階段時的處理： 軟體工具可以用來利用註解資訊來生成程式碼、Html文件或者做其它相應處理。執行時的處理： 某些註解可以在程式執行的時候接受程式碼的提取值得注意的是，註解不是程式碼本身的一部分。

如果難於理解，可以這樣看。標籤只是某些人對於其他事物的評價，但是標籤不會改變事物本身，標籤只是特定人群的手段。所以，註解同樣無法改變程式碼本身，註解只是某些工具的的工具。

還是回到官方文件的解釋上，註解主要針對的是編譯器和其它工具軟體(SoftWare tool)。

當開發者使用了Annotation 修飾了類、方法、Field 等成員之後，這些 Annotation 不會自己生效，必須由開發者提供相應的程式碼來提取並處理 Annotation 資訊。這些處理提取和處理 Annotation 的程式碼統稱為 APT（Annotation Processing Tool)。

現在，我們可以給自己答案了，註解有什麼用？給誰用？給 編譯器或者 APT 用的。

如果，你還是沒有搞清楚的話，我親自寫一個好了。

總結

如果註解難於理解，你就把它類同於標籤，標籤為了解釋事物，註解為了解釋程式碼。註解的基本語法，建立如同介面，但是多了個 @ 符號。註解的元註解。註解的屬性。註解主要給編譯器及工具型別的軟體用的。註解的提取需要藉助於 Java 的反射技術，反射比較慢，所以註解使用時也需要謹慎計較時間成本。

註解是用來描述Java類的，可以自定義註解，然後透過反射獲取註解執行指定的動作。

舉個簡單的例子

這樣就可以透過反射來獲取到一些元資訊了，相當於配置和業務邏輯實現了分離。

當然這個自定義註解還需要依賴一些特定的註解，我們稱為元註解。一共有5種：

@Retention：存活的週期

RetentionPolicy.SOURCE

保留在原始碼階段

RetentionPolicy.CLASS

編譯

RetentionPolicy,RUNTIME 執行階段

@Documented 將註解中的元素包含到JavaDoc中

@Target 註解可以用到的地方 有類、方法、屬性等

@Inherited 繼承

@Repeatable 可重複

Java的註釋和C/C++差不多，用“//”標註單句和 “/* */“標註多句。但是Java可以透過annotation標記幫助透過註解形成文件。

什麼是註解

註解是在Java5.0版本中被引入，其目的是用於描述資料，我們可以把他當作標籤，每加上一個註解就相當於給類/方法/欄位貼上來標籤，而標籤的作用我們很明白，透過標籤我們可以知道這個類/方法/欄位是做什麼的。

為什麼使用註解

在程式開發中，如果我們看到@Override，我們是很容易理解它的作用就是對實現方法的重寫，而這也達到設計之初的目標，即描述資料。

繼續以Override為例子，我們在實現父類方法的時候通常會帶上該註解，但是我們不帶也不會對執行有任何影響，但是如果我們把註解放到非實現的方法上，編譯就會報錯。也就是說註解會告訴編譯我是做什麼的，如果我做的和預期不一樣，那麼編譯器會對我們程式進行糾錯，即對不合註解含義的業務進行處理(這個處理不是註解去處理，只是看上去像是註解的作用)。

註解如何工作

對於@Override使用在非父類方法上編譯報錯的情況，我們最初接觸的時候可能會認為這些報錯的作用是註解的作用，但是實際上並不全是，這是因為註解僅僅是標籤亦或者說是元資料。他的作用一開始僅僅是為類描述資料，而後衍生出來的各種功能是由前端編譯器在編譯成class的時候會有一個專門的註解處理器，是他在編譯過程中對諸多註解，如@Override，會有專門的程式碼完成@Override標誌的業務邏輯。簡單的說，註解只是標籤，而標籤具有的功能是由前端編譯器

在生成語法樹之後有專門的程式碼去實現。

如果我們有使用自定義註解的經驗，我們會發現如果我們單單定義一個註解放在類/方法/欄位上，那麼它只有一個標籤的效果，並沒有什麼實際的意義，比如我們自定義NotEmpty註解，表達不能為空，我們將其註解加入到欄位上，即使傳空也沒有任何問題，這是因為沒有相應業務的支援。如果想要達到想要的效果，我們就需要專門寫業務邏輯去實現這個NotEmpty功能