Strona główna / Errors / Objects.requireNonNullElse()
Errors Początkujący

Objects.requireNonNullElse()

Pobierz wartość nie-null z przejrzystą wartością domyślną, bez operatora trójkowego.

Porównanie kodu
✕ Java 8 
String name = input != null
    ? input
    : "default";
// easy to get the order wrong
✓ Java 9+ 
String name = Objects
    .requireNonNullElse(
        input, "default"
    );
Widzisz problem z tym kodem? Daj nam znać.
Dlaczego nowoczesne podejście wygrywa
📖

Jasna intencja

Nazwa metody dokładnie opisuje co robi.

🛡️

Null-bezpieczna wartość domyślna

Wartość domyślna jest również sprawdzana pod kątem null.

📏

Czytelny

Lepszy niż operator trójkowy dla prostej logiki null-lub-domyślny.

Stare podejście
Trójkowe sprawdzenie null
Nowoczesne podejście
requireNonNullElse()
Od JDK
9
Poziom trudności
Początkujący
Wsparcie JDK
Objects.requireNonNullElse()
Dostępne

Szeroko dostępne od JDK 9 (wrzesień 2017)

Jak to działa

requireNonNullElse zwraca pierwszy argument jeśli nie jest null, w przeciwnym razie drugi. Wartość domyślna sama nie może być null — rzuca NPE jeśli oba są null, wykrywając błędy wcześnie.

Powiązana dokumentacja
Objects.requireNonNullElse() ↗ Objects.requireNonNullElseGet() ↗
Dowód
Zobacz źródło dowodu ↗
Powiązane wzorce
Errors Początkujący

Helpful NullPointerExceptions

Java 8
// Old NPE message:
// "NullPointerException"
// at MyApp.main(MyApp.java:42)
// Which variable was null?!
Java 14+
// Modern NPE message:
// Cannot invoke "String.length()"
// because "user.address().city()"
// is null
// Exact variable identified!
Najedź, aby zobaczyć nową wersję ➜
JDK 14+ →
Errors Średniozaawansowany

Record-based error responses

Java 8
// Verbose error class
public class ErrorResponse {
    private final int code;
    private final String message;
    // constructor, getters, equals,
    // hashCode, toString...
}
Java 16+
public record ApiError(
    int code,
    String message,
    Instant timestamp
) {
    public ApiError(int code, String msg) {
        this(code, msg, Instant.now());
    }
}
Najedź, aby zobaczyć nową wersję ➜
JDK 16+ →
Errors Początkujący

Optional chaining

Java 8
String city = null;
if (user != null) {
    Address addr = user.getAddress();
    if (addr != null) {
        city = addr.getCity();
    }
}
if (city == null) city = "Unknown";
Java 9+
String city = Optional.ofNullable(user)
    .map(User::address)
    .map(Address::city)
    .orElse("Unknown");
Najedź, aby zobaczyć nową wersję ➜
JDK 9+ →