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