Understanding Java Optional: API Overview and Practical Usage

At the beginning the article describes the common NullPointerException (NPE) issue when accessing nested objects, illustrated with a UML diagram and a simple code example user.getAddress().getProvince(); that throws NPE if user is null.

To avoid such ugly null‑checks, Java 8 introduces the Optional class. The article first presents the four core factory methods:

Optional(T value) – private constructor.

Optional.empty() – returns a singleton empty instance.

Optional.of(T value) – creates an Optional and throws NPE when value is null.

Optional.ofNullable(T value) – returns empty() if value is null, otherwise creates an Optional.

Next, three terminal operations are explained:

orElse(T other) – returns the contained value or a default.

orElseGet(Supplier<? extends T> supplier) – lazily provides a default value.

orElseThrow(Supplier<? extends Throwable> exceptionSupplier) – throws a supplied exception when the value is absent.

The transformation methods map(Function<? super T, ? extends U> mapper) and flatMap(Function<? super T, Optional<U>> mapper) are shown, highlighting the difference in return types.

Presence checks are covered with isPresent() and ifPresent(Consumer<? super T> consumer) , demonstrating how to execute code only when a value exists.

The filtering operation filter(Predicate<? super T> predicate) is described, returning the same Optional when the predicate matches or empty() otherwise.

Finally, several practical examples replace traditional nested if statements with concise Optional chains, such as retrieving a city name, conditionally executing logic, and creating or retrieving a user object based on name validation.