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

CKTIS / Java

java.util.Objects — validación, igualdad y hash

Aprende a usar Objects.requireNonNull, Objects.equals y Objects.hash: comprobación de null, igualdad entre referencias que pueden ser null y cálculo del hash a partir de campos.

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

Sintaxis

import java.util.Objects;
Objects.requireNonNull(value, "value");
Objects.equals(a, b);
Objects.hash(field1, field2);

java.util.Objects proporciona métodos auxiliares estáticos. Alcance de esta entrada: Java SE 21; no se han confirmado el entorno de ejecución del repositorio ni el entorno de producción.

Objects.requireNonNull(value, "value") devuelve la misma referencia o lanza una NullPointerException con el mensaje indicado. Resulta útil para validar parámetros, pero no comprueba, por ejemplo, si una cadena está vacía.

Objects.equals(a, b) devuelve true si ambos argumentos son null y false si solo a es null. Cuando a no es null, la igualdad se determina mediante el método equals del primer argumento. Si a == b y ambas referencias apuntan al mismo objeto, la API de Java SE 21 no garantiza que se omita la llamada a a.equals(b). El método no compara el contenido de los arrays.

Objects.hash(field1, field2) calcula el hash de una secuencia de forma similar a Arrays.hashCode(Object[]). Al implementar hashCode(), usa campos coherentes con equals(): los objetos iguales deben tener hashes iguales, aunque puede haber colisiones. Para un único objeto, Objects.hash(x) no sustituye a Objects.hashCode(x).

Ejemplos

import java.util.Objects;

public class Main {
    public static void main(String[] args) {
        String name = Objects.requireNonNull("Ada", "name");
        System.out.println(name);
        System.out.println(Objects.equals(null, null));
        System.out.println(Objects.equals(name, null));
        System.out.println(Objects.hash(1, 2));
        try {
            Objects.requireNonNull(null, "name");
        } catch (NullPointerException e) {
            System.out.println(e.getMessage());
        }
    }
}

Resultado

Ada
true
false
994
name

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