Enum(列舉型別)是「固定常數集合」的類型安全表示。相比 public static final int 常數,Enum 提供:
EventStatus.PUBLISHED 避免命名衝突package com.school.stereotype;
/**
* 活動狀態枚舉
*/
public enum EventStatus {
// 枚舉常數(必須在最前面)
DRAFT("DRAFT", "未發布"),
PUBLISHED("PUBLISHED", "已發布"),
ARCHIVED("ARCHIVED", "已歸檔"),
CANCELLED("CANCELLED", "已取消");
// 私有欄位
private final String value; // 資料庫儲存值
private final String text; // 顯示用中文描述
// 私有建構子(枚舉建構子只能是 private)
EventStatus(String value, String text) {
this.value = value;
this.text = text;
}
// Getter
public String getValue() { return value; }
public String getText() { return text; }
// 靜態查找方法
public static EventStatus fromValue(String value) {
for (EventStatus status : values()) {
if (status.value.equalsIgnoreCase(value)) {
return status;
}
}
throw new IllegalArgumentException("無效的狀態值:" + value);
}
// 覆寫 toString 方便除錯
@Override
public String toString() {
return name() + "(" + value + ", " + text + ")";
}
}
public interface Displayable {
String getDisplayName();
}
public enum Priority implements Displayable {
LOW("LOW", "低", "🟢"),
MEDIUM("MEDIUM", "中", "🟡"),
HIGH("HIGH", "高", "🔴"),
URGENT("URGENT", "緊急", "🚨");
private final String code;
private final String label;
private final String icon;
Priority(String code, String label, String icon) {
this.code = code;
this.label = label;
this.icon = icon;
}
@Override
public String getDisplayName() {
return icon + " " + label;
}
public String getCode() { return code; }
}
public enum Operation {
PLUS("+") {
public double apply(double x, double y) { return x + y; }
},
MINUS("-") {
public double apply(double x, double y) { return x - y; }
},
TIMES("*") {
public double apply(double x, double y) { return x * y; }
},
DIVIDE("/") {
public double apply(double x, double y) { return x / y; }
};
private final String symbol;
Operation(String symbol) { this.symbol = symbol; }
public abstract double apply(double x, double y);
@Override public String toString() { return symbol; }
}
// 使用
double result = Operation.PLUS.apply(3, 4); // 7.0
// EnumMap:鍵為 Enum 的 Map,內部用陣列,極快
EnumMap countMap = new EnumMap<>(EventStatus.class);
countMap.put(EventStatus.DRAFT, 10);
countMap.put(EventStatus.PUBLISHED, 5);
// EnumSet:Enum 專用 Set,位向量實現,極快且記憶體小
EnumSet activeStatuses = EnumSet.of(EventStatus.DRAFT, EventStatus.PUBLISHED);
EnumSet all = EnumSet.allOf(EventStatus.class);
EnumSet none = EnumSet.noneOf(EventStatus.class);
String description = switch (status) {
case DRAFT -> "草稿狀態,可編輯";
case PUBLISHED -> "已發布,公開可見";
case ARCHIVED -> "已歸檔,唯讀";
case CANCELLED -> "已取消,不可恢復";
};
| 問題 | 解決/說明 |
|---|---|
| 序列化後反序列化產生新實例 | Enum 自動處理,無需實作 Serializable,JVM 保證單例 |
| switch 漏寫 case | Java 12+ switch 表達式強制 exhaustive,漏寫編譯報錯 |
| 建構子拋異常 | 類別初始化失敗,導致整個 Enum 無法使用,避免在建構子做複雜邏輯 |
| 循環依賴 | Enum 常數初始化順序固定,避免常數間相互引用未初始化的欄位 |
| 資料庫映射 | JPA @Enumerated(EnumType.STRING) 儲存 name();MyBatis 可用 TypeHandler 映射 value |
DRAFT、PUBLISHED)final,確保不可變fromValue() / fromCode() 靜態工廠方法,集中處理非法值java.lang.Enum,不可再繼承)values() 每次呼叫都複製新陣列,熱點路徑可快取Java Enum 不只是常數列表,更是功能豐富的類別。善用 Enum 可大幅提升程式碼的可讀性、類型安全性與維護性。從簡單狀態機到複雜策略模式,Enum 都是領域建模的利器。