萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Java Enum 枚舉類型完整指南:定義、方法、介面實作與最佳實踐

為什麼要用 Enum?

Enum(列舉型別)是「固定常數集合」的類型安全表示。相比 public static final int 常數,Enum 提供:

  • 類型安全:編譯期檢查,避免傳入非法整數
  • 命名空間:EventStatus.PUBLISHED 避免命名衝突
  • 豐富行為:可攜帶欄位、方法、實作介面
  • 單例保證:JVM 保證每個枚舉常數在 JVM 中唯一
  • 序列化安全:自動防止反序列化建立新實例

基礎定義與欄位

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 + ")";
    }
}

進階用法

1. 實作介面

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; }
}

2. 每個常數擁有不同行為(常數特定方法主體)

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

3. EnumMap 與 EnumSet:高效集合

// 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);

4. Switch 表達式(Java 12+)

String description = switch (status) {
    case DRAFT -> "草稿狀態,可編輯";
    case PUBLISHED -> "已發布,公開可見";
    case ARCHIVED -> "已歸檔,唯讀";
    case CANCELLED -> "已取消,不可恢復";
};

常見坑與注意事項

問題解決/說明
序列化後反序列化產生新實例Enum 自動處理,無需實作 Serializable,JVM 保證單例
switch 漏寫 caseJava 12+ switch 表達式強制 exhaustive,漏寫編譯報錯
建構子拋異常類別初始化失敗,導致整個 Enum 無法使用,避免在建構子做複雜邏輯
循環依賴Enum 常數初始化順序固定,避免常數間相互引用未初始化的欄位
資料庫映射JPA @Enumerated(EnumType.STRING) 儲存 name();MyBatis 可用 TypeHandler 映射 value

最佳實踐清單

  1. 枚舉常數全大寫、底線分隔(DRAFT、PUBLISHED)
  2. 欄位宣告 final,確保不可變
  3. 提供 fromValue() / fromCode() 靜態工廠方法,集中處理非法值
  4. 實作介面而非繼承類別(Enum 隱含繼承 java.lang.Enum,不可再繼承)
  5. 大量枚舉值時考慮效能:values() 每次呼叫都複製新陣列,熱點路徑可快取
  6. 文件化每個常數的業務含義與適用場景

總結

Java Enum 不只是常數列表,更是功能豐富的類別。善用 Enum 可大幅提升程式碼的可讀性、類型安全性與維護性。從簡單狀態機到複雜策略模式,Enum 都是領域建模的利器。

copyright © 萬盛學電腦網 all rights reserved