Class Optionals

java.lang.Object

com.github.javaparser.utils.Optionals

public final class Optionals
extends Object

Utility methods for Optional, backporting Java 9+ operations to Java 8.

This class emulates Optional.or() chaining from Java 9+, allowing lazy evaluation of alternative Optional values.

Migration notice: Remove this class when upgrading to Java 11+. Replace Optionals.or() calls with native Optional.or() chaining.

Since:

3.28.0

Method Summary

Modifier and Type	Method	Description
static <T> Optional<T>	or(Supplier<Optional<T>>... suppliers)	Returns the first present Optional from the given suppliers.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

or

@SafeVarargs
public static <T> Optional<T> or(Supplier<Optional<T>>... suppliers)

Returns the first present Optional from the given suppliers.

Emulates Java 9+ Optional.or() chaining with varargs support:

// Java 9+
Optional<T> result = opt1.or(() -> opt2).or(() -> opt3);

// Java 8 with Optionals
Optional<T> result = Optionals.or(() -> opt1, () -> opt2, () -> opt3);

Suppliers are evaluated lazily with short-circuit evaluation.

Type Parameters:

T - the type of the value

Parameters:

suppliers - suppliers of Optionals to evaluate in order

Returns:

the first present Optional, or empty if all are empty