Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

AbstractMap.toString — representação textual de um mapa

AbstractMap.toString devolve texto com associações chave-valor. A sua ordem é determinada pelo iterador de entrySet(), e não por uma ordenação automática.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

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

AbstractMap.toString é um método de instância sem argumentos que devolve String; substitui Object.toString(). Representa um mapa no formato {key=value, key=value}. Um mapa vazio produz {}; as associações sucessivas são separadas por , .

A ordem é determinada pelo iterador de entrySet(): o método não ordena as entradas. As chaves e os valores são normalmente convertidos como com String.valueOf(Object): null passa a ser o texto null, e para os restantes objetos é chamado o respetivo método toString(). Um mapa pode, no entanto, conter-se a si próprio como valor. Nesse caso, a implementação herdada de AbstractMap.toString no OpenJDK 21 representa esse valor como (this Map) em vez de chamar recursivamente toString() no mesmo mapa. A especificação Java SE não garante este marcador. Não encares esta representação como JSON nem como um formato fiável de troca de dados.

O exemplo usa LinkedHashMap, cuja ordem predefinida segue a ordem de inserção. O tipo da variável AbstractMap não altera a classe real do objeto; uma subclasse pode substituir toString(). Esta descrição refere-se a Java SE 21; o ambiente de execução de produção não foi atestado.

Exemplos

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

Resultado

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes