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

CKTIS / Java

Redefinir Object.toString()

Dá a um objeto uma descrição legível e vê como `println(Object)` a apresenta sem chamar explicitamente `toString()`.

Versão: Java SE 21

Sintaxe

@Override
public String toString() {
    return "Readable object description";
}

Redefinir Object.toString() permite a uma classe descrever uma instância com uma cadeia de caracteres curta e legível. Declara o método de instância público public String toString() sem parâmetros e devolve o texto em vez de o imprimir. Usa @Override para detetar erros na compilação: toString(String prefix) é uma sobrecarga, não uma redefinição.

A implementação de Object devolve o nome da classe efetiva do objeto, @ e o resultado de hashCode() em hexadecimal sem sinal. Não é um endereço de memória nem um identificador único.

Se task for declarada com o tipo Object, System.out.println(task) seleciona println(Object). Esta sobrecarga usa String.valueOf(Object), que, para um argumento diferente de null, chama a implementação de toString() do tipo efetivo do objeto. Se a referência for null, println(Object) imprime o texto null, mas uma chamada direta a task.toString() lança uma NullPointerException.

Devolve uma cadeia de caracteres diferente de null que inclua apenas campos úteis e não sensíveis. Não alteres o estado do objeto nem exponhas palavras-passe ou tokens: a descrição pode ficar registada nos logs. Não a uses como formato estável para interpretar ou guardar dados.

Exemplos

public class Main {
    private static final class Task {
        private final String title;
        private final boolean done;

        Task(String title, boolean done) {
            this.title = title;
            this.done = done;
        }

        @Override
        public String toString() {
            return "Task{title='" + title + "', done=" + done + "}";
        }
    }

    public static void main(String[] args) {
        Object task = new Task("Review notes", false);
        System.out.println(task.toString());
        System.out.println(task);

        Object missing = null;
        System.out.println(missing);
    }
}

Resultado

Task{title='Review notes', done=false}
Task{title='Review notes', done=false}
null

As duas primeiras linhas são iguais: a chamada direta e `println(Object)` usam a implementação de `Task`. A terceira mostra como `null` é tratado sem chamar `toString()`.

Lições relacionadas

  • Java · Lição 26 · Intermédio · Versão: 2
  • Java · Lição 27 · Intermédio · Versão: 2
  • Java · Lição 32 · Intermédio · Versão: 2

Fontes