Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

Objects.requireNonNull: kontrola referencií

V Jave SE 21 metóda `Objects.requireNonNull` vráti tú istú referenciu, ak nie je `null`; inak vyvolá výnimku. Nekontroluje obsah objektu.

Verzia: 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 je statická generická metóda triedy java.util.Objects. Ak obj nie je null, metóda vráti tú istú referenciu ako T, takže výsledok môžeš použiť priamo v priradení. Ak je obj rovné null, metóda nevráti náhradnú hodnotu. Vyvolá NullPointerException, pokiaľ vo variante s dodávateľom nevyvolá výnimku samotné get(). V takom prípade sa ďalej šíri táto výnimka.

Variant s jedným argumentom neprijíma správu. Pri preťažení s String Java vyhodnotí výraz pre správu pred volaním, aj keď obj nie je null. Pri Supplier<String> sa výraz poskytujúci dodávateľa tiež vyhodnotí pred volaním, ale metóda zavolá get() na vytvorenie správy iba vtedy, keď je obj rovné null a dodávateľ nie je null. Prvé dva varianty sú dostupné od Javy 7 a variant s dodávateľom od Javy 8. Literál null ako druhý argument je bez pretypovania nejednoznačný.

Konštruktor Contact odmieta null pri každom z troch textových argumentov samostatne: firstName, lastName a email. Prázdne reťazce touto kontrolou prejdú a formát e-mailovej adresy treba overiť osobitne.

V tryAdvance skontroluj action skôr, než zistíš, či je rozsah vyčerpaný. Pri platnej akcii vráti metóda false, ak už žiadny prvok nezostal. Ak prvok zostal, odovzdá ho akcii a po jej normálnom dokončení vráti true. Akcia null vyvolá NullPointerException aj po vyčerpaní rozsahu.

Prí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ýsledok

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

`not-an-email` kontrolou prejde, ale `null` pre `email` vyvolá výnimku. Rozsah odovzdá akcii hodnotu `7`, potom pri platnej akcii vráti `false` a pri poslednom volaní stále odmietne `null`. Pretypovanie `(IntConsumer) null` vyberie preťaženie pre primitívny typ.

Súvisiace lekcie

  • Java · Lekcia 8 · Pokročilá · Verzia: 2
  • Java · Lekcia 23 · Pokročilá · Verzia: 2

Zdroje