Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

AbstractMap.toString — tekstowa reprezentacja mapy

AbstractMap.toString zwraca tekst zawierający pary klucz–wartość. Kolejność wynika z iteratora entrySet(), a nie z automatycznego sortowania.

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

Składnia

public String toString()
// Usage:
String text = map.toString();

AbstractMap.toString to bezargumentowa metoda instancji zwracająca String; nadpisuje Object.toString(). Przedstawia mapę w postaci {key=value, key=value}. Pusta mapa daje {}; kolejne pary oddziela , .

Kolejność wyznacza iterator entrySet(): metoda nie sortuje wpisów. Klucze i wartości są zwykle przekształcane tak jak przez String.valueOf(Object): null staje się tekstem null, a dla pozostałych obiektów wywoływana jest ich metoda toString(). Mapa może jednak zawierać samą siebie jako wartość. W takim przypadku odziedziczona implementacja AbstractMap.toString w OpenJDK 21 zapisuje tę wartość jako (this Map) zamiast rekurencyjnie wywoływać toString() tej samej mapy. Specyfikacja Java SE nie gwarantuje tego znacznika. Nie traktuj tego zapisu jako JSON ani niezawodnego formatu wymiany danych.

Przykład używa LinkedHashMap, której domyślna kolejność odpowiada kolejności wstawiania. Typ zmiennej AbstractMap nie zmienia rzeczywistej klasy obiektu; podklasa może nadpisać toString(). Opis dotyczy Java SE 21; środowisko produkcyjne nie zostało potwierdzone.

Przykłady

import java.util.AbstractMap;
import java.util.LinkedHashMap;

public class Main {
    public static void main(String[] args) {
        AbstractMap<String, Integer> map = new LinkedHashMap<>();
        map.put("beta", 2);
        map.put("alpha", 1);
        map.put("missing", null);
        System.out.println(map.toString());
        map.clear();
        System.out.println(map.toString());
    }
}

Wynik

{beta=2, alpha=1, missing=null}
{}

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

Źródła