org.apache.flink.streaming.api.windowing.assigners

Class DynamicProcessingTimeSessionWindows<T>

java.lang.Object

org.apache.flink.streaming.api.windowing.assigners.WindowAssigner<T,W>

org.apache.flink.streaming.api.windowing.assigners.MergingWindowAssigner<T,TimeWindow>

org.apache.flink.streaming.api.windowing.assigners.DynamicProcessingTimeSessionWindows<T>

Type Parameters:

T - The type of the input elements

All Implemented Interfaces:

Serializable

@PublicEvolving
public class DynamicProcessingTimeSessionWindows<T>
extends MergingWindowAssigner<T,TimeWindow>

A WindowAssigner that windows elements into sessions based on the current processing time. Windows cannot overlap.

For example, in order to window into windows with a dynamic time gap:

 DataStream<Tuple2<String, Integer>> in = ...;
 KeyedStream<String, Tuple2<String, Integer>> keyed = in.keyBy(...);
 WindowedStream<Tuple2<String, Integer>, String, TimeWindows> windowed =
   keyed.window(DynamicProcessingTimeSessionWindows.withDynamicGap({@link SessionWindowTimeGapExtractor }));
 

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.flink.streaming.api.windowing.assigners.MergingWindowAssigner

MergingWindowAssigner.MergeCallback<W>

Nested classes/interfaces inherited from class org.apache.flink.streaming.api.windowing.assigners.WindowAssigner

WindowAssigner.WindowAssignerContext

Field Summary

Fields

Modifier and Type	Field and Description
protected SessionWindowTimeGapExtractor<T>	sessionWindowTimeGapExtractor

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	DynamicProcessingTimeSessionWindows(SessionWindowTimeGapExtractor<T> sessionWindowTimeGapExtractor)

Method Summary

Modifier and Type	Method and Description
Collection<TimeWindow>	assignWindows(T element, long timestamp, WindowAssigner.WindowAssignerContext context) Returns a Collection of windows that should be assigned to the element.
Trigger<T,TimeWindow>	getDefaultTrigger() Returns the default trigger associated with this WindowAssigner.
Trigger<T,TimeWindow>	getDefaultTrigger(StreamExecutionEnvironment env) Returns the default trigger associated with this WindowAssigner.
org.apache.flink.api.common.typeutils.TypeSerializer<TimeWindow>	getWindowSerializer(org.apache.flink.api.common.ExecutionConfig executionConfig) Returns a TypeSerializer for serializing windows that are assigned by this WindowAssigner.
boolean	isEventTime() Returns true if elements are assigned to windows based on event time, false otherwise.
void	mergeWindows(Collection<TimeWindow> windows, MergingWindowAssigner.MergeCallback<TimeWindow> c) Merge overlapping TimeWindows.
String	toString()
static <T> DynamicProcessingTimeSessionWindows<T>	withDynamicGap(SessionWindowTimeGapExtractor<T> sessionWindowTimeGapExtractor) Creates a new SessionWindows WindowAssigner that assigns elements to sessions based on the element timestamp.

Methods inherited from class java.lang.Object

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

Field Detail

sessionWindowTimeGapExtractor

protected SessionWindowTimeGapExtractor<T> sessionWindowTimeGapExtractor

Constructor Detail

DynamicProcessingTimeSessionWindows

protected DynamicProcessingTimeSessionWindows(SessionWindowTimeGapExtractor<T> sessionWindowTimeGapExtractor)

Method Detail

assignWindows

public Collection<TimeWindow> assignWindows(T element,
                                            long timestamp,
                                            WindowAssigner.WindowAssignerContext context)

Description copied from class: WindowAssigner

Returns a Collection of windows that should be assigned to the element.

Specified by:

assignWindows in class WindowAssigner<T,TimeWindow>

Parameters:

element - The element to which windows should be assigned.

timestamp - The timestamp of the element.

context - The WindowAssigner.WindowAssignerContext in which the assigner operates.

getDefaultTrigger

public Trigger<T,TimeWindow> getDefaultTrigger(StreamExecutionEnvironment env)

Description copied from class: WindowAssigner

Returns the default trigger associated with this WindowAssigner.

Specified by:

getDefaultTrigger in class WindowAssigner<T,TimeWindow>

See Also:

FLIP-343: Remove parameter in WindowAssigner#getDefaultTrigger()

getDefaultTrigger

public Trigger<T,TimeWindow> getDefaultTrigger()

Description copied from class: WindowAssigner

Returns the default trigger associated with this WindowAssigner.

1. If you override getDefaultTrigger(), the getDefaultTrigger() will be invoked and the getDefaultTrigger(StreamExecutionEnvironment env) won't be invoked. 2. If you don't override getDefaultTrigger(), the getDefaultTrigger(StreamExecutionEnvironment env) will be invoked in the default implementation of the getDefaultTrigger().

Overrides:

getDefaultTrigger in class WindowAssigner<T,TimeWindow>

toString

public String toString()

Overrides:

toString in class Object

withDynamicGap

public static <T> DynamicProcessingTimeSessionWindows<T> withDynamicGap(SessionWindowTimeGapExtractor<T> sessionWindowTimeGapExtractor)

Creates a new SessionWindows WindowAssigner that assigns elements to sessions based on the element timestamp.

Parameters:

sessionWindowTimeGapExtractor - The extractor to use to extract the time gap from the input elements

Returns:

The policy.

getWindowSerializer

public org.apache.flink.api.common.typeutils.TypeSerializer<TimeWindow> getWindowSerializer(org.apache.flink.api.common.ExecutionConfig executionConfig)

Description copied from class: WindowAssigner

Returns a TypeSerializer for serializing windows that are assigned by this WindowAssigner.

Specified by:

getWindowSerializer in class WindowAssigner<T,TimeWindow>

isEventTime

public boolean isEventTime()

Description copied from class: WindowAssigner

Returns true if elements are assigned to windows based on event time, false otherwise.

Specified by:

isEventTime in class WindowAssigner<T,TimeWindow>

mergeWindows

public void mergeWindows(Collection<TimeWindow> windows,
                         MergingWindowAssigner.MergeCallback<TimeWindow> c)

Merge overlapping TimeWindows.

Specified by:

mergeWindows in class MergingWindowAssigner<T,TimeWindow>

Parameters:

windows - The window candidates.

c - A callback that can be invoked to signal which windows should be merged.