:notebook: 本文已歸檔到:「blog」java
:keyboard: 本文中的示例代碼已歸檔到:「javacore」git
enum
的全稱爲 enumeration, 是 JDK5 中引入的特性。github
在 Java 中,被 enum
關鍵字修飾的類型就是枚舉類型。形式以下:編程
enum ColorEn { RED, GREEN, BLUE }
複製代碼
枚舉的好處:能夠將常量組織起來,統一進行管理。設計模式
枚舉的典型應用場景:錯誤碼、狀態機等。數組
java.lang.Enum
類聲明安全
public abstract class Enum<E extends Enum<E>> implements Comparable<E>, Serializable { ... }
複製代碼
新建一個 ColorEn.java 文件,內容以下:bash
package io.github.dunwu.javacore.enumeration;
public enum ColorEn {
RED,YELLOW,BLUE
}
複製代碼
執行 javac ColorEn.java
命令,生成 ColorEn.class 文件。併發
而後執行 javap ColorEn.class
命令,輸出以下內容:app
Compiled from "ColorEn.java"
public final class io.github.dunwu.javacore.enumeration.ColorEn extends java.lang.Enum<io.github.dunwu.javacore.enumeration.ColorEn> {
public static final io.github.dunwu.javacore.enumeration.ColorEn RED;
public static final io.github.dunwu.javacore.enumeration.ColorEn YELLOW;
public static final io.github.dunwu.javacore.enumeration.ColorEn BLUE;
public static io.github.dunwu.javacore.enumeration.ColorEn[] values();
public static io.github.dunwu.javacore.enumeration.ColorEn valueOf(java.lang.String);
static {};
}
複製代碼
:bulb: 說明:
從上面的例子能夠看出:
枚舉的本質是
java.lang.Enum
的子類。儘管
enum
看起來像是一種新的數據類型,事實上,enum 是一種受限制的類,而且具備本身的方法。枚舉這種特殊的類由於被修飾爲final
,因此不能繼承其餘類。定義的枚舉值,會被默認修飾爲
public static final
,從修飾關鍵字,便可看出枚舉值本質上是靜態常量。
在 enum 中,提供了一些基本方法:
values()
:返回 enum 實例的數組,並且該數組中的元素嚴格保持在 enum 中聲明時的順序。name()
:返回實例名。ordinal()
:返回實例聲明時的次序,從 0 開始。getDeclaringClass()
:返回實例所屬的 enum 類型。equals()
:判斷是否爲同一個對象。可使用 ==
來比較enum
實例。
此外,java.lang.Enum
實現了Comparable
和 Serializable
接口,因此也提供 compareTo()
方法。
例:展現 enum 的基本方法
public class EnumMethodDemo {
enum Color {RED, GREEN, BLUE;}
enum Size {BIG, MIDDLE, SMALL;}
public static void main(String args[]) {
System.out.println("=========== Print all Color ===========");
for (Color c : Color.values()) {
System.out.println(c + " ordinal: " + c.ordinal());
}
System.out.println("=========== Print all Size ===========");
for (Size s : Size.values()) {
System.out.println(s + " ordinal: " + s.ordinal());
}
Color green = Color.GREEN;
System.out.println("green name(): " + green.name());
System.out.println("green getDeclaringClass(): " + green.getDeclaringClass());
System.out.println("green hashCode(): " + green.hashCode());
System.out.println("green compareTo Color.GREEN: " + green.compareTo(Color.GREEN));
System.out.println("green equals Color.GREEN: " + green.equals(Color.GREEN));
System.out.println("green equals Size.MIDDLE: " + green.equals(Size.MIDDLE));
System.out.println("green equals 1: " + green.equals(1));
System.out.format("green == Color.BLUE: %b\n", green == Color.BLUE);
}
}
複製代碼
輸出
=========== Print all Color ===========
RED ordinal: 0
GREEN ordinal: 1
BLUE ordinal: 2
=========== Print all Size ===========
BIG ordinal: 0
MIDDLE ordinal: 1
SMALL ordinal: 2
green name(): GREEN
green getDeclaringClass(): class org.zp.javase.enumeration.EnumDemo$Color
green hashCode(): 460141958
green compareTo Color.GREEN: 0
green equals Color.GREEN: true
green equals Size.MIDDLE: false
green equals 1: false
green == Color.BLUE: false
複製代碼
枚舉的特性,歸結起來就是一句話:
除了不能繼承,基本上能夠將
enum
看作一個常規的類。
可是這句話須要拆分去理解,讓咱們細細道來。
若是枚舉中沒有定義方法,也能夠在最後一個實例後面加逗號、分號或什麼都不加。
若是枚舉中沒有定義方法,枚舉值默認爲從 0 開始的有序數值。以 Color 枚舉類型舉例,它的枚舉常量依次爲 RED:0,GREEN:1,BLUE:2
。
在概念章節提到了,枚舉值默認爲從 0 開始的有序數值 。那麼問題來了:如何爲枚舉顯式的賦值。
(1)Java 不容許使用 =
爲枚舉常量賦值
若是你接觸過 C/C++,你確定會很天然的想到賦值符號 =
。在 C/C++語言中的 enum,能夠用賦值符號=
顯式的爲枚舉常量賦值;可是 ,很遺憾,Java 語法中卻不容許使用賦值符號 =
爲枚舉常量賦值。
例:C/C++ 語言中的枚舉聲明
typedef enum {
ONE = 1,
TWO,
THREE = 3,
TEN = 10
} Number;
複製代碼
(2)枚舉能夠添加普通方法、靜態方法、抽象方法、構造方法
Java 雖然不能直接爲實例賦值,可是它有更優秀的解決方案:爲 enum 添加方法來間接實現顯式賦值。
建立 enum
時,能夠爲其添加多種方法,甚至能夠爲其添加構造方法。
注意一個細節:若是要爲 enum 定義方法,那麼必須在 enum 的最後一個實例尾部添加一個分號。此外,在 enum 中,必須先定義實例,不能將字段或方法定義在實例前面。不然,編譯器會報錯。
例:全面展現如何在枚舉中定義普通方法、靜態方法、抽象方法、構造方法
public enum ErrorCodeEn {
OK(0) {
@Override
public String getDescription() {
return "成功";
}
},
ERROR_A(100) {
@Override
public String getDescription() {
return "錯誤A";
}
},
ERROR_B(200) {
@Override
public String getDescription() {
return "錯誤B";
}
};
private int code;
// 構造方法:enum的構造方法只能被聲明爲private權限或不聲明權限
private ErrorCodeEn(int number) { // 構造方法
this.code = number;
}
public int getCode() { // 普通方法
return code;
} // 普通方法
public abstract String getDescription(); // 抽象方法
public static void main(String args[]) { // 靜態方法
for (ErrorCodeEn s : ErrorCodeEn.values()) {
System.out.println("code: " + s.getCode() + ", description: " + s.getDescription());
}
}
}
// Output:
// code: 0, description: 成功
// code: 100, description: 錯誤A
// code: 200, description: 錯誤B
複製代碼
注:上面的例子並不可取,僅僅是爲了展現枚舉支持定義各類方法。正確的例子狀況錯誤碼示例
enum
能夠像通常類同樣實現接口。
一樣是實現上一節中的錯誤碼枚舉類,經過實現接口,能夠約束它的方法。
public interface INumberEnum {
int getCode();
String getDescription();
}
public enum ErrorCodeEn2 implements INumberEnum {
OK(0, "成功"),
ERROR_A(100, "錯誤A"),
ERROR_B(200, "錯誤B");
ErrorCodeEn2(int number, String description) {
this.code = number;
this.description = description;
}
private int code;
private String description;
@Override
public int getCode() {
return code;
}
@Override
public String getDescription() {
return description;
}
}
複製代碼
enum 不能夠繼承另一個類,固然,也不能繼承另外一個 enum 。
由於 enum
實際上都繼承自 java.lang.Enum
類,而 Java 不支持多重繼承,因此 enum
不能再繼承其餘類,固然也不能繼承另外一個 enum
。
在 JDK5 以前,在 Java 中定義常量都是public static final TYPE a;
這樣的形式。有了枚舉,你能夠將有關聯關係的常量組織起來,使代碼更加易讀、安全,而且還可使用枚舉提供的方法。
下面三種聲明方式是等價的:
enum Color { RED, GREEN, BLUE }
enum Color { RED, GREEN, BLUE, }
enum Color { RED, GREEN, BLUE; }
複製代碼
咱們常用 switch 語句來寫狀態機。JDK7 之後,switch 已經支持 int
、char
、String
、enum
類型的參數。這幾種類型的參數比較起來,使用枚舉的 switch 代碼更具備可讀性。
public class StateMachineDemo {
public enum Signal {
GREEN, YELLOW, RED
}
public static String getTrafficInstruct(Signal signal) {
String instruct = "信號燈故障";
switch (signal) {
case RED:
instruct = "紅燈停";
break;
case YELLOW:
instruct = "黃燈請注意";
break;
case GREEN:
instruct = "綠燈行";
break;
default:
break;
}
return instruct;
}
public static void main(String[] args) {
System.out.println(getTrafficInstruct(Signal.RED));
}
}
// Output:
// 紅燈停
複製代碼
枚舉常被用於定義程序錯誤碼。下面是一個簡單示例:
public class ErrorCodeEnumDemo {
enum ErrorCodeEn {
OK(0, "成功"),
ERROR_A(100, "錯誤A"),
ERROR_B(200, "錯誤B");
ErrorCodeEn(int number, String msg) {
this.code = number;
this.msg = msg;
}
private int code;
private String msg;
public int getCode() {
return code;
}
public String getMsg() {
return msg;
}
@Override
public String toString() {
return "ErrorCodeEn{" + "code=" + code + ", msg='" + msg + '\'' + '}';
}
public static String toStringAll() {
StringBuilder sb = new StringBuilder();
sb.append("ErrorCodeEn All Elements: [");
for (ErrorCodeEn code : ErrorCodeEn.values()) {
sb.append(code.getCode()).append(", ");
}
sb.append("]");
return sb.toString();
}
}
public static void main(String[] args) {
System.out.println(ErrorCodeEn.toStringAll());
for (ErrorCodeEn s : ErrorCodeEn.values()) {
System.out.println(s);
}
}
}
// Output:
// ErrorCodeEn All Elements: [0, 100, 200, ]
// ErrorCodeEn{code=0, msg='成功'}
// ErrorCodeEn{code=100, msg='錯誤A'}
// ErrorCodeEn{code=200, msg='錯誤B'}
複製代碼
能夠將類型相近的枚舉經過接口或類組織起來,可是通常用接口方式進行組織。
緣由是:Java 接口在編譯時會自動爲 enum 類型加上public static
修飾符;Java 類在編譯時會自動爲 enum
類型加上 static 修飾符。看出差別了嗎?沒錯,就是說,在類中組織 enum
,若是你不給它修飾爲 public
,那麼只能在本包中進行訪問。
例:在接口中組織 enum
public class EnumInInterfaceDemo {
public interface INumberEnum {
int getCode();
String getDescription();
}
public interface Plant {
enum Vegetable implements INumberEnum {
POTATO(0, "土豆"),
TOMATO(0, "西紅柿");
Vegetable(int number, String description) {
this.code = number;
this.description = description;
}
private int code;
private String description;
@Override
public int getCode() {
return this.code;
}
@Override
public String getDescription() {
return this.description;
}
}
enum Fruit implements INumberEnum {
APPLE(0, "蘋果"),
ORANGE(0, "桔子"),
BANANA(0, "香蕉");
Fruit(int number, String description) {
this.code = number;
this.description = description;
}
private int code;
private String description;
@Override
public int getCode() {
return this.code;
}
@Override
public String getDescription() {
return this.description;
}
}
}
public static void main(String[] args) {
for (Plant.Fruit f : Plant.Fruit.values()) {
System.out.println(f.getDescription());
}
}
}
// Output:
// 蘋果
// 桔子
// 香蕉
複製代碼
例:在類中組織 enum
本例和上例效果相同。
public class EnumInClassDemo {
public interface INumberEnum {
int getCode();
String getDescription();
}
public static class Plant2 {
enum Vegetable implements INumberEnum {
// 略,與上面徹底相同
}
enum Fruit implements INumberEnum {
// 略,與上面徹底相同
}
}
// 略
}
// Output:
// 土豆
// 西紅柿
複製代碼
Effective Java 中展現了一種策略枚舉。這種枚舉經過枚舉嵌套枚舉的方式,將枚舉常量分類處理。
這種作法雖然沒有 switch 語句簡潔,可是更加安全、靈活。
例:EffectvieJava 中的策略枚舉範例
enum PayrollDay {
MONDAY(PayType.WEEKDAY), TUESDAY(PayType.WEEKDAY), WEDNESDAY(
PayType.WEEKDAY), THURSDAY(PayType.WEEKDAY), FRIDAY(PayType.WEEKDAY), SATURDAY(
PayType.WEEKEND), SUNDAY(PayType.WEEKEND);
private final PayType payType;
PayrollDay(PayType payType) {
this.payType = payType;
}
double pay(double hoursWorked, double payRate) {
return payType.pay(hoursWorked, payRate);
}
// 策略枚舉
private enum PayType {
WEEKDAY {
double overtimePay(double hours, double payRate) {
return hours <= HOURS_PER_SHIFT ? 0 : (hours - HOURS_PER_SHIFT)
* payRate / 2;
}
},
WEEKEND {
double overtimePay(double hours, double payRate) {
return hours * payRate / 2;
}
};
private static final int HOURS_PER_SHIFT = 8;
abstract double overtimePay(double hrs, double payRate);
double pay(double hoursWorked, double payRate) {
double basePay = hoursWorked * payRate;
return basePay + overtimePay(hoursWorked, payRate);
}
}
}
複製代碼
測試
System.out.println("時薪100的人在週五工做8小時的收入:" + PayrollDay.FRIDAY.pay(8.0, 100));
System.out.println("時薪100的人在週六工做8小時的收入:" + PayrollDay.SATURDAY.pay(8.0, 100));
複製代碼
單例模式是最經常使用的設計模式。
單例模式在併發環境下存在線程安全問題。
爲了線程安全問題,傳統作法有如下幾種:
相比上述的方法,使用枚舉也能夠實現單例,並且還更加簡單:
public class SingleEnumDemo {
public enum SingleEn {
INSTANCE;
private String name;
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}
public static void main(String[] args) {
SingleEn.INSTANCE.setName("zp");
System.out.println(SingleEn.INSTANCE.getName());
}
}
複製代碼
擴展閱讀:深刻理解 Java 枚舉類型(enum)
這篇文章對於 Java 枚舉的特性講解很仔細,其中對於枚舉實現單例和傳統單例實現方式說的尤其細緻。
Java 中提供了兩個方便操做 enum 的工具類——EnumSet
和 EnumMap
。
EnumSet
是枚舉類型的高性能 Set
實現。它要求放入它的枚舉常量必須屬於同一枚舉類型。
主要接口:
noneOf
- 建立一個具備指定元素類型的空 EnumSetallOf
- 建立一個指定元素類型幷包含全部枚舉值的 EnumSetrange
- 建立一個包括枚舉值中指定範圍元素的 EnumSetcomplementOf
- 初始集合包括指定集合的補集of
- 建立一個包括參數中全部元素的 EnumSetcopyOf
- 建立一個包含參數容器中的全部元素的 EnumSet示例:
public class EnumSetDemo {
public static void main(String[] args) {
System.out.println("EnumSet展現");
EnumSet<ErrorCodeEn> errSet = EnumSet.allOf(ErrorCodeEn.class);
for (ErrorCodeEn e : errSet) {
System.out.println(e.name() + " : " + e.ordinal());
}
}
}
複製代碼
EnumMap
是專門爲枚舉類型量身定作的 Map
實現。雖然使用其它的 Map 實現(如 HashMap)也能完成枚舉類型實例到值得映射,可是使用 EnumMap 會更加高效:它只能接收同一枚舉類型的實例做爲鍵值,而且因爲枚舉類型實例的數量相對固定而且有限,因此 EnumMap 使用數組來存放與枚舉類型對應的值。這使得 EnumMap 的效率很是高。
主要接口:
size
- 返回鍵值對數containsValue
- 是否存在指定的 valuecontainsKey
- 是否存在指定的 keyget
- 根據指定 key 獲取 valueput
- 取出指定的鍵值對remove
- 刪除指定 keyputAll
- 批量取出鍵值對clear
- 清除數據keySet
- 獲取 key 集合values
- 返回全部示例:
public class EnumMapDemo {
public enum Signal {
GREEN, YELLOW, RED
}
public static void main(String[] args) {
System.out.println("EnumMap展現");
EnumMap<Signal, String> errMap = new EnumMap(Signal.class);
errMap.put(Signal.RED, "紅燈");
errMap.put(Signal.YELLOW, "黃燈");
errMap.put(Signal.GREEN, "綠燈");
for (Iterator<Map.Entry<Signal, String>> iter = errMap.entrySet().iterator(); iter.hasNext();) {
Map.Entry<Signal, String> entry = iter.next();
System.out.println(entry.getKey().name() + " : " + entry.getValue());
}
}
}
複製代碼
擴展閱讀:深刻理解 Java 枚舉類型(enum)
這篇文章中對 EnumSet 和 EnumMap 原理作了較爲詳細的介紹。