Java 如何优雅的处理 null

283 阅读6分钟

1. Optional 简介

Optional 出现之前,我们处理 null,一定要写 if 语句进行处理,如果要使用的属性隐藏很深,那就像老母猪戴胸罩,一套又一套,很是繁琐,比如:

if (coordinate != null) {
    if (coordinate.getCol() != null) {
        // ....
    }
    if (coordinate.getRow() != null) {
        // ....
    }
}

上面还只是用第一层的属性,就要这样写了,如果隐藏更深,代码就会很繁杂,不直观,维护性也不好,此时我们的救星——Optional 就上线了,Optional 是 jdk 8 提供的用于处理 null 的新 api,上述代码可简化为:

Optional.ofNullable(coordinate)
        .map(Coordinate::getCol)
        .ifPresent(c -> {
            // ...
        });
Optional.ofNullable(coordinate)
        .map(Coordinate::getRow)
        .ifPresent(c -> {
            // ...
        });

使用 Optional 的优点是可以更优雅地处理可能为 null 的值,避免显式的 null 检查。同时 Optional 提供一系列链式调用,可以使代码逻辑更为清晰。

2. of()ofNullable()

2.1 Optional.of(T value)

  • 作用:创建一个包含非 null 值的 Optional 对象。

  • 对 null 的处理

    • 如果传入的 value 是 null会立即抛出 NullPointerException
  • 适用场景:明确知道值不为 null 时使用,是一种“快速失败”(Fail-Fast)的设计。

  • 示例

    // 明确知道 name 不为 null
    String name = "John";
    Optional<String> opt = Optional.of(name); // 正常创建 Optional
    
    String name = null;
    Optional<String> opt = Optional.of(name); // 抛出 NullPointerException
    

