Java中枚舉的toString()和name()區(qū)別小結(jié)

更新時間：2025年08月15日 10:15:43 作者：布朗克168

本文主要介紹了Java中枚舉的toString()和name()區(qū)別小結(jié),name()返回原始名稱,不可重寫；toString()可重寫以提供更友好的描述,二者用于不同場景,下面就來具體了解一下

一、引言

在 Java 里，枚舉類型是一種特殊的類，toString() 與 name() 方法都和枚舉常量有關(guān)，但它們存在一些區(qū)別，下面為你詳細介紹

二、介紹

name() 方法
定義：name() 是 java.lang.Enum 類里的一個方法，所有枚舉類型都能繼承該方法。它的作用是返回枚舉常量的名稱，也就是在枚舉聲明中定義的標識符。
特點：返回值是固定的，不會受 toString() 方法重寫的影響，始終返回枚舉常量在代碼中定義的原始名稱。
toString() 方法
定義：toString() 是 java.lang.Object 類中的方法，所有 Java 類都有該方法。在枚舉類型中，默認情況下，toString() 方法的行為和 name() 方法一樣，會返回枚舉常量的名稱。不過，你可以重寫這個方法，讓它返回更具描述性的字符串。
特點：可以根據(jù)需求重寫，從而返回更有意義的信息，而不局限于枚舉常量的原始名稱。
下面的示例展示了 name() 和 toString() 方法的使用：

// 定義一個表示季節(jié)的枚舉
enum Season {
    SPRING,
    SUMMER,
    AUTUMN,
    WINTER;

    // 重寫 toString() 方法，讓其返回更具描述性的字符串
    @Override
    public String toString() {
        switch (this) {
            case SPRING:
                return "春季";
            case SUMMER:
                return "夏季";
            case AUTUMN:
                return "秋季";
            case WINTER:
                return "冬季";
            default:
                return super.toString();
        }
    }
}

public class EnumExample {
    public static void main(String[] args) {
        Season season = Season.SPRING;

        // 使用 name() 方法獲取枚舉常量的原始名稱
        System.out.println("name() 方法返回: " + season.name());

        // 使用 toString() 方法獲取枚舉常量的字符串表示
        System.out.println("toString() 方法返回: " + season.toString());
    }
}

在 Season 枚舉中，重寫了 toString() 方法，讓它返回中文的季節(jié)名稱。

在 main 方法里，先創(chuàng)建了一個 Season 枚舉類型的變量 season，并將其賦值為 SPRING。
調(diào)用 name() 方法時，返回的是枚舉常量的原始名稱 SPRING。
調(diào)用 toString() 方法時，由于重寫了該方法，返回的是更具描述性的字符串春季。

三、使用場景

在實際開發(fā)中，重寫枚舉的 toString() 方法通常是為了提供更具可讀性、更符合業(yè)務(wù)需求的字符串表示，以下是一些常見的使用場景：

增強用戶界面的顯示效果

當需要將枚舉值展示給用戶時，默認的枚舉常量名稱可能不夠友好。通過重寫 toString() 方法，可以提供更具描述性的文本，提升用戶體驗。
示例：

enum Gender {
    MALE,
    FEMALE;

    @Override
    public String toString() {
        switch (this) {
            case MALE:
                return "男性";
            case FEMALE:
                return "女性";
            default:
                return super.toString();
        }
    }
}

在用戶界面中顯示性別時，直接使用 Gender.MALE.toString() 會顯示 “男性”，而不是 “MALE”，這對用戶來說更直觀易懂。

日志記錄和調(diào)試

在日志記錄和調(diào)試過程中，更具描述性的枚舉值表示有助于快速定位問題。重寫 toString() 方法可以讓日志信息更清晰。
示例：

enum OrderStatus {
    CREATED,
    PAID,
    SHIPPED,
    COMPLETED;

    @Override
    public String toString() {
        switch (this) {
            case CREATED:
                return "訂單已創(chuàng)建";
            case PAID:
                return "訂單已支付";
            case SHIPPED:
                return "訂單已發(fā)貨";
            case COMPLETED:
                return "訂單已完成";
            default:
                return super.toString();
        }
    }
}

在記錄訂單狀態(tài)變化的日志時，使用 OrderStatus.PAID.toString() 可以記錄 “訂單已支付”，這樣的日志信息更具可讀性。

數(shù)據(jù)序列化和反序列化

在將枚舉值序列化為字符串或從字符串反序列化時，可能需要自定義的字符串表示。重寫 toString() 方法可以確保序列化和反序列化過程中使用的字符串符合業(yè)務(wù)需求。
示例：

enum PaymentMethod {
    CREDIT_CARD,
    PAYPAL,
    ALIPAY;

    @Override
    public String toString() {
        switch (this) {
            case CREDIT_CARD:
                return "信用卡支付";
            case PAYPAL:
                return "PayPal支付";
            case ALIPAY:
                return "支付寶支付";
            default:
                return super.toString();
        }
    }
}

在將支付方式信息存儲到數(shù)據(jù)庫或傳輸?shù)狡渌到y(tǒng)時，使用自定義的字符串表示可以提高數(shù)據(jù)的可讀性和兼容性。

與外部系統(tǒng)交互

當與外部系統(tǒng)（如第三方 API、配置文件等）進行交互時，可能需要使用特定格式的字符串來表示枚舉值。重寫 toString() 方法可以確保與外部系統(tǒng)的交互順利進行。
示例：

enum Currency {
    USD,
    EUR,
    CNY;

    @Override
    public String toString() {
        switch (this) {
            case USD:
                return "美元";
            case EUR:
                return "歐元";
            case CNY:
                return "人民幣";
            default:
                return super.toString();
        }
    }
}

在與支持多種貨幣的外部支付系統(tǒng)交互時，使用自定義的字符串表示可以避免因枚舉常量名稱不一致而導致的問題。

四、使用場景

本質(zhì)特性和使用場景有別雖然默認情況下返回結(jié)果相同，但 name() 和 toString() 在本質(zhì)特性和使用場景上是有差異的：
name() 方法：這是 Enum類特有的方法，返回的是枚舉常量在代碼中定義的原始名稱，且這個返回值是固定不變的，不能被重寫。它主要用于一些需要嚴格匹配枚舉常量原始名稱的場景，比如反序列化操作、配置文件讀取等。
toString() 方法：這是 Object 類的方法，所有 Java類都有該方法。在枚舉中，它默認返回枚舉常量的名稱，但可以根據(jù)業(yè)務(wù)需求重寫，以提供更具描述性的信息。它常用于面向用戶的展示、日志記錄等場景。
不重寫 toString() 方法時，它和 name()方法的返回結(jié)果一樣，但兩者的設(shè)計目的和使用場景不同。若你需要根據(jù)具體業(yè)務(wù)情況提供更友好、更具描述性的枚舉常量表示，就應(yīng)該重寫toString() 方法。

到此這篇關(guān)于Java中枚舉的toString()和name()的使用區(qū)別小結(jié)的文章就介紹到這了,更多相關(guān)Java 枚舉toString()和name()區(qū)別內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: