Java Gatherers.windowFixed 怎样把 Stream 切成固定大小窗口
需要把一串订单、日志或任务按固定数量分批时,Java Stream 不必先手写一个临时集合和下标循环。Java 24 引入的 Gatherers.windowFixed(int) 可以把有序 Stream 组织成固定大小的窗口:窗口之间不重叠,最后一组允许不足指定大小,空流则不会产生窗口。
windowFixed(3)会得到[1,2,3]、[4,5,6]、[7,8]这样的不重叠窗口。- 窗口大小必须大于 0;结果窗口是不可修改的 List。
- 需要相邻窗口重叠时选
windowSliding,不要把 fixed 当成滑动窗口。
windowFixed 适合把 Stream 切成不重叠批次
固定窗口的核心是“每个元素只属于一个窗口”。例如每 3 条任务组成一个批次,8 个元素会留下一个只有 2 条的尾批次。它保留 Stream 的 encounter order,所以不应该把它理解成无序的分桶或按键分组。
import java.util.List;
import java.util.stream.Gatherers;
import java.util.stream.Stream;
public class FixedWindowDemo {
public static void main(String[] args) {
List> windows = Stream.of(1, 2, 3, 4, 5, 6, 7, 8)
// 每 3 个元素组成一个窗口,最后不足 3 个也保留
.gather(Gatherers.windowFixed(3))
// 收集外层窗口;内层窗口由 Gatherer 提供
.toList();
System.out.println(windows);
}
}
这段代码对应的结果形态是 [[1, 2, 3], [4, 5, 6], [7, 8]]。如果后续批处理必须严格凑满 3 条,应该在业务层明确丢弃或单独处理最后一组,而不是假设 Gatherer 会自动补齐。

fixed 和 sliding 的差别在于窗口是否重叠
如果读者的任务是“每 3 条一批”,用 windowFixed;如果任务是“每向前移动一条就观察最近 3 条”,才考虑 windowSliding。两者都接收窗口大小,但输出语义不同:fixed 的窗口不共享元素,sliding 的后一个窗口会保留前一个窗口的大部分元素。
import java.util.List;
import java.util.stream.Gatherers;
import java.util.stream.Stream;
class WindowChoice {
static List> compare() {
// fixed 适合批量提交:元素只进入一个批次
List> batches = Stream.of(1, 2, 3, 4, 5)
.gather(Gatherers.windowFixed(3))
.toList();
// sliding 适合局部观察:相邻窗口会共享元素
List> views = Stream.of(1, 2, 3, 4, 5)
.gather(Gatherers.windowSliding(3))
.toList();
// 这里只返回 fixed 结果,另一个变量用于对比两种语义
return batches;
}
}
这里的 views 会形成 [1,2,3]、[2,3,4]、[3,4,5]。因此,批量写入、批量调用外部接口通常更适合 fixed;连续窗口统计、相邻样本分析才更接近 sliding。不要只因为参数同样叫 windowSize 就混用两者。

