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

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