Java 枚舉類型完整使用指南與最佳實踐

為什麼使用枚舉？

枚舉（enum）是 JDK 5 引入的特殊類，用於表示固定常量集合。相比傳統 public static final int 常量，枚舉提供：

• 類型安全：編譯期檢查，避免非法值傳入
• 命名空間隔離：EventStatus.DRAFT 避免常量衝突
• 豐富行為：可定義字段、方法、實現接口
• 單例保證：每個枚舉常量在 JVM 中唯一
• 序列化安全：自動處理序列化/反序列化

標準枚舉定義範例

package com.school.stereotype;

/**
 * 活動狀態枚舉
 */
public enum EventStatus {
    /** 未發布 */
    DRAFT("DRAFT", "未發布"),
    /** 已發布 */
    PUBLISHED("PUBLISHED", "已發布");

    private final String value;  // 數據庫存儲值
    private final String text;   // 前端顯示文本

    EventStatus(String value, String text) {
        this.value = value;
        this.text = text;
    }

    public String getValue() { return value; }
    public String getText() { return text; }

    /**
     * 根據值反查枚舉實例
     * @param value 數據庫值
     * @return 對應枚舉
     * @throws IllegalArgumentException 無匹配值
     */
    public static EventStatus getInstance(String value) {
        for (EventStatus status : values()) {
            if (status.value.equalsIgnoreCase(value)) {
                return status;
            }
        }
        throw new IllegalArgumentException("非法狀態值: " + value);
    }
}

進階用法模式

1. 實現接口實現多態行為

public enum Operation implements Calculator {
    ADD("+") { public int apply(int a, int b) { return a + b; } },
    SUB("-") { public int apply(int a, int b) { return a - b; } },
    MUL("*") { public int apply(int a, int b) { return a * b; } },
    DIV("/") { public int apply(int a, int b) { return a / b; } };

    private final String symbol;
    Operation(String symbol) { this.symbol = symbol; }
    public String getSymbol() { return symbol; }
}

interface Calculator {
    int apply(int a, int b);
}

2. 策略模式替代方案

public enum PayStrategy {
    ALIPAY("支付寶") {
        public void pay(double amount) { /* 支付寶邏輯 */ }
    },
    WECHAT("微信支付") {
        public void pay(double amount) { /* 微信邏輯 */ }
    };

    private final String name;
    PayStrategy(String name) { this.name = name; }
    public abstract void pay(double amount);
    public String getName() { return name; }
}

3. 狀態機實現

public enum OrderStatus {
    CREATED("已創建") {
        public OrderStatus next() { return PAID; }
        public boolean canCancel() { return true; }
    },
    PAID("已支付") {
        public OrderStatus next() { return SHIPPED; }
        public boolean canCancel() { return false; }
    },
    SHIPPED("已發貨"),
    COMPLETED("已完成");

    private final String desc;
    OrderStatus(String desc) { this.desc = desc; }
    OrderStatus() { this(""); }

    public abstract OrderStatus next();
    public abstract boolean canCancel();
    public String getDesc() { return desc; }
}

常用內置方法

最佳實踐建議

1. 字段用 final：保證不可變性
2. 構造器私有：枚舉構造器默認 private，不可實例化
3. 提供反查方法：如 getInstance() 避免散落的 switch-case
4. 優先用枚舉實現單例：public enum Singleton { INSTANCE; } 線程安全、防反射、防序列化破壞
5. 避免過度設計：簡單狀態用基本枚舉，複雜行為考慮策略模式

序列化與數據庫映射

• JPA @Enumerated(EnumType.STRING) 存儲名稱，EnumType.ORDINAL 存儲順序（不推薦）
• MyBatis 可通過 TypeHandler 自定義映射
• JSON 序列化建議輸出 value 或 text，而非 name