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

CKTIS / Java

Objects.requireNonNull — kontrola referencie a chybová správa

Skontrolujte povinný parameter: `Objects.requireNonNull` vráti tú istú referenciu, ak nie je `null`. Pri hodnote `null` metóda bežne vyvolá `NullPointerException`. Výnimke môžete pridať vlastnú správu.

Verzia: 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)

V Java SE 21 je Objects.requireNonNull statická generická metóda triedy java.util.Objects. Importujte java.util.Objects, aby ste mohli používať krátky názov Objects. Ak obj nie je null, metóda vráti presne tú istú referenciu typu T bez kopírovania objektu. Ak je obj rovné null, metóda vyvolá NullPointerException namiesto vrátenia hodnoty, pokiaľ dodávateľ správy sám nevyvolá výnimku alebo chybu.

Použite ju na začiatku metódy alebo konštruktora, aby ste pri povinnom parametri hneď odmietli null. Objects.requireNonNull(obj) neprijíma vlastnú správu. Vo volaní Objects.requireNonNull(obj, "name must not be null") je druhým argumentom String so správou výnimky, nie náhradná hodnota. Výraz pre argument typu String sa vyhodnotí pred volaním, aj keď obj nie je null.

Ak je vytvorenie správy nákladné, môžete odovzdať Supplier<String> z balíka java.util.function, napríklad Objects.requireNonNull(obj, () -> buildMessage()). Telo lambda výrazu sa vykoná iba vtedy, ak je obj rovné null. Ak Supplier vyvolá nekontrolovanú výnimku alebo chybu typu Error, šíri sa ďalej bez zmeny a requireNonNull nevyvolá vlastnú NullPointerException. Volanie Objects.requireNonNull(obj, null) sa nedá skompilovať, pretože null vyhovuje typu String aj typu Supplier<String>. Ak nepotrebujete vlastnú správu, použite preťaženú verziu s jedným argumentom.

Metóda kontroluje len to, či je referencia null: prázdny reťazec kontrolou prejde. Ak chcete null nahradiť namiesto odmietnutia, použite Objects.requireNonNullElse s náhradnou hodnotou, ktorá nie je null.

Príklady

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

Výsledok

true
name must not be null

Prvý riadok je `true`, pretože `==` porovnáva referencie a pole obsahuje tú istú referenciu, ktorá bola odovzdaná konštruktoru. Pri druhom volaní konštruktor vyvolá výnimku; blok `catch` vypíše iba správu získanú pomocou `getMessage()`.

Súvisiace lekcie

  • Java · Lekcia 28 · Stredne pokročilá · Verzia: 2

Zdroje