Github 上發現的Java列舉與註解手冊，竟斬獲了5份大廠 Offer！

一、列舉類

類的物件只有有限個, 確定的. 我們稱此類為列舉類.

說明：

類的物件只有有限個，確定的。如：星期：Monday(星期一)、......、Sunday(星期天)性別：Man(男)、Woman(女) 季節：Spring(春節)......Winter(冬天)支付方式：Cash（現金）、WeChatPay（微信）、Alipay(支付寶)、BankCard(銀 行卡)、CreditCard(信用卡)就職狀態：Busy、Free、Vocation、Dimission訂單狀態：Nonpayment（未付款）、Paid（已付款）、Delivered（已發貨）、 Return（退貨）、Checked（已確認）Fulfilled（已配貨）執行緒狀態：創建、就緒、運行、阻塞、死亡2.當需要定義一組常量時，強烈建議使用列舉類。

3.若列舉只有一個物件, 則可以作為一種單例模式的實現方式。

列舉類的實現：

JDK1.5之前需要自定義列舉類。JDK 1.5 新增的 enum 關鍵字用於定義列舉類。列舉類的屬性：

列舉類物件的屬性不應允許被改動, 所以應該使用 private final 修飾。列舉類的使用 private final 修飾的屬性應該在構造器中為其賦值。若列舉類顯式地定義了帶參數的構造器, 則在列出列舉值時也必須對應的 傳入參數。① 自定義列舉類#

通過自己寫一個自定義的類來實現自定義列舉類。

自定義列舉類的實現：

私有化類的構造器，保證不能在類的外部創建其物件。在類的內部創建列舉類的例項。聲明為：public static final。物件如果有例項變數，應該聲明為private final，並在構造器中初始化。Demo：

② enum關鍵字定義列舉類

通過使用enum關鍵字，和一些簡便的規則，更方便列舉類的創建

說明：

enum 列舉類是繼承 java.lang.Enum 類的，所以其中如果不重寫 toString 使用的是 java.lang.Enum 中的 toString，不會輸出記憶體地址，而是會列印物件名enum 列舉類的實現：

使用 enum 聲明類為列舉類。在列舉類的開頭首先定義列舉類中所需要的物件。列舉類對例項化列舉類的物件做了簡化只需要使用 物件名(參數···) 就可以完成例項化，如：PRING("春天", "春暖花開"), WINTER("冬天", "冰天雪地");多個物件用 「,」 隔開，最後一個以 「;」 結尾如果沒有屬性，可以去掉括號，如：PRING, WINTER;其餘規則均與自定義列舉類相同。Demo：

③ enum 列舉類的方法

values() ：返回列舉類型的物件陣列。該方法可以很方便地遍歷所有的 列舉值。valueOf(String str) ：可以把一個字元串轉為對應的列舉類物件。要求字元 串必須是列舉類物件的「名字」。如不是，會有運行時異常：IllegalArgumentException。toString()：返回當前列舉類物件常量的名稱。Demo：（列舉類使用上面程式碼的列舉類Season1）

④ enum 列舉類實現介面

enum 列舉類可以像正常類那樣實現介面並重寫介面中的方法但是 enum 列舉類還有其獨特的實現介面的方法, 介面類中的每個物件都可以獨自重寫實現介面的方法

enum 物件特有的實現介面的方法 :

物件名(構造器參數){ 需要重寫的方法 }, 如:

Demo:

二、註解

從 JDK 5.0 開始, Java 增加了對元資料(MetaData) 的支援, 也就是 Annotation(註解)Annotation 其實就是程式碼裡的特殊標記, 這些標記可以在編譯, 類加 載, 運行時被讀取, 並執行相應的處理。通過使用 Annotation, 程式設計師 可以在不改變原有邏輯的情況下, 在原始檔中嵌入一些補充資訊。程式碼分析工具、開發工具和部署工具可以通過這些補充資訊進行驗證 或者進行部署。Annotation 可以像修飾符一樣被使用, 可用於修飾包,類, 構造器, 方 法, 成員變數, 參數, 局部變數的聲明, 這些資訊被儲存在 Annotation 的 「name=value」 對中。在JavaSE中，註解的使用目的比較簡單，例如標記過時的功能， 忽略警告等。在JavaEE/Android中註解佔據了更重要的角色，例如 用來配置應用程式的任何切面，代替JavaEE舊版中所遺留的繁冗 程式碼和XML配置等。未來的開發模式都是基於註解的，JPA是基於註解的，Spring2.5以 上都是基於註解的，Hibernate3.x以後也是基於註解的，現在的 Struts2有一部分也是基於註解的了，註解是一種趨勢，一定程度上 可以說：框架 = 註解 + 反射 + 設計模式。使用 Annotation 時要在其前面增加 @ 符號, 並把該 Annotation 當成 一個修飾符使用。用於修飾它支援的程式元素① 生成文件相關注解

用法：

@author 標明開發該類模組的作者，多個作者之間使用,分割@version 標明該類模組的版本@see 參考轉向，也就是相關主題@since 從哪個版本開始增加的@param 對方法中某參數的說明，如果沒有參數就不能寫@return 對方法返回值的說明，如果方法的返回值類型是void就不能寫@exception 對方法可能拋出的異常進行說明 ，如果方法沒有用throws顯式拋出的異常就不能寫說明：

