Java Optional.ifPresentOrElse 怎样同时处理有值和空结果

如果一个查询结果既可能有值，也必须在没有结果时执行另一段动作，Java 的 Optional.ifPresentOrElse 可以把两条路径放在同一个调用里。它只负责触发副作用，不负责返回替代值；需要返回值时，应改用 orElse、orElseGet 或 orElseThrow。

官方地址：https://docs.oracle.com/en/java/javase/26/docs/api/java.base/java/util/Optional.html

有值时执行第一个 Consumer，空值时执行第二个 Runnable；两个分支都只执行一条，方法本身返回 void。

两个回调分别处理哪一条路径

方法签名是 void ifPresentOrElse(Consumer super T> action, Runnable emptyAction)。第一个参数能拿到 Optional 中的值，第二个参数没有参数，只表示“没有值时做什么”。如果 Optional 有值，空分支不会执行；如果 Optional 为空，有值分支也不会执行。

从旧式 ifPresent 迁移到双分支写法

旧代码常把 if (optional.isPresent()) 与 else 分开写，也有人只调用 ifPresent，导致空结果没有可见处理。迁移时先把真正的副作用提取成两个短回调，再确认空分支不会偷偷改变返回值。

import java.util.Optional;

class UserNotice {
    static void notifyUser(Optional nickname) {
        // 有值分支只负责使用已经存在的昵称。
        nickname.ifPresentOrElse(
                value -> System.out.println("发送给：" + value),
                // 空分支不接收参数，适合记录未命中或走兜底动作。
                () -> System.out.println("未找到昵称，使用站内通知"));
    }
}

这里的两个 lambda 是互斥执行的。不要在空分支里重新查询并假设第一次查询仍然有效；如果需要计算默认值并返回给调用方，直接写成 String value = nickname.orElseGet(UserNotice::defaultName) 更清楚。

和 orElse、orElseGet、orElseThrow 怎样分工

ifPresentOrElse 的结果类型是 void，因此它适合“做动作”。orElse 总会先计算传入的默认表达式，orElseGet 只在空值时调用供应器；两者都把结果交回调用方。orElseThrow 则把空结果转换为异常。

Optional nickname = loadNickname();

// 需要默认文本并继续计算：只在为空时生成默认值。
String displayName = nickname.orElseGet(UserNotice::defaultName);

// 业务上必须存在：空值分支直接抛出异常。
String requiredName = nickname.orElseThrow(() ->
        new IllegalStateException("昵称不存在"));

常见误区是用 ifPresentOrElse 设置外部变量，再在回调结束后读取它。这会引入可变状态，也容易在并发代码中失去边界。能用返回值表达的逻辑，优先保持在 map、flatMap 和 orElseGet 链中。

迁移时需要回归的边界

• Java 版本：ifPresentOrElse 自 Java 9 起存在，Java 8 工程需要保留旧式分支或升级运行环境。
• 回调为空：有值时第一个回调为 null，或空值时第二个回调为 null，都会触发 NullPointerException。
• 异常传播：回调中的运行时异常不会被方法吞掉，应由调用层决定记录、重试还是失败。
• 分支互斥：测试时分别构造 Optional.of 与 Optional.empty，确认没有重复日志、重复通知或遗漏兜底动作。

常见问题

ifPresentOrElse 能返回处理后的对象吗？

不能。它返回 void；需要新对象时使用 map、flatMap 或默认值方法。

空分支能写成带参数的 lambda 吗？

不能。空分支类型是 Runnable，只能写无参动作，例如 () -> log()。

什么时候继续使用 ifPresent？

如果空结果本来就无需动作，ifPresent 更直接；只有确实存在空分支副作用时才补上 ifPresentOrElse。