Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

Object.equals — igualdad de objetos

De forma predeterminada, Object.equals compara la identidad de los objetos. Al sobrescribirlo, una clase puede definir la igualdad por valor.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

public boolean equals(Object obj)

Object.equals(Object obj) devuelve un boolean. La implementación de Object comprueba la identidad: para referencias no nulas, se comporta como == y no compara los campos automáticamente. Las clases pueden sobrescribirlo.

El contrato exige reflexividad, simetría, transitividad y resultados coherentes mientras los datos usados en la comparación no cambien. Para un x no nulo, x.equals(null) debe devolver false.

Al sobrescribir equals, por lo general también hay que sobrescribir hashCode: los objetos iguales deben tener los mismos códigos hash; tener códigos hash iguales no implica que los objetos sean iguales.

El ejemplo muestra el comportamiento heredado: la misma instancia, otra instancia y un argumento null.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes