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
- Java SE 21 API — Objects.requireNonNull(T)
- Java SE 21 API — Objects.requireNonNull(T, String)
- Java SE 21 API — Objects.requireNonNull(T, Supplier<String>)
- Java SE 7 API — Objects
- Java SE 21 API — Spliterator.OfPrimitive.tryAdvance(T_CONS)
- Java SE 21 API — Spliterator.OfInt
- Java Language Specification, Java SE 21 — §15.12.4.2 Evaluate Arguments
- Java Language Specification, Java SE 21 — §15.12.2.5 Choosing the Most Specific Method