Java StringUtils.defaultIfBlank与defaultIfEmpty有什么区别

我在整理 Java 表单默认值时，最容易混淆的不是方法名，而是“空白字符串算不算空”。Apache Commons Lang 的结论很明确：StringUtils.defaultIfBlank 会把 null、空串和只含空白字符的字符串替换成默认值；defaultIfEmpty 只替换 null 与空串，单个空格会原样保留。

官方地址：https://commons.apache.org/proper/commons-lang/

两种方法真正差在空白字符

可以把差异压缩成一张表。这里的“空白”按 Commons Lang 的 isBlank 规则理解，不等同于“长度为零”。

源码语义对应哪两个判断

两个默认方法的实现都很短：前者等价于“如果 isBlank 就回退”，后者等价于“如果 isEmpty 就回退”。理解这层关系，比死记示例更稳。

import org.apache.commons.lang3.StringUtils;

public class DefaultValueDemo {
    public static void main(String[] args) {
        // 表单输入中只有空格时，按未填写处理。
        String displayName = StringUtils.defaultIfBlank("   ", "未填写");
        // 协议字段需要保留空格时，只把真正的空串和 null 回退。
        String rawField = StringUtils.defaultIfEmpty("   ", "未提供");
        System.out.println(displayName); // 输出：未填写
        System.out.println(rawField);     // 输出：三个空格
    }
}

它们的返回类型是泛型 T extends CharSequence。因此传入 StringBuilder 时，默认值也应使用同类型或可兼容的 CharSequence，不要为了省事混入一个不相关的对象。

按业务语义选择默认值方法

我通常先问一句：输入里的空格是用户误触，还是协议的一部分？登录昵称、收货人、搜索词这类展示输入，空格往往没有有效业务含义，用 defaultIfBlank 更符合预期。配置键值、固定宽度字段或需要保留原始字符的场景，则应谨慎选择 defaultIfEmpty。

不要把两者都换成 value.trim().isEmpty()：那会创建新字符串、改变边界定义，也无法优雅处理 null。若业务要求去掉首尾空白，应把“归一化”和“默认回退”拆成两个明确步骤，并为中间值写测试。

迁移旧代码时的回归清单

1. 列出输入类别：null、空串、一个空格、多个空白、前后带空格的正常文本。
2. 确认每类输入的业务结果是“回退”还是“保留”，不要只比较最终页面看起来是否一样。
3. 检查默认值和输入值的类型，尤其是 CharSequence 子类与不可变字符串之间的转换。
4. 若从手写 null 判断迁移，保留一组参数化测试，确认没有把全角空格或业务特殊字符误归类。

最小测试可以直接覆盖边界：

import static org.apache.commons.lang3.StringUtils.defaultIfBlank;
import static org.apache.commons.lang3.StringUtils.defaultIfEmpty;
import static org.junit.jupiter.api.Assertions.assertEquals;
import org.junit.jupiter.api.Test;

class DefaultValueTest {
    @Test
    void compareBlankAndEmpty() {
        // 空白输入只应在 blank 语义下回退。
        assertEquals("fallback", defaultIfBlank(" ", "fallback"));
        assertEquals(" ", defaultIfEmpty(" ", "fallback"));
    }
}

相关问题

defaultIfBlank 会自动删除正常字符串两端的空格吗？

不会。它只判断是否为空白并决定返回原值或默认值；像 " Java " 这样的非空白字符串仍会原样返回。

defaultIfEmpty(null, null) 会报错吗？

不会，默认值本身允许为 null，结果也可以是 null。若业务必须得到非空文本，应把默认常量设计成非空并单独测试。

只想判断空白而不回退，应该用什么？

使用同一语义的 StringUtils.isBlank；只判断 null 或空串则用 isEmpty，不要先猜测再调用默认值方法。