CKTIS / Java
Objects.requireNonNull: preverjanje referenc
V Javi SE 21 metoda `Objects.requireNonNull` vrne isto referenco, če ni `null`, sicer pa sproži izjemo. Preveri prisotnost argumenta, ne veljavnosti njegove vsebine.
Različica: 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 je statična generična metoda razreda java.util.Objects. Če obj ni null, metoda vrne isto referenco kot T, zato lahko rezultat uporabiš neposredno pri prirejanju. Če je obj enak null, metoda ne vrne nadomestne vrednosti. Sproži NullPointerException, razen če v različici z dobaviteljem get() sproži izjemo. V tem primeru se naprej prenese ta izjema.
Različica z enim argumentom ne sprejme sporočila. Pri preobremenitvi s String Java ovrednoti izraz za sporočilo pred klicem, tudi če obj ni null. Pri Supplier<String> se izraz za dobavitelja prav tako ovrednoti pred klicem, vendar metoda za pripravo sporočila pokliče get() samo, če je obj enak null in dobavitelj ni null. Prvi dve različici sta na voljo od Jave 7, različica z dobaviteljem pa od Jave 8. Dobesedni null kot drugi argument je brez pretvorbe tipa dvoumen.
Konstruktor Contact zavrne null za vsakega od treh besedilnih argumentov posebej: firstName, lastName in email. Prazni nizi prestanejo to preverjanje, obliko e-poštnega naslova pa je treba preveriti posebej.
V tryAdvance preveri action, preden preveriš, ali je obseg izčrpan. Pri veljavnem dejanju metoda vrne false, če ni več elementov. Če element še obstaja, ga poda dejanju in po njegovem običajnem zaključku vrne true. Dejanje null sproži NullPointerException tudi po izčrpanju obsega.
Primeri
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` prestane preverjanje, `null` za `email` pa sproži izjemo. Obseg poda dejanju vrednost `7`, nato ob veljavnem dejanju vrne `false`, pri zadnjem klicu pa še vedno zavrne `null`. Pretvorba `(IntConsumer) null` izbere preobremenitev za primitivni tip.
Povezane lekcije
- Java · Lekcija 8 · Napredna · Različica: 2
- Java · Lekcija 23 · Napredna · Različica: 2
Viri
- 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