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

CKTIS / Java

Objects.equals: comparar objetos de forma segura con null

Usa `Objects.equals(a, b)` para comparar objetos según sus reglas de igualdad de `equals`, aunque uno de los argumentos o ambos puedan ser `null`.

Versión: Java SE 21

Sintaxis

import java.util.Objects;

// Java SE 21 API signature: public static boolean equals(Object a, Object b)
boolean equal = Objects.equals(a, b);

Objects.equals(a, b) es un método estático de java.util.Objects que devuelve un boolean. En OpenJDK 21, si a == b, el método devuelve true sin llamar a a.equals(b). Esto sucede cuando ambas referencias apuntan al mismo objeto o cuando ambos argumentos son null. Si a == b da false, el método devuelve false cuando a es null; de lo contrario, llama a a.equals(b) y devuelve su resultado. En esa llamada, el contrato de equals exige que el resultado sea false cuando b es null. A diferencia de una llamada directa a a.equals(b), este método no lanza una NullPointerException solo porque a sea null.

Para dos referencias, == da true si ambas apuntan al mismo objeto o si ambas son null. No compara el contenido. Cuando Objects.equals llama a a.equals(b), aplica la regla de igualdad que define la clase de a. Por ejemplo, String.equals compara secuencias de caracteres, mientras que la implementación heredada de Object.equals solo comprueba la identidad de los objetos.

Si se llama a a.equals(b), Objects.equals no corrige una implementación defectuosa de equals ni captura las excepciones que esta lance. Objects.equals no compara los elementos de los arrays; usa Objects.deepEquals(a, b) para comparar su contenido, incluso cuando hay arrays anidados.

Ejemplos

import java.util.Objects;

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

        System.out.println(Objects.equals(a, b));
        System.out.println(a == b);
        System.out.println(Objects.equals(null, null));
        System.out.println(Objects.equals(null, b));
        System.out.println(Objects.equals(a, null));
    }
}

Resultado

true
false
true
false
false

`new String(a)` crea un objeto `String` distinto con el mismo texto. Por eso, `Objects.equals(a, b)` da `true`, mientras que `a == b` da `false`. Las últimas tres líneas muestran el resultado con dos argumentos `null` y con un único `null` en cada una de las dos posiciones.

Lecciones relacionadas

  • Java · Lección 28 · Intermedio · Versión: 2

Fuentes