@param @return 和 @exception 這三個標記都是隻用於方法的。@param的格式要求：@param 形參名 形參類型 形參說明@return 的格式要求：@return 返回值類型 返回值說明@exception的格式要求：@exception 異常類型 異常說明@param和@exception可以並列多個Demo：

②註解在編譯時進行格式檢查#

編譯時，會強制校驗註解處的方法是否符合註解，如果不符合會報錯

JDK內建的三個基本註解：

@Override: 限定重寫父類方法, 該註解只能用於方法@Deprecated: 用於表示所修飾的元素(類, 方法, 屬性等·已過時。通常是因為 所修飾的結構危險或存在更好的選擇@SuppressWarnings: 抑制編譯器警告，消除某段程式碼在編譯器中的警告Demo：

③註解跟蹤程式碼的依賴性，實現替代配置檔案功能

Servlet3.0提供了註解(annotation),使得不再需要在web.xml檔案中進行Servlet的部署。

spring框架中關於「事務」的管理

④ 自定義註解#

說明：

定義新的 Annotation 類型使用 @interface 關鍵字自定義註解自動繼承了java.lang.annotation.Annotation介面Annotation 的成員變數在 Annotation 定義中以無參數方法的形式來聲明。其 方法名和返回值定義了該成員的名字和類型。我們稱為配置參數。類型只能 是八種基本資料類型、String類型、Class類型、enum類型、Annotation類型、 以上所有類型的陣列。可以在定義 Annotation 的成員變數時為其指定初始值, 指定成員變數的初始 值可使用 default 關鍵字如果只有一個參數成員，建議使用參數名為value如果定義的註解含有配置參數，那麼使用時必須指定參數值，除非它有預設 值。格式是「參數名 = 參數值」 ，如果只有一個參數成員，且名稱為value， 可以省略「value=」沒有成員定義的 Annotation 稱為標記; 包含成員變數的 Annotation 稱為元數 據 Annotation 注意：自定義註解必須配上註解的資訊處理流程才有意義。注意：自定義註解必須配上註解的資訊處理流程才有意義。（使用反射實現）

Demo:

⑤ jdk提供的4種元註解#

說明：

JDK 的元 Annotation 用於修飾其他 Annotation 定義JDK5.0提供了4個標準的meta-annotation類型，分別是：RetentionTargetDocumentedInherited元註解說明：

@Retention: 只能用於修飾一個 Annotation 定義, 用於指定該 Annotation 的生命 週期, @Rentention 包含一個 RetentionPolicy 類型的成員變數, 使用 @Rentention 時必須為該 value 成員變數指定值:**RetentionPolicy.SOURCE: **在原始檔中有效（即原始檔保留），編譯器直接丟棄這種策略的 註釋**RetentionPolicy.CLASS（預設）: **在class檔案中有效（即class保留） ， 當運行 Java 程式時, JVM 不會保留註解。 這是預設值RetentionPolicy.RUNTIME: 在運行時有效（即運行時保留），當運行 Java 程式時, JVM 會 保留註釋。程式可以通過反射獲取該註釋只有聲明為RUNTIME生命週期的註解，才能通過反射獲取。

@Target: 用於修飾 Annotation 定義, 用於指定被修飾的 Annotation 能用於 修飾那些程式元素。 @Target 也包含一個名為 value 的成員變數。

@Documented: 用於指定被該元 Annotation 修飾的 Annotation 類將被 javadoc 工具提取成文件。預設情況下，javadoc是不包括註解的。定義為Documented的註解必須設定Retention值為RUNTIME。@Inherited: 被它修飾的 Annotation 將具有繼承性。如果某個類使用了被 @Inherited 修飾的 Annotation, 則其子類將自動具有該註解。比如：如果把標有@Inherited註解的自定義的註解標註在類級別上，子類則可以 繼承父類類級別的註解實際應用中，使用較少元資料的理解：

String name ="13roky"

這個資料中13roky最為重要，String 和 name 都是對其進行修飾，那麼String 和 name 就可以叫做元資料：用於修飾資料的資料

⑥ JKD8 新特性：可重複註解#

JDK8 之前重複註解的實現：

JDK8 之前如果要同一位置加多個相同註解，需要使用陣列來新增。

JKD8 新特性：可重複註解：

在 MyAnnotation 上聲明 @Repeatable，成員值為 Annotations.classMyAnnotation 的 Targe , Inherited 和 Retention 與Annotations相同。Demo：

⑦ JDK8 新特性：類型註解#

可以理解為，類型註解就是對元註解@Target，新增的兩個參數類型TYPE_PARAMETER, TYPE_USE

說明：

在Java 8之前，註解只能是在聲明的地方所使用，Java8開始，註解可以應用 在任何地方。ElementType.TYPE_PARAMETER 表示該註解能寫在類型變數的聲明語 句中（如：泛型聲明）。ElementType.TYPE_USE 表示該註解能寫在使用類型的任何語句中。Demo:

各種Java資料，關注回覆小編獲取噢。