Java Optional.or 的延迟备用值设计

Java 里有两个可选数据源时，Optional.or 适合表达“主来源没有值，再惰性尝试备用来源”。它接收的是 Supplier>，因此既能延迟执行查询，又能保留 Optional 的链式状态。主来源命中时，备用 Supplier 不会被调用。

官方参考：https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/Optional.html

先把主来源和备用来源统一成 Optional

延迟备用值的关键不是简单写一个默认字符串，而是让两条来源拥有同一个结果类型。比如先查本地缓存，缓存没有命中时再查数据库：

import java.util.Optional;

static Optional findUserName(String userId) {
    Optional primary = findFromCache(userId);
    return primary.or(() -> {
        // 只有缓存为空时才访问备用数据源
        return findFromDatabase(userId);
    });
}

static Optional findFromCache(String userId) {
    // 示例只表示缓存查询结果，不把空值转换成 null
    return Optional.empty();
}

static Optional findFromDatabase(String userId) {
    // 数据库没有记录时返回 Optional.empty()
    return Optional.of("Ada");
}

这里的 or 并不会拆出字符串再重新包装。缓存有值时直接返回原 Optional；缓存为空时，Supplier 产生的数据库 Optional 成为结果。这种设计适合多级配置、缓存回源和分层查找。

把昂贵操作放进 Supplier，才能真正延迟

“延迟”指的是备用函数本身延迟执行，而不是只把结果包在 Optional 里。下面的计数器用于说明调用关系：当主值存在时，loadFromRemote 不会被调用；当主值为空时，它才开始执行。

import java.util.Optional;
import java.util.concurrent.atomic.AtomicInteger;

AtomicInteger remoteCalls = new AtomicInteger();
Optional primary = Optional.of("local-value");

Optional value = primary.or(() -> {
    // 远程调用和计数都属于备用分支，不能移到 or 之前
    remoteCalls.incrementAndGet();
    return loadFromRemote();
});

static Optional loadFromRemote() {
    // 真实项目中这里可以替换为 HTTP、数据库或文件查询
    return Optional.of("remote-value");
}

不要先写成 Optional fallback = loadFromRemote() 再传入 or，那样远程调用已经发生，失去了惰性。Supplier 内的日志、指标、重试和资源操作也应只服务于备用分支，并明确它们可能产生的副作用。

用 or 还是 orElseGet：看调用方需要什么

两者都可以延迟备用逻辑，但返回形态不同。or 保留 Optional，适合继续处理；orElseGet 直接得到 T，适合链路末端需要具体值的场景。

例如，备用来源还要继续过滤时，应先保留容器：

Optional selected = findFromCache("u-42")
    .or(() -> {
        // 备用查询也必须返回 Optional，便于后续继续处理
        return findFromDatabase("u-42");
    })
    .filter(name -> {
        // 只保留满足业务条件的结果
        return name.length() >= 2;
    });

空结果、异常与链式边界的检查清单

Oracle API 明确规定，or 的 Supplier 为 null，或 Supplier 返回 null，都会抛出 NullPointerException。因此备用查询没有结果时必须返回 Optional.empty()，不能用 null 表示“查不到”。

• 备用方法签名优先使用 Optional，并在所有分支返回 Optional。
• 只在确实需要备用分支时记录日志或调用外部服务，避免在 Supplier 外部提前构造。
• 异常是否传播由备用方法决定；or 只负责选择 Optional，不会自动吞掉数据库或网络异常。
• Java 9 及以上才有 Optional.or；更低版本需要显式判断或升级运行环境。

常见问题

Optional.or 能直接接收一个字符串吗？

不能。它要的是产生 Optional 的 Supplier；如果只需要字符串，应使用 orElseGet，或者先把字符串包装成 Optional.ofNullable。

备用 Supplier 返回 Optional.empty() 会怎样？

最终结果仍为空 Optional，不会自动变成 null，也不会继续寻找不存在的第三层来源，除非代码再显式连接下一次 or。

主 Optional 有值时还要担心 Supplier 内的异常吗？

正常情况下不会执行该 Supplier，因此其中的查询和异常也不会发生；但要把真正的副作用放进 Lambda 内，避免在创建 Lambda 前就执行计算。