KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

Objects.requireNonNull — referenties controleren en foutmeldingen meegeven

Controleer een verplichte parameter: `Objects.requireNonNull` geeft dezelfde referentie terug als die niet `null` is. Bij `null` gooit de methode normaal gesproken een `NullPointerException`. Je kunt een eigen foutmelding meegeven.

Versie: Java SE 21

Syntax

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)

In Java SE 21 is Objects.requireNonNull een statische generieke methode van de klasse java.util.Objects. Importeer java.util.Objects om de korte klassenaam Objects te gebruiken. Als obj niet null is, geeft de methode exact dezelfde referentie terug als type T, zonder het object te kopiëren. Als obj null is, gooit de methode een NullPointerException in plaats van een waarde terug te geven, tenzij de supplier voor de melding zelf een exceptie of fout gooit.

Gebruik de methode aan het begin van een methode of constructor om null meteen af te wijzen voor een verplichte parameter. Objects.requireNonNull(obj) accepteert geen eigen foutmelding. In Objects.requireNonNull(obj, "name must not be null") is het tweede argument een String met de melding van de exceptie, geen vervangende waarde. De expressie voor het String-argument wordt vóór de aanroep geëvalueerd, ook als obj niet null is.

Als het opbouwen van de melding veel werk kost, kun je een Supplier<String> uit java.util.function meegeven, zoals in Objects.requireNonNull(obj, () -> buildMessage()). De body van de lambda wordt alleen uitgevoerd als obj null is. Als de supplier een ongecontroleerde exceptie of een Error gooit, wordt die ongewijzigd doorgegeven en gooit requireNonNull geen eigen NullPointerException. Objects.requireNonNull(obj, null) compileert niet omdat null bij zowel String als Supplier<String> past. Gebruik de overload met één argument als je geen eigen melding nodig hebt.

De methode controleert alleen of de referentie null is: een lege tekenreeks komt door de controle. Wil je null vervangen in plaats van afwijzen, gebruik dan Objects.requireNonNullElse met een vervangende waarde die niet null is.

Voorbeelden

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());
        }
    }
}

Resultaat

true
name must not be null

De eerste regel is `true`, omdat `==` referenties vergelijkt en het veld dezelfde referentie bevat die aan de constructor is doorgegeven. Bij de tweede aanroep gooit de constructor een exceptie; het `catch`-blok drukt alleen de melding uit `getMessage()` af.

Gerelateerde lessen

  • Java · Les 28 · Gemiddeld · Versie: 2

Bronnen