---

id: 45

slug: "optional-or"

title: "Optional.or() fallback"

category: "streams"

difficulty: "intermediate"

jdkVersion: "9"

oldLabel: "Java 8"

modernLabel: "Java 9+"

oldApproach: "Nested Fallback"

modernApproach: ".or() chain"

oldCode: |-

Optional<Config> cfg = primary();

if (!cfg.isPresent()) {

cfg = secondary();

}

if (!cfg.isPresent()) {

cfg = defaults();

}

modernCode: |-

Optional<Config> cfg = primary()

.or(this::secondary)

.or(this::defaults);

summary: "Chain Optional fallbacks without nested checks."

explanation: "Optional.or() returns the original Optional if it has a value, otherwise\

\ evaluates the supplier to get an alternative Optional. Suppliers are lazy — only\

\ called when needed."

whyModernWins:

- icon: "🔗"

title: "Chainable"

desc: "Stack fallbacks in a readable pipeline."

- icon: "⚡"

title: "Lazy evaluation"

desc: "Fallback suppliers only execute if needed."

- icon: "📖"

title: "Declarative"

desc: "Reads as 'try primary, or secondary, or defaults'."

support:

state: "available"

description: "Widely available since JDK 9 (Sept 2017)"

prev: "streams/optional-ifpresentorelse"

next: "streams/predicate-not"

related:

- "streams/stream-iterate-predicate"

- "streams/stream-gatherers"

- "streams/stream-of-nullable"

docs:

- title: "Optional.or()"

href: "https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/Optional.html#or(java.util.function.Supplier)"