Java中如何优雅检查对象及其成员是否为空（含代码场景）

针对你提到的检查类X实例及其内部Map成员的场景，我来分享几种比直接写null判断更优雅的实现方式，这些都是日常开发中常用的方案：

1. 使用Java 8+的Optional API #

Java 8引入的Optional能帮我们摆脱繁琐的嵌套空判断，让代码逻辑更流畅直观：

private void checkFunction(X x) {
    Optional.ofNullable(x)
            .map(X::getMap)
            .filter(map -> !map.isEmpty())
            .orElseThrow(() -> new IllegalArgumentException("X对象或其内部Map不能为空"));
}

这里的逻辑一步步很清晰：

• 先把x包装成Optional，避免直接调用方法触发NullPointerException
• 通过map提取出内部的Map成员
• 用filter过滤掉空的Map
• 如果任何一步不满足条件，直接抛出指定异常

2. 借助第三方工具库简化代码 #

很多成熟的工具库都封装了完善的空检查方法，能大幅减少重复代码：

方式一：Apache Commons Lang + Commons Collections #

import org.apache.commons.lang3.ObjectUtils;
import org.apache.commons.collections4.MapUtils;

private void checkFunction(X x) {
    if (ObjectUtils.isEmpty(x) || MapUtils.isEmpty(x.getMap())) {
        throw new IllegalArgumentException("X对象或其内部Map不能为空");
    }
}

ObjectUtils.isEmpty()会帮我们检查对象是否为null，MapUtils.isEmpty()则会同时判断Map是null还是空集合，省去自己写双重判断的麻烦。

方式二：Guava的Preconditions #

Guava的Preconditions类专门用来做前置条件检查，代码意图非常明确：

import com.google.common.base.Preconditions;
import com.google.common.collect.Maps;

private void checkFunction(X x) {
    Preconditions.checkNotNull(x, "X对象不能为空");
    Preconditions.checkArgument(!Maps.isEmpty(x.getMap()), "X对象的Map不能为空");
}

它会在条件不满足时直接抛出对应类型的异常（比如NullPointerException或IllegalArgumentException），不用手动写if判断块。

3. 自定义工具类封装通用逻辑 #

如果不想引入第三方库，也可以自己封装一个通用的空检查工具类，方便全项目复用：

public class NullCheckUtils {
    // 检查对象非空
    public static <T> void requireNonNull(T obj, String errorMsg) {
        if (obj == null) {
            throw new NullPointerException(errorMsg);
        }
    }

    // 检查Map非空且非空集合
    public static <K, V> void requireNonEmptyMap(Map<K, V> map, String errorMsg) {
        requireNonNull(map, errorMsg);
        if (map.isEmpty()) {
            throw new IllegalArgumentException(errorMsg);
        }
    }
}

// 调用方式
private void checkFunction(X x) {
    NullCheckUtils.requireNonNull(x, "X对象不能为空");
    NullCheckUtils.requireNonEmptyMap(x.getMap(), "X对象的Map不能为空");
}

这种方式可以根据项目的具体需求定制检查逻辑，而且代码可读性拉满，其他同事一看就懂。

对比原实现的优势 #

原实现的逻辑本身没问题，但上面这几种方式：

• 更贴合现代Java的编程风格，代码更简洁流畅
• 意图表达更明确，降低后期维护成本
• 借助工具库的话，不用自己重复造轮子，减少出错概率

内容的提问来源于stack exchange，提问作者user1386966