如何使用 Java Stream API 比较订单与库存清单并验证订单可履行性

本文介绍如何利用 Ja va Stream API 高效判断一组订单是否可在现有库存中全部满足，核心是将库存按商品名聚合为映射表，再逐条校验订单需求数量是否不超过对应库存。

在电商、仓储或供应链系统里，一个很常见的场景是：手里有一份订单列表（List），还有一份库存商品列表（List），需要快速判断这批订单到底能不能“履行”——说白了，就是每种商品的订购数量都不能超过当前库存总量。只要有一种商品不够，整张订单就算完不成。

当然，用传统循环也能实现这个逻辑，但借助 Stream API 写出来会简洁得多，代码读起来也清晰、函数式，还带着一股“现代 Ja va”的味道。关键的一步在于：把非结构化的库存列表，转成一个以商品名为键、总库存量为值的 Map。这样一来，后续的查找就能做到 O(1) 时间复杂度，效率直接拉满。

✅ 推荐实现：用 Collectors.groupingBy 处理重复商品名

库存里同一商品可能出现在多个批次里（比如有好几批“apple”），所以得先把总量汇总起来：

Map stockMap = productList.stream()
    .collect(Collectors.groupingBy(
        Product::getName,
        Collectors.summingInt(Product::getAmount)
    ));

然后遍历订单，逐条比对就好了：

boolean isFulfillable = orderList.stream()
    .allMatch(order -> 
        stockMap.getOrDefault(order.getName(), 0) >= order.getAmount()
    );
System.out.println("订单可履行: " + isFulfillable); // 输出: false（因 juice 需 3 但只有 2，milk 需 5 但只有 4）

这里用 allMatch() 非常聪明——只有当所有订单项都满足库存条件时才返回 true；一旦有某个不满足，就会短路并返回 false，性能更好。

⚠️ 注意事项与优化建议

• 商品名唯一性假设：如果业务上能保证 productList 中每个 Product.name 都是唯一的（没有重复），那么可以用更轻量的 toMap：

  Map stockMap = productList.stream()
      .collect(Collectors.toMap(Product::getName, Product::getAmount));

  但要注意，遇到重复商品名时 toMap 会直接抛出 IllegalStateException，所以得确保数据前提成立才敢用。

• 空值安全：用 getOrDefault(key, 0) 能避免 NullPointerException——如果订单里有库存根本没记录的商品（比如“banana”），默认库存就是 0，自然判定为不可履行，逻辑也没毛病。

• 扩展性考虑：假如你还想返回具体的缺货详情（比如“juice: required 3, a vailable 2”），可以改用 map() + filter() 来收集不满足的项：

  List shortages = orderList.stream()
      .filter(order -> stockMap.getOrDefault(order.getName(), 0) < order.getAmount())
      .map(order -> String.format("%s: required %d, a vailable %d",
          order.getName(),
          order.getAmount(),
          stockMap.getOrDefault(order.getName(), 0)))
      .toList();

说到底，Stream API 不仅让逻辑清晰可读，还天然支持惰性求值与函数组合。掌握 groupingBy + summingInt 和 allMatch 的组合模式，正是处理这类“多对一匹配与聚合校验”问题的经典套路。