Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

AbstractMap.toString — rappresentazione testuale di una mappa

AbstractMap.toString restituisce testo contenente associazioni chiave-valore. Il loro ordine deriva dall’iteratore di entrySet(), non da un ordinamento automatico.

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

Sintassi

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

AbstractMap.toString è un metodo di istanza senza argomenti che restituisce String; sovrascrive Object.toString(). Rappresenta una mappa nel formato {key=value, key=value}. Una mappa vuota produce {}; le associazioni successive sono separate da , .

L’ordine è determinato dall’iteratore di entrySet(): il metodo non ordina le voci. Chiavi e valori vengono normalmente convertiti come con String.valueOf(Object): null diventa il testo null, mentre per gli altri oggetti viene chiamato il loro metodo toString(). Una mappa può però contenere sé stessa come valore. In questo caso, l’implementazione ereditata di AbstractMap.toString in OpenJDK 21 rappresenta quel valore come (this Map) anziché chiamare ricorsivamente toString() sulla stessa mappa. La specifica Java SE non garantisce questo marcatore. Non considerare questa rappresentazione come JSON o come un formato affidabile per lo scambio di dati.

L’esempio usa LinkedHashMap, il cui ordine predefinito segue quello di inserimento. Il tipo della variabile AbstractMap non cambia la classe effettiva dell’oggetto; una sottoclasse può sovrascrivere toString(). Questa descrizione riguarda Java SE 21; l’ambiente di produzione non è stato attestato.

Esempi

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());
    }
}

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti