KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

Objects.requireNonNull: referenties controleren

In Java SE 21 geeft `Objects.requireNonNull` dezelfde referentie terug als die niet `null` is. Anders gooit de methode een uitzondering. De inhoud wordt niet gecontroleerd.

Versie: Java SE 21

Syntax

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 is een generieke statische methode in java.util.Objects. Als obj niet null is, geeft de methode dezelfde referentie terug als T, zodat je het resultaat direct in een toewijzing kunt gebruiken. Als obj wel null is, geeft de methode geen vervangende waarde terug. Ze gooit een NullPointerException, tenzij get() in de supplier-variant zelf een uitzondering gooit. In dat geval wordt die uitzondering doorgegeven.

De variant met één argument accepteert geen melding. Bij de String-overload evalueert Java de expressie voor de melding vóór de aanroep, ook als obj niet null is. Bij Supplier<String> wordt de expressie voor de supplier ook vooraf geëvalueerd, maar de methode roept get() alleen aan om de melding te maken als obj null is en de supplier niet null is. De eerste twee varianten zijn beschikbaar sinds Java 7, de supplier-variant sinds Java 8. Het letterlijke null als tweede argument is zonder cast dubbelzinnig.

De constructor van Contact wijst null voor elk van de drie tekstargumenten afzonderlijk af: firstName, lastName en email. Lege tekenreeksen komen door deze controle heen. Het formaat van een e-mailadres moet je apart valideren.

Controleer in tryAdvance eerst action en pas daarna of het bereik is uitgeput. Bij een geldige actie geeft de methode false terug als er geen element meer is. Is er wel een element, dan geeft ze dat aan de actie door en retourneert ze true zodra de actie normaal is voltooid. Een null-actie veroorzaakt ook na uitputting van het bereik een NullPointerException.

Voorbeelden

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

Resultaat

not-an-email
NullPointerException: email
7
true
false
NullPointerException: action

`not-an-email` komt door de controle, maar `null` voor `email` veroorzaakt een uitzondering. Het bereik geeft `7` aan de actie door, retourneert daarna `false` bij een geldige actie en wijst bij de laatste aanroep nog steeds `null` af. De cast `(IntConsumer) null` kiest de overload voor het primitieve type.

Gerelateerde lessen

  • Java · Les 8 · Gevorderd · Versie: 2
  • Java · Les 23 · Gevorderd · Versie: 2

Bronnen