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

CKTIS / Java

Object.equals — igualdade de objetos

Por predefinição, Object.equals compara a identidade dos objetos. Ao redefini-lo, uma classe pode definir a igualdade por valor.

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

Sintaxe

public boolean equals(Object obj)

Object.equals(Object obj) devolve um boolean. A implementação em Object verifica a identidade: para referências não nulas, comporta-se como == e não compara automaticamente os campos. As classes podem redefinir este método.

O contrato exige reflexividade, simetria, transitividade e resultados consistentes enquanto os dados usados na comparação não forem alterados. Para um x não nulo, x.equals(null) tem de devolver false.

Ao redefinir equals, geralmente também é necessário redefinir hashCode: objetos iguais têm de ter códigos hash iguais; códigos hash iguais não implicam que os objetos sejam iguais.

O exemplo mostra o comportamento herdado: a mesma instância, outra instância e um argumento null.

Exemplos

public class Main {
    public static void main(String[] args) {
        Object a = new Object();
        Object b = new Object();
        Object same = a;

        System.out.println(a.equals(same));
        System.out.println(a.equals(b));
        System.out.println(a.equals(null));
    }
}

Resultado

true
false
false

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