CKTIS / Java
Objects.requireNonNull — проверка на референция и съобщение за грешка
Провери задължителен параметър: `Objects.requireNonNull` връща същата референция, ако тя не е `null`. При `null` методът обикновено хвърля `NullPointerException`. Можеш да зададеш собствено съобщение.
Версия: Java SE 21
Синтаксис
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)В Java SE 21 Objects.requireNonNull е статичен метод с типов параметър в класа java.util.Objects. Импортирай java.util.Objects, за да използваш краткото име Objects. Ако obj не е null, методът връща точно същата референция от тип T, без да копира обекта. Ако obj е null, методът хвърля NullPointerException, вместо да върне стойност, освен ако доставчикът на съобщението сам не хвърли изключение или грешка.
Използвай го в началото на метод или конструктор, за да отхвърлиш веднага null за задължителен параметър. Objects.requireNonNull(obj) не приема собствено съобщение. В Objects.requireNonNull(obj, "name must not be null") вторият аргумент е String, който служи като съобщение на изключението, а не като заместваща стойност. Изразът за аргумента от тип String се изчислява преди извикването, дори когато obj не е null.
Ако създаването на съобщението е трудоемко, можеш да подадеш Supplier<String> от пакета java.util.function, например Objects.requireNonNull(obj, () -> buildMessage()). Тялото на ламбда израза се изпълнява само ако obj е null. Ако доставчикът хвърли непроверявано изключение или грешка от тип Error, то се предава нататък без промяна, а requireNonNull не хвърля свое NullPointerException. Objects.requireNonNull(obj, null) не се компилира, защото null е съвместимо и със String, и със Supplier<String>. Използвай варианта с един аргумент, ако не ти трябва собствено съобщение.
Методът проверява само дали референцията е null: празен низ преминава проверката. Ако искаш да замениш null, вместо да го отхвърлиш, използвай Objects.requireNonNullElse със заместваща стойност, различна от null.
Примери
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());
}
}
}Резултат
true name must not be null
Първият ред е `true`, защото `==` сравнява референциите, а полето съдържа същата референция, която е подадена на конструктора. При второто извикване конструкторът хвърля изключение; блокът `catch` отпечатва само съобщението, върнато от `getMessage()`.
Свързани уроци
- Java · Урок 28 · Средно · Версия: 2