Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

java.lang.Enum — reprezentacja tekstowa stałych

java.lang.Enum jest klasą bazową typów wyliczeniowych. Poznaj różnicę między nadpisywalną metodą toString() a metodą name(), która zwraca dokładną nazwę stałej.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

public abstract class Enum<E extends Enum<E>>
public String toString()
public final String name()

java.lang.Enum jest wspólną klasą bazową typów deklarowanych przez enum. Typ wyliczeniowy definiuje nazwane stałe, takie jak State.READY.

Enum.toString() domyślnie zwraca nazwę stałej z deklaracji. Można ją nadpisać, aby uzyskać czytelniejszy tekst. Natomiast name() jest metodą final i zawsze zwraca dokładną nazwę zadeklarowanej stałej.

State.valueOf("READY") wyszukuje stałą według dokładnej nazwy, a nie wyniku toString(). Wielkość liter ma znaczenie; State.valueOf("Ready") zgłosi IllegalArgumentException. Nie traktuj więc etykiety prezentacyjnej jako nazwy służącej do odczytu stałej.

Przykłady

public class Main {
    enum State {
        READY;

        @Override
        public String toString() {
            return "Ready";
        }
    }

    public static void main(String[] args) {
        System.out.println(State.READY.toString());
        System.out.println(State.READY.name());
        System.out.println(State.valueOf("READY") == State.READY);
    }
}

Wynik

Ready
READY
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła