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.