CKTIS / Java
Redefinir Object.equals: comparar os dois campos de Person
Define a igualdade de objetos Person pelo nome e pela idade, distingue-a da identidade das referências e implementa um hashCode coerente.
Versão: Java SE 21
Sintaxe
@Override public boolean equals(Object obj)
@Override public int hashCode()Por omissão, Object.equals(Object) verifica a identidade: para duas referências não nulas, só devolve true se ambas apontarem para o mesmo objeto. Com referências, == também verifica a identidade, e não os valores dos campos. Neste exemplo, dois objetos Person são iguais quando coincidem name e age, mesmo que sejam instâncias distintas.
Declara public boolean equals(Object obj) com @Override para que o compilador verifique a redefinição. equals(Person) seria uma sobrecarga e não substituiria equals(Object). Após a verificação rápida this == obj, o padrão instanceof Person other exclui null e objetos de outros tipos. Person é final, pelo que não tem subclasses. Compara a idade de tipo int com == e o nome com Objects.equals, que considera iguais dois valores null.
Para objetos não nulos, a igualdade tem de ser reflexiva, simétrica e transitiva. Comparações repetidas têm de dar o mesmo resultado enquanto os dados usados na comparação não mudarem, e x.equals(null) tem de devolver false se x não for null. Redefine também hashCode() usando os mesmos dois campos: objetos iguais têm de ter o mesmo código hash, mas objetos diferentes também podem partilhá-lo.
Exemplos
import java.util.Objects;
public class Main {
private static final class Person {
private final String name;
private final int age;
Person(String name, int age) {
this.name = name;
this.age = age;
}
@Override
public boolean equals(Object obj) {
if (this == obj) {
return true;
}
if (!(obj instanceof Person other)) {
return false;
}
return age == other.age && Objects.equals(name, other.name);
}
@Override
public int hashCode() {
return Objects.hash(name, age);
}
}
public static void main(String[] args) {
Person a = new Person("Ada", 28);
Object b = new Person("Ada", 28);
System.out.println(a == b);
System.out.println(b.equals(a));
System.out.println(a.equals(new Person("Ada", 29)));
System.out.println(a.equals(new Person("Eva", 28)));
System.out.println(a.equals(null));
System.out.println(a.equals("Ada"));
System.out.println(a.hashCode() == b.hashCode());
}
}Resultado
false true false false false false true
As duas instâncias distintas dão `false` com `==` e `true` com `equals`, apesar de `b` ser declarado como `Object`. Alterar qualquer um dos campos, passar `null` ou passar um objeto de outro tipo dá `false`. As instâncias iguais têm o mesmo código hash.
Lições relacionadas
- Java · Lição 28 · Intermédio · Versão: 2
Fontes
- Java SE 21 API — Object.equals(Object)
- Java SE 21 API — Object.hashCode()
- Java SE 21 API — Override
- Java SE 21 API — Objects.equals(Object, Object)
- Java SE 21 API — Objects.hash(Object...)
- Java Language Specification, Java SE 21 — §8.4.8.1 Overriding (by Instance Methods)
- Java Language Specification, Java SE 21 — §15.21.3 Reference Equality Operators