org.apache.flink.table.runtime.operators.window.internal

类 MergingWindowSet<W extends Window>

java.lang.Object

org.apache.flink.table.runtime.operators.window.internal.MergingWindowSet<W>

类型参数:

W - The type of Window that this set is keeping track of.

public class MergingWindowSet<W extends Window>
extends Object

Utility for keeping track of merging Windows when using a MergingWindowAssigner in a WindowOperator.

When merging windows, we keep one of the original windows as the state window, i.e. the window that is used as namespace to store the window elements. Elements from the state windows of merged windows must be merged into this one state window. We keep a mapping from in-flight window to state window that can be queried using getStateWindow(Window).

A new window can be added to the set of in-flight windows using addWindow(Window, MergeFunction). This might merge other windows and the caller must react accordingly in the MergingWindowSet.MergeFunction.merge(Object, Collection, Object, Collection) and adjust the outside view of windows and state.

Windows can be removed from the set of windows using retireWindow(Window).

嵌套类概要

嵌套类

限定符和类型	类和说明
static interface	MergingWindowSet.MergeFunction<W> Callback for addWindow(Window, MergeFunction).

构造器概要

构造器

构造器和说明
MergingWindowSet(MergingWindowAssigner<W> windowAssigner, org.apache.flink.api.common.state.MapState<W,W> mapping) Restores a MergingWindowSet from the given state.

方法概要

限定符和类型	方法和说明
W	addWindow(W newWindow, MergingWindowSet.MergeFunction<W> mergeFunction) Adds a new Window to the set of in-flight windows.
W	getStateWindow(W window) Returns the state window for the given in-flight Window.
void	initializeCache(Object key) Set current key context of this window set.
void	retireWindow(W window) Removes the given window from the set of in-flight windows.
String	toString()

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

构造器详细资料

MergingWindowSet

public MergingWindowSet(MergingWindowAssigner<W> windowAssigner,
                        org.apache.flink.api.common.state.MapState<W,W> mapping)

Restores a MergingWindowSet from the given state.

方法详细资料

initializeCache

public void initializeCache(Object key)
                     throws Exception

Set current key context of this window set.

Notes: initializeCache(Object) must be called before addWindow(Window, MergeFunction) and retireWindow(Window)

参数:

key - the current access key

抛出:

Exception

getStateWindow

public W getStateWindow(W window)
                 throws Exception

Returns the state window for the given in-flight Window. The state window is the Window in which we keep the actual state of a given in-flight window. Windows might expand but we keep to original state window for keeping the elements of the window to avoid costly state juggling.

参数:

window - The window for which to get the state window.

抛出:

Exception

retireWindow

public void retireWindow(W window)
                  throws Exception

Removes the given window from the set of in-flight windows.

参数:

window - The Window to remove.

抛出:

Exception

addWindow

public W addWindow(W newWindow,
                   MergingWindowSet.MergeFunction<W> mergeFunction)
            throws Exception

Adds a new Window to the set of in-flight windows. It might happen that this triggers merging of previously in-flight windows. In that case, the provided MergingWindowSet.MergeFunction is called.

This returns the window that is the representative of the added window after adding. This can either be the new window itself, if no merge occurred, or the newly merged window. Adding an element to a window or calling trigger functions should only happen on the returned representative. This way, we never have to deal with a new window that is immediately swallowed up by another window.

If the new window is merged, the MergeFunction callback arguments also don't contain the new window as part of the list of merged windows.

参数:

newWindow - The new Window to add.

mergeFunction - The callback to be invoked in case a merge occurs.

返回:

The Window that new new Window ended up in. This can also be the the new Window itself in case no merge occurred.

抛出:

Exception

toString

public String toString()

覆盖:

toString 在类中 Object