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