CKTIS / Java
Objects.requireNonNull: comprobación de referencias
En Java SE 21, `Objects.requireNonNull` devuelve la misma referencia si no es `null`; de lo contrario, lanza una excepción. No valida el contenido del objeto.
Versión: Java SE 21
Sintaxis
import java.util.Objects;
import java.util.function.Supplier;
// Method signatures in java.util.Objects (Java SE 21):
public static <T> T requireNonNull(T obj)
public static <T> T requireNonNull(T obj, String message)
public static <T> T requireNonNull(T obj, Supplier<String> messageSupplier)Objects.requireNonNull es un método estático genérico de java.util.Objects. Si obj no es null, el método devuelve la misma referencia como T, de modo que puedes usar el resultado directamente en una asignación. Si obj es null, no devuelve un valor alternativo. Lanza NullPointerException, salvo si get() lanza una excepción en la sobrecarga con proveedor; en ese caso, se propaga esa excepción.
La variante de un argumento no recibe un mensaje. Con la sobrecarga de String, Java evalúa la expresión del mensaje antes de la llamada, aunque obj no sea null. Con Supplier<String>, Java también evalúa antes la expresión del proveedor, pero el método solo llama a get() para generar el mensaje si obj es null y el proveedor no es null. Las dos primeras variantes existen desde Java 7, y la del proveedor, desde Java 8. El literal null como segundo argumento es ambiguo sin una conversión explícita de tipo.
El constructor de Contact rechaza null por separado para cada uno de sus tres argumentos de texto: firstName, lastName y email. Las cadenas vacías superan esta comprobación, y el formato de la dirección de correo electrónico debe validarse por separado.
En tryAdvance, comprueba action antes de verificar si el rango se ha agotado. Con una acción válida, si no quedan elementos se devuelve false. Si queda uno, el método se lo pasa a la acción y devuelve true cuando esta termina normalmente. Una acción null provoca NullPointerException incluso después de agotar el rango.
Ejemplos
import java.util.Objects;
import java.util.Spliterator;
import java.util.function.IntConsumer;
public class Main {
record Contact(String firstName, String lastName, String email) {
Contact {
Objects.requireNonNull(firstName, "firstName");
Objects.requireNonNull(lastName, "lastName");
Objects.requireNonNull(email, "email");
}
}
static final class Range implements Spliterator.OfInt {
private int next = 7;
private final int end = 8;
@Override
public boolean tryAdvance(IntConsumer action) {
Objects.requireNonNull(action, "action");
if (next >= end) {
return false;
}
action.accept(next++);
return true;
}
@Override public Spliterator.OfInt trySplit() { return null; }
@Override public long estimateSize() { return end - next; }
@Override public int characteristics() { return ORDERED | SIZED; }
}
public static void main(String[] args) {
System.out.println(new Contact("Ada", "Lee", "not-an-email").email());
try {
new Contact("Ada", "Lee", null);
} catch (NullPointerException ex) {
System.out.println(ex.getClass().getSimpleName() + ": " + ex.getMessage());
}
Range range = new Range();
IntConsumer print = System.out::println;
System.out.println(range.tryAdvance(print));
System.out.println(range.tryAdvance(print));
try {
range.tryAdvance((IntConsumer) null);
} catch (NullPointerException ex) {
System.out.println(ex.getClass().getSimpleName() + ": " + ex.getMessage());
}
}
}Resultado
not-an-email NullPointerException: email 7 true false NullPointerException: action
`not-an-email` supera la comprobación, pero un `email` con valor `null` provoca una excepción. El rango pasa `7` a la acción, después devuelve `false` con una acción válida y sigue rechazando `null` en la última llamada. La conversión `(IntConsumer) null` selecciona la sobrecarga para el tipo primitivo.
Lecciones relacionadas
- Java · Lección 8 · Avanzado · Versión: 2
- Java · Lección 23 · Avanzado · Versión: 2
Fuentes
- Java SE 21 API — Objects.requireNonNull(T)
- Java SE 21 API — Objects.requireNonNull(T, String)
- Java SE 21 API — Objects.requireNonNull(T, Supplier<String>)
- Java SE 7 API — Objects
- Java SE 21 API — Spliterator.OfPrimitive.tryAdvance(T_CONS)
- Java SE 21 API — Spliterator.OfInt
- Java Language Specification, Java SE 21 — §15.12.4.2 Evaluate Arguments
- Java Language Specification, Java SE 21 — §15.12.2.5 Choosing the Most Specific Method