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

Class DynamicEventTimeSessionWindows<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.DynamicEventTimeSessionWindows<T>

Type Parameters:

T - The type of the input elements

All Implemented Interfaces:

Serializable

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

A WindowAssigner that windows elements into sessions based on the timestamp of the elements. 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(DynamicEventTimeSessionWindows.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	Description
protected SessionWindowTimeGapExtractor<T>	sessionWindowTimeGapExtractor

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	DynamicEventTimeSessionWindows(SessionWindowTimeGapExtractor<T> sessionWindowTimeGapExtractor)

Method Summary

Modifier and Type	Method	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(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> DynamicEventTimeSessionWindows<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

DynamicEventTimeSessionWindows

protected DynamicEventTimeSessionWindows(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>

toString

public String toString()

Overrides:

toString in class Object

withDynamicGap

public static <T> DynamicEventTimeSessionWindows<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.