《Effective Java》解读第54条:返回零长度的数组或者集合,而不是null

第54条:返回零长度的数组或者集合,而不是null

当方法返回一个数组或集合时,如果没有找到任何元素(即结果为空),应该返回一个零长度的数组或空集合,而不是返回 null。

为什么避免返回 null?

方法如果可以返回null,那么调用方需要进行检测,忘记检测会造成很常见的空指针错误。

java 复制代码
List<Cheese> cheeses = shop.getCheeses();
if (cheeses != null && cheeses.contains(Cheese.STILTON)) {
    System.out.println("Jolly good, just the thing.");
}

不同情况下null的影响:

  • 增强 for 循环:null 会直接抛异常,而空集合会正常跳过。

  • Stream API:null 无法直接调用 .stream(),而空集合可以。

  • Optional:即使使用 Optional,Optional.of(emptyList) 也比 Optional.ofNullable(null) 更清晰。

当然,你无法保证第三方一定不会返回null,所以一般调用第三方接口时,都会防御性的判断是否为空。

正确做法

一般情况,返回一个零长度的集合:

java 复制代码
public List<String> getNames() {
    if (noNames) {
        return Collections.emptyList();   // 不可变空列表
    }
    return new ArrayList<>(names);
}
java 复制代码
// The right way to return a possibly empty array
public Cheese[] getCheeses() {
    return cheesesInStock.toArray(new Cheese[0]);
}

相对于返回null,零数组的创建会消耗性能。

可以进行优化,返回Collections.emptyList(),这种纳秒级别优化,几乎用不到,为了节省一次 new ArrayList<>() 而引入特殊判断逻辑(isEmpty() ? emptyList() : new ArrayList<>(...))反而使代码更复杂、可读性下降,书中的原则一直是:首先写清晰正确的代码,只在必要时优化。

java 复制代码
// Optimization - avoids allocating empty collections
public List<Cheese> getCheeses() {
    return cheesesInStock.isEmpty() ? Collections.emptyList() : new ArrayList<>(cheesesInStock);
}

利用 Collections.emptyList() 返回一个不可变的空列表,多次调用返回的是同一个对象,避免了重复分配的开销。如果返回 Set 则使用 Collections.emptySet(),返回 Map 则使用 Collections.emptyMap()。

注意:

java 复制代码
// √
cheesesInStock.toArray(new Cheese[0])
// ×
cheesesInStock.toArray(new Cheese[cheesesInStock.size()]);

不要为其预设大小,这种做法反而会损害性能,适得其反。

总结

永远不要返回 null,而应该返回一个零长度的数组或者集合。如果返回 null,那么会使 API 更难使用,也更容易出错,而且没有任何性能优势。

相关推荐
就叫_这个吧1 小时前
Java递归方法实现面包屑导航
java·开发语言
fīɡЙtīиɡ ℡2 小时前
AI 应用系统设计
java·开发语言·人工智能
城管不管2 小时前
重生——第十一次面试之挖财一面2026.8.19已OC
java·服务器·jvm·数据库·spring·面试·职场和发展
码匠许师傅2 小时前
【C++ 面试真题】26. 聊聊 C++ 的智能指针
java·c++·面试
AI绘画哇哒哒2 小时前
【建议收藏!】35岁后端血泪忠告,这3类人别硬转Agent(过来人亲述)
java·人工智能·后端·ai·程序员·大模型·agent
聪明蛋子哟2 小时前
Stagehand v3多语言SDK:Python/Go/Rust/Java下的浏览器自动化统一方案
python·golang·rust
最强小杰3 小时前
gpt-5.6-sol 频繁报 503 怎么办?区分容量熔断和限速 429 的排查方法 + 可复用 retry wrapper
java·人工智能·gpt·ai
今天AI了吗3 小时前
Python 基础语法(一):常量、变量、输入输出与运算符
开发语言·数据库·人工智能·python·sql·深度学习·机器学习
卷无止境3 小时前
Windows 上丝滑开发 Python,并稳定构建 Docker 镜像
后端·python·docker
TELL5214 小时前
selenium webdriver 第二次初始化的异常
开发语言·python