HOWTO · Java

Enum a String in Java

Questo tutorial spiega due metodi della classe enum per convertire enum in stringa in Java.

In questa pagina

Un enum definisce un insieme fisso di costanti con nome. Ogni costante è un’istanza del proprio tipo enum e Java mette a disposizione metodi per ottenerne una rappresentazione testuale. Il metodo da scegliere dipende dal fatto che serva l’identificatore esatto dichiarato nel codice oppure un testo destinato alla visualizzazione.

Convertire una costante enum con name()

Chiama name() su una costante quando ti serve il suo identificatore dichiarato esatto. Per esempio, Directions.WEST.name() restituisce la stringa WEST. Il valore restituito conserva la grafia e le maiuscole usate nella dichiarazione dell’enum. name() è final, quindi un enum non può modificarne il risultato sovrascrivendo il metodo.

È utile quando il codice ha bisogno dell’identificatore stesso, per esempio per confrontare un valore con il nome noto di una costante. Tieni presente che rinominare la costante enum cambia la stringa restituita da name(). Se il testo è destinato alle persone, un identificatore come NORTH_EAST potrebbe non essere la dicitura da mostrare.

Convertire una costante enum con toString()

Anche una chiamata a toString() restituisce una stringa. Se l’enum non sovrascrive questo metodo, il risultato predefinito è il nome della costante: quindi Directions.WEST.toString() restituisce WEST. A differenza di name(), toString() può essere sovrascritto dall’enum per restituire un testo diverso.

Scegli in base al significato del valore. Usa name() quando conta l’identificatore dichiarato; usa toString() quando la rappresentazione testuale scelta dall’enum è adatta a chi la riceve. Nessuna delle due opzioni è sempre la migliore. Se un altro programma o un formato memorizzato dipende da un identificatore stabile, definisci e gestisci quel formato in modo esplicito, senza presumere che il testo visualizzato non cambierà mai.

Sovrascrivere toString() per un testo personalizzato

Un enum può associare una stringa a ogni costante tramite un costruttore e restituire quel campo da una versione sovrascritta di toString(). In questo modo il codice può mantenere identificatori concisi come USD e mostrare un testo più descrittivo, come US dollars. Ogni costante specifica il proprio valore nella dichiarazione dell’enum.

Nell’esempio seguente, name() continua a restituire l’identificatore dichiarato, mentre toString() restituisce l’etichetta personalizzata. Questa distinzione è utile nei log o nei testi mostrati agli utenti, se la dicitura personalizzata è appropriata. Poiché chi chiama toString() riceve il valore personalizzato, il codice che ha bisogno specificamente di USD deve chiamare name().

Stampare ogni costante enum come stringa

Java genera un metodo values() per ogni tipo enum. Restituisce un array con le costanti di quel tipo nell’ordine in cui sono dichiarate; non è un metodo ereditato da Enum. Puoi scorrere l’array per elaborare ogni valore. La concatenazione di una costante enum con del testo richiama il suo metodo toString(), quindi il ciclo seguente stampa le etichette personalizzate.

Esegui questo esempio completo per confrontare i nomi esatti, le stringhe predefinite, il testo personalizzato mostrato e tutte le costanti di valuta. Il codice e l’output restano identici al canonico: le etichette e le stringhe visualizzate nell’esempio sono in inglese.

public class EnumToString {
    enum Directions {
        NORTH, SOUTH, EAST, WEST
    }

    enum PlainCurrencies {
        USD, YEN, EUR, INR
    }

    enum Currencies {
        USD("US dollars"),
        YEN("Japanese yen"),
        EUR("euros"),
        INR("Indian rupees");

        private final String displayText;

        Currencies(String displayText) {
            this.displayText = displayText;
        }

        @Override
        public String toString() {
            return displayText;
        }
    }

    public static void main(String[] args) {
        System.out.println(Directions.WEST.name());
        System.out.println(PlainCurrencies.USD.toString());
        System.out.println(Currencies.INR.name());
        System.out.println(Currencies.INR.toString());

        for (Currencies currency : Currencies.values()) {
            System.out.println(currency);
        }
    }
}
WEST
USD
INR
Indian rupees
US dollars
Japanese yen
euros
Indian rupees