快捷導(dǎo)航

Java實現(xiàn)枚舉狀態(tài)轉(zhuǎn)換的方法詳解

更新時間：2025年04月03日 09:14:13 作者：好奇的菜鳥

在軟件開發(fā)中,我們經(jīng)常需要處理不同系統(tǒng)或模塊間的狀態(tài)轉(zhuǎn)換,今天,我將通過一個電商訂單與物流狀態(tài)的轉(zhuǎn)換案例,展示如何優(yōu)雅地實現(xiàn)枚舉間的互相轉(zhuǎn)換,需要的朋友可以參考下

場景描述

假設(shè)我們有一個電商系統(tǒng)，包含兩個核心狀態(tài)枚舉：

訂單狀態(tài)(OrderStatusEnum) - 描述訂單在電商系統(tǒng)中的生命周期
物流狀態(tài)(ShippingStatusEnum) - 描述訂單在物流系統(tǒng)中的流轉(zhuǎn)狀態(tài)

這兩個狀態(tài)密切相關(guān)但又不完全相同，我們需要在它們之間建立轉(zhuǎn)換關(guān)系。

枚舉定義

1. 訂單狀態(tài)枚舉

/**
 * 訂單狀態(tài)枚舉
 */
public enum OrderStatusEnum {
    UNPAID(0, "待支付"),
    PAID(1, "已支付"),
    PACKAGED(2, "已打包"),
    SHIPPED(3, "已發(fā)貨"),
    DELIVERED(4, "已送達"),
    COMPLETED(5, "已完成"),
    CANCELLED(10, "已取消"),
    REFUNDING(11, "退款中"),
    REFUNDED(12, "已退款");

    private final int code;
    private final String description;

    OrderStatusEnum(int code, String description) {
        this.code = code;
        this.description = description;
    }

    // 根據(jù)code獲取枚舉實例
    public static OrderStatusEnum fromCode(int code) {
        for (OrderStatusEnum status : values()) {
            if (status.code == code) {
                return status;
            }
        }
        throw new IllegalArgumentException("無效的訂單狀態(tài)碼: " + code);
    }

    // 轉(zhuǎn)換為物流狀態(tài)
    public ShippingStatusEnum toShippingStatus() {
        switch (this) {
            case UNPAID:
            case PAID:
            case CANCELLED:
            case REFUNDING:
            case REFUNDED:
                return null; // 這些訂單狀態(tài)沒有對應(yīng)的物流狀態(tài)
            case PACKAGED:
                return ShippingStatusEnum.PREPARING;
            case SHIPPED:
                return ShippingStatusEnum.IN_TRANSIT;
            case DELIVERED:
                return ShippingStatusEnum.DELIVERED;
            case COMPLETED:
                return ShippingStatusEnum.COMPLETED;
            default:
                throw new IllegalStateException("未知的訂單狀態(tài): " + this);
        }
    }

    // getters
    public int getCode() { return code; }
    public String getDescription() { return description; }
}

2. 物流狀態(tài)枚舉

/**
 * 物流狀態(tài)枚舉
 */
public enum ShippingStatusEnum {
    PREPARING(1, "準備中"),
    IN_TRANSIT(2, "運輸中"),
    DELIVERED(3, "已送達"),
    COMPLETED(4, "已完成"),
    RETURNING(10, "退貨中"),
    RETURNED(11, "已退貨");

    private final int code;
    private final String description;

    ShippingStatusEnum(int code, String description) {
        this.code = code;
        this.description = description;
    }

    // 根據(jù)code獲取枚舉實例
    public static ShippingStatusEnum fromCode(int code) {
        for (ShippingStatusEnum status : values()) {
            if (status.code == code) {
                return status;
            }
        }
        throw new IllegalArgumentException("無效的物流狀態(tài)碼: " + code);
    }

    // 轉(zhuǎn)換為訂單狀態(tài)
    public OrderStatusEnum toOrderStatus() {
        switch (this) {
            case PREPARING:
                return OrderStatusEnum.PACKAGED;
            case IN_TRANSIT:
                return OrderStatusEnum.SHIPPED;
            case DELIVERED:
                return OrderStatusEnum.DELIVERED;
            case COMPLETED:
                return OrderStatusEnum.COMPLETED;
            case RETURNING:
                return OrderStatusEnum.REFUNDING;
            case RETURNED:
                return OrderStatusEnum.REFUNDED;
            default:
                throw new IllegalStateException("未知的物流狀態(tài): " + this);
        }
    }

    // getters
    public int getCode() { return code; }
    public String getDescription() { return description; }
}

關(guān)鍵設(shè)計點解析

狀態(tài)映射關(guān)系：
- 不是所有訂單狀態(tài)都有對應(yīng)的物流狀態(tài)（如待支付、已取消等）
- 物流狀態(tài)可能觸發(fā)訂單狀態(tài)的變更（如退貨中對應(yīng)退款中）
轉(zhuǎn)換方法設(shè)計：
- 每個枚舉類內(nèi)部實現(xiàn)轉(zhuǎn)換方法，知道如何轉(zhuǎn)換為另一種狀態(tài)
- 方法命名直觀：toShippingStatus()和toOrderStatus()
null值處理：
- 當沒有對應(yīng)狀態(tài)時返回null，調(diào)用方需要處理這種情況
異常處理：
- 對非法狀態(tài)碼拋出明確的異常信息

使用示例

// 訂單狀態(tài)轉(zhuǎn)物流狀態(tài)
OrderStatusEnum orderStatus = OrderStatusEnum.SHIPPED;
ShippingStatusEnum shippingStatus = orderStatus.toShippingStatus();
System.out.println("訂單狀態(tài): " + orderStatus.getDescription() 
    + " → 物流狀態(tài): " + (shippingStatus != null ? shippingStatus.getDescription() : "無"));

// 物流狀態(tài)轉(zhuǎn)訂單狀態(tài)
ShippingStatusEnum shippingStatus = ShippingStatusEnum.RETURNING;
OrderStatusEnum orderStatus = shippingStatus.toOrderStatus();
System.out.println("物流狀態(tài): " + shippingStatus.getDescription() 
    + " → 訂單狀態(tài): " + orderStatus.getDescription());