四个边界决定代码能否稳定落地
| 情况 | windowFixed 的表现 | 处理建议 |
|---|---|---|
| 空 Stream | 不产生任何窗口 | 下游按空集合处理,不要读取第一个窗口 |
| 元素不足一组 | 产生一个较短的尾窗口 | 批处理前决定是否允许部分提交 |
| 窗口大小小于 1 | 抛出 IllegalArgumentException | 在配置进入 Stream 前检查正整数 |
| 修改窗口元素 | 窗口 List 不支持修改 | 需要修改时复制为新的 ArrayList |
尤其要注意最后一行:官方 API 说明每个窗口是不可修改的 List。它适合把窗口交给只读批处理函数;如果业务代码要排序、删除或追加元素,就先复制,不要直接调用窗口的变更方法。
import java.util.ArrayList;
import java.util.List;
import java.util.stream.Gatherers;
import java.util.stream.Stream;
class WindowBoundary {
static List mutableCopy(int size) {
if (size > windows = Stream.of(1, 2, 3, 4)
.gather(Gatherers.windowFixed(size))
.toList();
// 复制后再修改,避免直接操作不可变窗口
return new ArrayList(windows.get(0));
}
}
按业务约束做最后选择
可以把选择压缩成一个判断:元素是否应该只属于一个批次?是,就选 windowFixed;否,若每个新窗口要复用最近元素,再选 windowSliding。两者都不会替你定义失败重试、尾批次提交和窗口内对象的生命周期,这些仍然属于业务代码。
| 需求 | 优先选择 | 需要额外决定的事 |
|---|---|---|
| 批量发送、批量入库 | windowFixed | 尾窗口是否允许提交 |
| 移动平均、相邻样本分析 | windowSliding | 重叠带来的重复计算成本 |
| 配置来自外部输入 | 先校验窗口大小 | 小于 1 时直接拒绝配置 |
常见问题
windowFixed 会自动补齐最后一个窗口吗?
不会。最后一个窗口可以小于指定大小;是否等待更多数据、丢弃尾组或单独提交,需要由业务规则决定。
windowFixed 产生的 List 可以直接 add 吗?
不可以把它当作可变 List 使用。需要变更时复制成 new ArrayList(window),再执行排序或追加。
windowFixed 和传统循环哪个更好?
固定窗口只是表达分组语义更直接;如果还需要复杂的重试、限流、事务边界或跨批次状态,传统循环或专用批处理组件可能更容易控制。
记住三个关键点即可:fixed 表示不重叠批次,尾组不自动补齐,窗口结果按 API 约定保持不可修改。围绕这三个边界设计下游逻辑,代码通常就不会把窗口语义和业务提交策略混在一起。
Java 25 Primitive Types in Patterns 怎样避免模式匹配中的装箱误判
- 上一篇
- Java 25 Primitive Types in Patterns 怎样避免模式匹配中的装箱误判
- 下一篇
- Java 25 Compact Source Files 怎样减少小程序样板代码
-
- 文章 · java教程 | 7分钟前 | Java教程 · java 国际化 locale getDisplayCountry 地区名称
- Java Locale getDisplayCountry 怎样按指定语言显示地区名称
- 262浏览 收藏
-
- 文章 · java教程 | 25分钟前 | Java教程 · java 小程序 Java 25 Compact Source Files main 方法
- Java 25 Compact Source Files 怎样减少小程序样板代码
- 131浏览 收藏
-
- 文章 · java教程 | 33分钟前 | Java教程 · java Switch instanceof 装箱 Java 25 Primitive Types in Patterns
- Java 25 Primitive Types in Patterns 怎样避免模式匹配中的装箱误判
- 465浏览 收藏
-
- 文章 · java教程 | 17小时前 | 并发编程 · Java教程 · java 结构化并发 ScopedValue ScopedValue.where 动态作用域
- Java ScopedValue.where 怎样在调用范围内绑定值
- 447浏览 收藏
-
- 文章 · java教程 | 17小时前 |
- Java ClassFile.build 怎样生成可写入磁盘的最小 class 文件
- 283浏览 收藏
-
- 文章 · java教程 | 18小时前 |
- Java MethodHandles.guardWithTest 怎样按条件选择方法句柄
- 119浏览 收藏
-
- 文章 · java教程 | 18小时前 | Java · java skip reset mark StringReader
- Java StringReader.skip 怎样向前回退字符位置
- 160浏览 收藏
-
- 文章 · java教程 | 18小时前 |
- Java Optional.or 怎样延迟提供备用 Optional
- 412浏览 收藏
-
- 文章 · java教程 | 18小时前 | Java · Stream · java Stream Gatherers windowSliding
- Java Gatherers.windowSliding 怎样生成重叠窗口
- 192浏览 收藏
-
- 文章 · java教程 | 18小时前 | Java · java Inflater getRemaining
- Java Inflater.getRemaining 怎样找回压缩数据后的尾部字节
- 309浏览 收藏
-
- 文章 · java教程 | 18小时前 | Java · HTTP · java HTTP客户端 httpclient 请求超时 HttpRequest.Builder.timeout
- Java HttpRequest.Builder.timeout 怎样设置请求级超时
- 300浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1141次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1126次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1303次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1242次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1093次使用
-
- golang HTTP 服务器 处理 日志/Stream流的操作
- 2023-01-07 289浏览
-
- 为批处理任务建立父子取消链并回收定时器
- 2026-10-07 441浏览
-
- 聚合批量任务错误并保留每个输入的失败原因
- 2026-10-07 403浏览
-
- slices.Chunk 如何把批量写入拆成固定大小分组
- 2026-10-09 229浏览
-
- Go bytes.Buffer 怎样复用缓冲区并避免旧内容残留完成一个可复用的最小示例
- 2026-11-07 338浏览

