org.apache.flink.runtime.state

Class GenericFoldingState<K,N,T,ACC,Backend extends AbstractStateBackend,W extends org.apache.flink.api.common.state.ValueState<ACC> & KvState<K,N,org.apache.flink.api.common.state.ValueState<ACC>,org.apache.flink.api.common.state.ValueStateDescriptor<ACC>,Backend>>

java.lang.Object

org.apache.flink.runtime.state.GenericFoldingState<K,N,T,ACC,Backend,W>

Type Parameters:

K - The type of the key.

N - The type of the namespace.

T - The type of the values that can be folded into the state.

ACC - The type of the value in the folding state.

Backend - The type of AbstractStateBackend that manages this KvState.

W - Generic type that extends both the underlying ValueState and KvState.

All Implemented Interfaces:

org.apache.flink.api.common.state.AppendingState<T,ACC>, org.apache.flink.api.common.state.FoldingState<T,ACC>, org.apache.flink.api.common.state.State, KvState<K,N,org.apache.flink.api.common.state.FoldingState<T,ACC>,org.apache.flink.api.common.state.FoldingStateDescriptor<T,ACC>,Backend>

public class GenericFoldingState<K,N,T,ACC,Backend extends AbstractStateBackend,W extends org.apache.flink.api.common.state.ValueState<ACC> & KvState<K,N,org.apache.flink.api.common.state.ValueState<ACC>,org.apache.flink.api.common.state.ValueStateDescriptor<ACC>,Backend>>
extends Object
implements org.apache.flink.api.common.state.FoldingState<T,ACC>, KvState<K,N,org.apache.flink.api.common.state.FoldingState<T,ACC>,org.apache.flink.api.common.state.FoldingStateDescriptor<T,ACC>,Backend>

Generic implementation of FoldingState based on a wrapped ValueState.

Constructor Summary

Constructors

Constructor and Description
GenericFoldingState(org.apache.flink.api.common.state.ValueState<ACC> wrappedState, org.apache.flink.api.common.functions.FoldFunction<T,ACC> foldFunction) Creates a new FoldingState that wraps the given ValueState.

Method Summary

Modifier and Type	Method and Description
void	add(T value)
void	clear()
void	dispose() Disposes the key/value state, releasing all occupied resources.
ACC	get()
void	setCurrentKey(K key) Sets the current key, which will be used when using the state access methods.
void	setCurrentNamespace(N namespace) Sets the current namespace, which will be used when using the state access methods.
KvStateSnapshot<K,N,org.apache.flink.api.common.state.FoldingState<T,ACC>,org.apache.flink.api.common.state.FoldingStateDescriptor<T,ACC>,Backend>	snapshot(long checkpointId, long timestamp) Creates a snapshot of this state.

Methods inherited from class java.lang.Object

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

Constructor Detail

GenericFoldingState

public GenericFoldingState(org.apache.flink.api.common.state.ValueState<ACC> wrappedState,
                           org.apache.flink.api.common.functions.FoldFunction<T,ACC> foldFunction)

Creates a new FoldingState that wraps the given ValueState. The ValueState must have the initial value of the fold as default value.

Parameters:

wrappedState - The wrapped ValueState

foldFunction - The FoldFunction to use for folding values into the state

Method Detail

setCurrentKey

public void setCurrentKey(K key)

Description copied from interface: KvState

Sets the current key, which will be used when using the state access methods.

Specified by:

setCurrentKey in interface KvState<K,N,org.apache.flink.api.common.state.FoldingState<T,ACC>,org.apache.flink.api.common.state.FoldingStateDescriptor<T,ACC>,Backend extends AbstractStateBackend>

Parameters:

key - The key.

setCurrentNamespace

public void setCurrentNamespace(N namespace)

Description copied from interface: KvState

Sets the current namespace, which will be used when using the state access methods.

Specified by:

setCurrentNamespace in interface KvState<K,N,org.apache.flink.api.common.state.FoldingState<T,ACC>,org.apache.flink.api.common.state.FoldingStateDescriptor<T,ACC>,Backend extends AbstractStateBackend>

Parameters:

namespace - The namespace.

snapshot

public KvStateSnapshot<K,N,org.apache.flink.api.common.state.FoldingState<T,ACC>,org.apache.flink.api.common.state.FoldingStateDescriptor<T,ACC>,Backend> snapshot(long checkpointId,
                                                                                                                                                                   long timestamp)
                                                                                                                                                            throws Exception

Description copied from interface: KvState

Creates a snapshot of this state.

Specified by:

snapshot in interface KvState<K,N,org.apache.flink.api.common.state.FoldingState<T,ACC>,org.apache.flink.api.common.state.FoldingStateDescriptor<T,ACC>,Backend extends AbstractStateBackend>

Parameters:

checkpointId - The ID of the checkpoint for which the snapshot should be created.

timestamp - The timestamp of the checkpoint.

Returns:

A snapshot handle for this key/value state.

Throws:

Exception - Exceptions during snapshotting the state should be forwarded, so the system can react to failed snapshots.

dispose

public void dispose()

Description copied from interface: KvState

Disposes the key/value state, releasing all occupied resources.

Specified by:

dispose in interface KvState<K,N,org.apache.flink.api.common.state.FoldingState<T,ACC>,org.apache.flink.api.common.state.FoldingStateDescriptor<T,ACC>,Backend extends AbstractStateBackend>

get

public ACC get()
        throws Exception

Specified by:

get in interface org.apache.flink.api.common.state.AppendingState<T,ACC>

Throws:

Exception

add

public void add(T value)
         throws Exception

Specified by:

add in interface org.apache.flink.api.common.state.AppendingState<T,ACC>

Throws:

Exception

clear

public void clear()

Specified by:

clear in interface org.apache.flink.api.common.state.State