Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

Objects.requireNonNull: kontrola referencí

V Javě SE 21 metoda `Objects.requireNonNull` vrátí tutéž referenci, pokud není `null`; jinak vyvolá výjimku. Nekontroluje obsah objektu.

Verze: Java SE 21

Syntaxe

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 je statická generická metoda třídy java.util.Objects. Pokud obj není null, vrátí tutéž referenci jako T, takže výsledek můžeš použít přímo v přiřazení. Pokud je obj roven null, metoda nevrací náhradní hodnotu. Vyvolá NullPointerException, ledaže ve variantě s dodavatelem vyvolá výjimku samotné get(). V takovém případě se šíří tato výjimka.

Varianta s jedním argumentem nepřijímá zprávu. U přetížení s String Java vyhodnotí výraz pro zprávu ještě před voláním, i když obj není null. U Supplier<String> se výraz poskytující dodavatele také vyhodnotí před voláním, ale metoda zavolá get() pro vytvoření zprávy jen tehdy, když je obj roven null a dodavatel není null. První dvě varianty jsou dostupné od Javy 7, varianta s dodavatelem od Javy 8. Literál null jako druhý argument je bez přetypování nejednoznačný.

Konstruktor Contact odmítne null u každého ze tří textových argumentů zvlášť: firstName, lastName a email. Prázdné řetězce touto kontrolou projdou a formát e-mailové adresy je potřeba ověřit zvlášť.

V tryAdvance zkontroluj action dříve, než zjistíš, zda je rozsah vyčerpán. Při platné akci znamená absence dalších prvků false. Pokud prvek zbývá, metoda jej předá akci a po jejím normálním dokončení vrátí true. Akce null vyvolá NullPointerException i po vyčerpání rozsahu.

Příklady

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

Výsledek

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

`not-an-email` kontrolou projde, ale `null` pro `email` vyvolá výjimku. Rozsah předá akci hodnotu `7`, poté s platnou akcí vrátí `false` a při posledním volání stále odmítne `null`. Přetypování `(IntConsumer) null` vybere přetížení pro primitivní typ.

Související lekce

  • Java · Lekce 8 · Pokročilá · Verze: 2
  • Java · Lekce 23 · Pokročilá · Verze: 2

Zdroje