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

CKTIS / Java

Objects.requireNonNull — comprobar referencias y mensajes de error

Comprueba un parámetro obligatorio: `Objects.requireNonNull` devuelve la misma referencia si no es `null`. Si es `null`, normalmente lanza `NullPointerException`. Puedes proporcionar un mensaje personalizado.

Versión: Java SE 21

Sintaxis

import java.util.Objects;
import java.util.function.Supplier;

// Java SE 21: static method signatures in java.util.Objects
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)

En Java SE 21, Objects.requireNonNull es un método genérico estático de la clase java.util.Objects. Importa java.util.Objects para usar el nombre corto Objects. Si obj no es null, el método devuelve exactamente la misma referencia con tipo T, sin copiar el objeto. Si obj es null, lanza NullPointerException en vez de devolver un valor, salvo que el proveedor del mensaje lance una excepción o un error.

Úsalo al principio de un método o constructor para rechazar de inmediato null en un parámetro obligatorio. Objects.requireNonNull(obj) no admite un mensaje personalizado. En Objects.requireNonNull(obj, "name must not be null"), el segundo argumento es un String que se usa como mensaje de la excepción, no como valor alternativo. La expresión del argumento String se evalúa antes de la llamada, aunque obj no sea null.

Si generar el mensaje es costoso, puedes pasar un Supplier<String> de java.util.function, como en Objects.requireNonNull(obj, () -> buildMessage()). El cuerpo de la lambda solo se ejecuta si obj es null. Si el proveedor lanza una excepción no comprobada o un Error, esta excepción o error se propaga sin cambios y requireNonNull no lanza su propio NullPointerException. Objects.requireNonNull(obj, null) no compila porque null encaja tanto con String como con Supplier<String>. Usa la sobrecarga de un argumento si no necesitas un mensaje personalizado.

El método solo comprueba si la referencia es null: una cadena vacía supera la comprobación. Para sustituir null en vez de rechazarlo, usa Objects.requireNonNullElse con un valor alternativo que no sea null.

Ejemplos

import java.util.Objects;

public class Main {
    private final String name;

    public Main(String name) {
        this.name = Objects.requireNonNull(name, "name must not be null");
    }

    public static void main(String[] args) {
        String name = "Ada";
        Main entry = new Main(name);
        System.out.println(entry.name == name);

        try {
            new Main(null);
        } catch (NullPointerException e) {
            System.out.println(e.getMessage());
        }
    }
}

Resultado

true
name must not be null

La primera línea es `true` porque `==` compara referencias y el campo contiene la misma referencia que se pasó al constructor. En la segunda llamada, el constructor lanza una excepción; el bloque `catch` solo imprime el mensaje obtenido con `getMessage()`.

Lecciones relacionadas

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

Fuentes