CKTIS / Java
Objects.requireNonNull: проверка на референции
В Java SE 21 методът `Objects.requireNonNull` връща същата референция, ако тя не е `null`, а в противен случай хвърля изключение. Не проверява съдържанието на обекта.
Версия: Java SE 21
Синтаксис
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 е статичен обобщен метод в java.util.Objects. Ако obj не е null, методът връща същата референция като T, така че резултатът може да се използва директно при присвояване. Ако obj е null, методът не връща заместваща стойност. Той хвърля NullPointerException, освен ако във варианта с доставчик get() хвърли изключение. В такъв случай се разпространява изключението от get().
Вариантът с един аргумент не приема съобщение. При претоварения вариант със String Java изчислява израза за съобщението преди извикването, дори когато obj не е null. При Supplier<String> изразът, който подава доставчика, също се изчислява предварително, но методът извиква get() за създаване на съобщението само ако obj е null, а доставчикът не е null. Първите два варианта са налични от Java 7, а този с доставчик — от Java 8. Литералът null като втори аргумент е двусмислен без явно преобразуване на типа.
Конструкторът на Contact отхвърля null поотделно за всеки от трите текстови аргумента: firstName, lastName и email. Празните низове преминават тази проверка, а форматът на имейл адреса трябва да се проверява отделно.
В tryAdvance провери action, преди да провериш дали диапазонът е изчерпан. При валидно действие методът връща false, ако няма останали елементи. Ако има елемент, методът го подава на действието и връща true след нормалното му приключване. Действие със стойност null предизвиква NullPointerException дори след изчерпване на диапазона.
Примери
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());
}
}
}Резултат
not-an-email NullPointerException: email 7 true false NullPointerException: action
`not-an-email` преминава проверката, но `null` за `email` предизвиква изключение. Диапазонът подава `7` на действието, после връща `false` при валидно действие, а при последното извикване отново отхвърля `null`. Преобразуването `(IntConsumer) null` избира претоварения вариант за примитивния тип.
Свързани уроци
- Java · Урок 8 · Напреднало · Версия: 2
- Java · Урок 23 · Напреднало · Версия: 2
Източници
- 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