2.2 Optional.ofNullable(T value)

  • 作用:创建一个可能为空的 Optional 对象。

  • 对 null 的处理

    • 如果传入的 value 是 null会返回一个空的 Optional 对象(Optional.empty() ,而不是抛出异常。
  • 适用场景:值可能为 null 时使用,更安全。

  • 示例

    String name = "John";
    Optional<String> opt = Optional.ofNullable(name); // 正常创建 Optional
    
    String name = null;
    Optional<String> opt = Optional.ofNullable(name); // 返回 Optional.empty()
    

2.3 核心差异总结

方法Optional.of(T value)Optional.ofNullable(T value)
接受 null 值❌ 直接抛出 NullPointerException✔️ 返回 Optional.empty()
设计目的强制要求值非 null允许值为 null
适用场景确定值一定存在时不确定值是否存在(可能为 null)时

2.4 使用建议

  • 使用 of()
    当明确知道值不为 null,且需要强制保证时。例如:

    // 从非空集合中获取第一个元素
    List<String> list = Arrays.asList("A", "B");
    Optional<String> first = Optional.of(list.get(0));
    
  • 使用 ofNullable()
    当值可能为 null,需要安全处理时。例如:

    // 从可能返回 null 的方法获取值
    String data = fetchFromExternalService(); // 可能返回 null
    Optional<String> opt = Optional.ofNullable(data);
    

2.5 链式操作示例

结合 map()orElse() 等方法,可以更安全地处理值:

// 安全获取嵌套属性
User user = ...; // 可能为 null
String cityName = Optional.ofNullable(user)
                          .map(User::getAddress)
                          .map(Address::getCity)
                          .orElse("Unknown");

2.6 为什么要有这种区分?

  • of() 的严格性
    强制开发者明确值的存在性,避免隐藏潜在的 null 问题。如果误用 of() 包装 null,会立即抛出异常,帮助快速定位问题。
  • ofNullable() 的灵活性
    为不确定的场景提供安全封装,避免代码中充斥 if (x != null) 的检查。

3. of()方法的必要性

在明确知道传入的 value 不为 null 的情况下,使用 Optional.of(value) 并非多余,它实际上是一种强化代码意图提升代码健壮性的编程实践。以下是具体原因和优点:

3.1 明确代码契约,增强可读性

  • Optional.of() 是一种显式声明
    通过 Optional.of(value),你向代码的阅读者(包括未来的自己或其他开发者)传达了一个清晰的信号:此处的 value 应该且必须是非 null 的。这种声明性编程让代码的意图更加透明。
  • 对比直接使用 value
    如果直接使用 value,阅读者需要依赖上下文推断其非空性,而 Optional.of(value) 通过类型系统直接表达这一约束。
// 示例1:直接使用 value(隐含非空,但无显式保证)
String name = "John";
processName(name); 

// 示例2:使用 Optional.of()(显式声明非空)
Optional<String> nameOpt = Optional.of("John");
processName(nameOpt.orElseThrow()); 

3.2 防御性编程,防止未来代码腐化

  • 提前暴露潜在问题
    即使当前 value 确定不为 null,未来代码的修改(如重构、参数传递、外部依赖变化等)可能导致 value 意外变为 null。使用 Optional.of(value) 会在第一时间抛出 NullPointerException快速定位问题源头,而不是让 null 传播到后续逻辑中。
  • 对比 ofNullable() 的隐蔽性
    如果误用 ofNullable() 包装非空值,当 value 意外变为 null 时,代码会静默返回 Optional.empty(),可能导致后续逻辑出现隐蔽的 Bug。
// 假设未来代码修改导致 value 变为 null
String value = externalService.getData(); // 未来可能返回 null

// 使用 of() → 立即抛出异常,快速定位问题
Optional.of(value); // NPE at line X

// 使用 ofNullable() → 静默返回 empty,后续逻辑可能崩溃在未知位置
Optional.ofNullable(value).map(...).orElse(...); 

3.3 强制统一代码风格,方便链式操作

  • 链式调用的一致性
    如果代码中其他部分已广泛使用 Optional 的链式方法(如 mapflatMapfilter),用 Optional.of(value) 包装非空值可以保持代码风格统一,避免混合使用普通对象和 Optional
  • 直接利用 Optional 的 API
    即使值非空,Optional 提供的方法(如 orElseThrow()ifPresent())能更安全地与其他可能为空的逻辑集成。
// 统一使用 Optional 链式操作
Optional.of(userId)
        .map(userRepository::findById)
        .filter(User::isActive)
        .orElseThrow(() -> new UserNotFoundException());

3.4 与函数式 API 或第三方库集成

  • 兼容性要求
    某些函数式接口或第三方库(如 Stream API、Spring Data)要求参数为 Optional 类型。使用 Optional.of() 可以无缝适配这些 API。

  • 示例:Spring Data 查询方法

    // Spring Data 方法定义
    Optional<User> findByEmail(String email);
    
    // 调用时明确使用 of() 表示 email 非空
    Optional<User> user = userRepository.findByEmail(Optional.of(email).orElseThrow());
    

3.5 减少隐式假设,提升代码质量

  • 消除“假性非空”风险
    即使你认为 value 非空,这种假设可能基于当前业务逻辑或特定上下文(例如数据库字段定义为 NOT NULL)。但实际中,数据库约束可能被绕过,或业务规则可能变更。使用 Optional.of(value) 将这种假设显式化,迫使开发者重新审视其可靠性。
  • 团队协作规范
    在团队中强制使用 Optional.of() 处理“理论上非空”的值,可以统一代码规范,减少因个人理解差异导致的潜在问题。

何时使用 of() vs 直接使用非空值?

场景使用 Optional.of()直接使用原始值
需要表达“值必须存在”✔️❌(无法通过类型系统表达)
参与链式 Optional 操作✔️(如 mapflatMap❌(需额外包装)
值来源不可控(如外部输入)✔️(防御性检查)❌(可能遗漏空值处理)
性能敏感场景❌(有轻微包装开销)✔️(无额外开销)

3.6 总结:Optional.of() 的核心价值

  • 显式优于隐式:用类型系统声明非空约束,替代文档或注释。
  • 快速失败(Fail-Fast) :尽早暴露问题,避免 null 传播。
  • 代码即文档:提升可读性和可维护性,降低团队协作成本。

即使你确信 value 非空,使用 Optional.of() 仍是一种符合现代 Java 最佳实践的编码方式,尤其适合对健壮性要求较高的项目。