Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Objects.requireNonNull: provjera referenci

U Javi SE 21 metoda `Objects.requireNonNull` vraća istu referencu ako nije `null`; inače baca iznimku. Provjerava prisutnost argumenta, a ne valjanost njegova sadržaja.

Verzija: Java SE 21

Sintaksa

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 statička je generička metoda klase java.util.Objects. Ako obj nije null, metoda vraća istu referencu kao T pa rezultat možeš upotrijebiti izravno u dodjeli. Ako je obj jednak null, metoda ne vraća zamjensku vrijednost. Baca NullPointerException, osim ako u varijanti s dobavljačem get() baci iznimku. U tom se slučaju ta iznimka prosljeđuje dalje.

Varijanta s jednim argumentom ne prima poruku. Kod preopterećenja sa String Java vrednuje izraz za poruku prije poziva, čak i kad obj nije null. Kod Supplier<String> izraz koji daje dobavljača također se vrednuje prije poziva, ali metoda poziva get() za izradu poruke samo ako je obj jednak null, a dobavljač nije null. Prve su dvije varijante dostupne od Jave 7, a ona s dobavljačem od Jave 8. Literal null kao drugi argument dvosmislen je bez pretvorbe tipa.

Konstruktor Contact zasebno odbija null za svaki od triju tekstnih argumenata: firstName, lastName i email. Prazni nizovi prolaze tu provjeru, a format adrese e-pošte treba provjeriti zasebno.

U tryAdvance najprije provjeri action, a zatim je li raspon iscrpljen. Uz valjanu akciju metoda vraća false ako nema preostalih elemenata. Ako element postoji, prosljeđuje ga akciji i vraća true kad akcija završi bez iznimke. Akcija null izaziva NullPointerException čak i nakon što je raspon iscrpljen.

Primjeri

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

Rezultat

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

`not-an-email` prolazi provjeru, ali `null` za `email` izaziva iznimku. Raspon prosljeđuje `7` akciji, zatim uz valjanu akciju vraća `false`, a pri posljednjem pozivu još uvijek odbija `null`. Pretvorba `(IntConsumer) null` odabire preopterećenje za primitivni tip.

Povezane lekcije

  • Java · Lekcija 8 · Napredno · Verzija: 2
  • Java · Lekcija 23 · Napredno · Verzija: 2

Izvori