登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  文章 >  java教程

Java Gatherers.windowSliding 怎样生成重叠窗口

来源:17golang原创

时间:2026-11-19 17:03:33 192浏览 收藏

如果一段有序数据需要按固定长度切片,而且相邻切片还要共享一部分元素,Java 的 Gatherers.windowSliding 可以直接放进 Stream.gather。它会返回一个新的中间结果流:窗口满了以后,每次移出最早元素,再加入下一个元素。

下面用窗口大小为 3 的序列说明完整边界。注意,这个 API 从 Java 24 开始提供,示例需要使用支持 java.util.stream.Gatherers 的 JDK;文章只讨论内置滑动窗口,不展开自定义 Gatherer。

先看清滑动窗口到底重叠在哪里

固定窗口会得到类似 [10, 20, 30]、[40, 50, 60] 的不重叠分组;滑动窗口则保留相邻窗口的公共部分。例如窗口大小为 3 时,输入 10, 20, 30, 40, 50 的窗口形状是 [10, 20, 30]、[20, 30, 40]、[30, 40, 50]。这里的“重叠”是数据关系,不是把同一个可变列表反复交给下游。

Stream 输入、windowSize 和 Gatherers.windowSliding 形成两个共享元素窗口的静态关系说明图
图1:结构说明图,查看输入序列、窗口参数与相邻重叠窗口的静态关系。

这也决定了它的适用场景:连续指标的局部计算、相邻记录的对比、滑动采样或需要保留前后上下文的文本处理,都可以先把数据整理成窗口,再在窗口上做后续计算。

用 Stream.gather 配置 windowSliding

调用入口只有两层:先构造 Gatherers.windowSliding(windowSize),再把它传给 Stream.gather。下面的代码保留了输入顺序,并把窗口收集成结果列表。

import java.util.List;
import java.util.stream.Gatherers;
import java.util.stream.Stream;

public class SlidingWindowDemo {
    public static void main(String[] args) {
        int windowSize = 3;

        // gather 是中间操作;windowSliding 只描述窗口规则,不负责业务计算。
        List> windows = Stream.of(10, 20, 30, 40, 50)
                .gather(Gatherers.windowSliding(windowSize))
                .toList();

        // 每个窗口是独立的不可修改 List,适合继续映射、统计或交给只读调用方。
        System.out.println(windows);
    }
}

预期的结果形状是 [[10, 20, 30], [20, 30, 40], [30, 40, 50]]。如果业务只需要窗口的平均值、最大值或相邻差值,可以把后续操作接在 gather 之后,避免先手写一个带下标的循环。

用四个边界判断结果是否符合预期

排查“窗口数量不对”时,先不要怀疑 Stream 顺序,按输入长度和窗口大小检查四件事。

情况结果判断方式
正常序列相邻窗口共享元素窗口大小为 n,输入长度至少为 n 时,完整窗口从第一个位置逐步向后移动
输入短于窗口大小只产生一个窗口结果包含全部输入元素,不会凭空补齐
空 Stream不产生窗口结果列表为空
windowSize 小于 1抛出 IllegalArgumentException在构造窗口规则时修正参数,而不是等下游兜底
正常序列、短序列、空序列和非法窗口大小对应输出边界的静态说明图
图2:边界说明图,对照输入长度和 windowSize 判断窗口结果或参数异常。

还有一个容易忽略的事实:API 产生的每个窗口是不可修改的 List。如果后续代码需要追加元素,请在自己的业务边界复制成可变列表;不要把修改操作直接写在窗口对象上。

import java.util.ArrayList;
import java.util.List;
import java.util.stream.Gatherers;
import java.util.stream.Stream;

public class SlidingWindowBoundary {
    static List mutableCopy(List window) {
        // 复制只发生在确实需要修改时,避免改变 Gatherers 产生的只读窗口。
        return new ArrayList(window);
    }

    public static void main(String[] args) {
        // 输入短于窗口大小时,结果只有一个窗口且不补零。
        List> shortInput = Stream.of(7, 8)
                .gather(Gatherers.windowSliding(3))
                .toList();

        // 空输入没有窗口;这个分支可用于决定是否跳过后续聚合。
        List> emptyInput = Stream.empty()
                .gather(Gatherers.windowSliding(3))
                .toList();

        System.out.println(shortInput);
        System.out.println(emptyInput);
    }
}

把窗口规则放进调用约定

在真实项目里,先写清楚三个约定再传入数据:窗口是否允许重叠、窗口长度是否来自配置、下游是否会修改窗口。需要重叠上下文时选 windowSliding;只想批量分组时选 windowFixed,不要用滑动窗口后再手工丢弃重复元素。

最后按下面的清单反向确认:第一,JDK 能提供 Gatherers;第二,windowSize 大于 0;第三,输入太短时业务接受单窗口;第四,空输入有明确处理;第五,下游不会直接修改窗口。这样“窗口多了一条”通常就能定位到需求选择,而不是误判为 Stream 重复消费。

相关问题

windowSliding 和 windowFixed 有什么区别? 前者相邻窗口会共享元素,后者按固定大小切成不重叠窗口,最后一组可能不足指定大小。

输入元素少于 windowSize 会补齐吗? 不会,只产生一个包含全部输入元素的窗口。

为什么不能直接修改窗口里的元素? API 产生的窗口是不可修改列表;需要可变副本时显式创建 new ArrayList(window)。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>