Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Objects.requireNonNull — provjera reference i poruka o pogrešci

Provjeri obvezni parametar: `Objects.requireNonNull` vraća istu referencu ako nije `null`. Ako je `null`, metoda obično baca iznimku `NullPointerException`. Možeš zadati vlastitu poruku.

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

U Java SE 21 Objects.requireNonNull statička je generička metoda klase java.util.Objects. Uvezi java.util.Objects kako bi mogao upotrebljavati kratki naziv Objects. Ako obj nije null, metoda vraća upravo istu referencu tipa T, bez kopiranja objekta. Ako je obj jednak null, baca iznimku NullPointerException umjesto da vrati vrijednost, osim ako dobavljač poruke sam baci iznimku ili pogrešku.

Upotrijebi je na početku metode ili konstruktora kako bi odmah odbio null za obvezni parametar. Objects.requireNonNull(obj) ne prima vlastitu poruku. U pozivu Objects.requireNonNull(obj, "name must not be null") drugi je argument String koji služi kao poruka iznimke, a ne kao zamjenska vrijednost. Izraz za argument tipa String izračunava se prije poziva, čak i kada obj nije null.

Ako je izrada poruke zahtjevna, možeš proslijediti Supplier<String> iz paketa java.util.function, kao u Objects.requireNonNull(obj, () -> buildMessage()). Tijelo lambda izraza izvršava se samo ako je obj jednak null. Ako Supplier baci neprovjeravanu iznimku ili pogrešku tipa Error, ona se nepromijenjena propagira dalje, a requireNonNull ne baca vlastitu iznimku NullPointerException. Poziv Objects.requireNonNull(obj, null) ne može se prevesti jer null odgovara i tipu String i tipu Supplier<String>. Ako ti ne treba vlastita poruka, upotrijebi verziju s jednim argumentom.

Metoda samo provjerava je li referenca null: prazan niz znakova prolazi provjeru. Ako želiš zamijeniti null umjesto da ga odbiješ, upotrijebi Objects.requireNonNullElse sa zamjenskom vrijednošću koja nije null.

Primjeri

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

Prvi je redak `true` jer `==` uspoređuje reference, a polje sadrži istu referencu koja je proslijeđena konstruktoru. Pri drugom pozivu konstruktor baca iznimku; blok `catch` ispisuje samo poruku koju vraća `getMessage()`.

Povezane lekcije

  • Java · Lekcija 28 · Srednje · Verzija: 2

Izvori