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.