Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

Objects.requireNonNull — preverjanje reference in sporočilo o napaki

Preveri obvezni parameter: `Objects.requireNonNull` vrne isto referenco, če ni `null`. Če je `null`, metoda praviloma sproži izjemo `NullPointerException`. Izjemi lahko dodaš lastno sporočilo.

Različica: Java SE 21

Sintaksa

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 statična generična metoda razreda java.util.Objects. Uvozi java.util.Objects, da lahko uporabljaš kratko ime Objects. Če obj ni null, metoda vrne natanko isto referenco tipa T, ne da bi kopirala objekt. Če je obj enak null, namesto vrednosti sproži izjemo NullPointerException, razen če dobavitelj sporočila sam sproži izjemo ali napako.

Uporabi jo na začetku metode ali konstruktorja, da takoj zavrneš null pri obveznem parametru. Objects.requireNonNull(obj) ne sprejme lastnega sporočila. V klicu Objects.requireNonNull(obj, "name must not be null") je drugi argument String, ki se uporabi kot sporočilo izjeme, ne kot nadomestna vrednost. Izraz za argument tipa String se ovrednoti pred klicem, tudi če obj ni null.

Če je sestavljanje sporočila zahtevno, lahko podaš Supplier<String> iz paketa java.util.function, kot v Objects.requireNonNull(obj, () -> buildMessage()). Telo izraza lambda se izvede samo, če je obj enak null. Če Supplier sproži nepreverjano izjemo ali napako tipa Error, se ta nespremenjena širi naprej, metoda requireNonNull pa ne sproži lastne izjeme NullPointerException. Klica Objects.requireNonNull(obj, null) ni mogoče prevesti, ker null ustreza tako tipu String kot tipu Supplier<String>. Če ne potrebuješ lastnega sporočila, uporabi različico z enim argumentom.

Metoda preveri samo, ali je referenca null: prazen niz prestane preverjanje. Če želiš null nadomestiti, namesto da ga zavrneš, uporabi Objects.requireNonNullElse z nadomestno vrednostjo, ki ni null.

Primeri

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

Rezultat

true
name must not be null

Prva vrstica je `true`, ker `==` primerja referenci, polje pa vsebuje isto referenco, kot je bila podana konstruktorju. Pri drugem klicu konstruktor sproži izjemo; blok `catch` izpiše samo sporočilo, pridobljeno z `getMessage()`.

Povezane lekcije

  • Java · Lekcija 28 · Srednja · Različica: 2

Viri