Package org.apache.flink.runtime.state.v2.adaptor

Class AsyncKeyedStateBackendAdaptor<K>

java.lang.Object

org.apache.flink.runtime.state.v2.adaptor.AsyncKeyedStateBackendAdaptor<K>

Type Parameters:

K - The key by which state is keyed.

All Implemented Interfaces:

Closeable, AutoCloseable, org.apache.flink.api.common.state.CheckpointListener, org.apache.flink.api.common.state.InternalCheckpointListener, AsyncExecutionController.SwitchContextListener<K>, AsyncKeyedStateBackend<K>, Snapshotable<SnapshotResult<KeyedStateHandle>>, org.apache.flink.util.Disposable

public class AsyncKeyedStateBackendAdaptor<K>
extends Object
implements AsyncKeyedStateBackend<K>

A adaptor that transforms KeyedStateBackend into AsyncKeyedStateBackend.

Constructor Summary

Constructors

Constructor	Description
AsyncKeyedStateBackendAdaptor(CheckpointableKeyedStateBackend<K> keyedStateBackend)

Method Summary

Modifier and Type	Method	Description
void	close()
<N,S extends org.apache.flink.api.common.state.v2.State,SV> S	createState(N defaultNamespace, org.apache.flink.api.common.typeutils.TypeSerializer<N> namespaceSerializer, StateDescriptor<SV> stateDesc)	Creates and returns a new state.
StateExecutor	createStateExecutor()	Creates a StateExecutor which supports to execute a batch of state requests asynchronously.
void	dispose()
void	notifyCheckpointAborted(long checkpointId)
void	notifyCheckpointComplete(long checkpointId)
void	notifyCheckpointSubsumed(long checkpointId)
void	setup(StateRequestHandler stateRequestHandler)	Initializes with some contexts.
RunnableFuture<SnapshotResult<KeyedStateHandle>>	snapshot(long checkpointId, long timestamp, CheckpointStreamFactory streamFactory, CheckpointOptions checkpointOptions)	Operation that writes a snapshot into a stream that is provided by the given CheckpointStreamFactory and returns a @RunnableFuture that gives a state handle to the snapshot.
void	switchContext(RecordContext<K> context)	By default, a state backend does nothing when a key is switched in async processing.

Methods inherited from class java.lang.Object

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

Constructor Detail

AsyncKeyedStateBackendAdaptor

public AsyncKeyedStateBackendAdaptor(CheckpointableKeyedStateBackend<K> keyedStateBackend)

Method Detail

setup

public void setup(@Nonnull
                  StateRequestHandler stateRequestHandler)

Description copied from interface: AsyncKeyedStateBackend

Initializes with some contexts.

Specified by:

setup in interface AsyncKeyedStateBackend<K>

Parameters:

stateRequestHandler - which handles state request.

createState

@Nonnull
public <N,S extends org.apache.flink.api.common.state.v2.State,SV> S createState(@Nonnull
                                                                                             N defaultNamespace,
                                                                                             @Nonnull
                                                                                             org.apache.flink.api.common.typeutils.TypeSerializer<N> namespaceSerializer,
                                                                                             @Nonnull
                                                                                             StateDescriptor<SV> stateDesc)
                                                                                      throws Exception

Description copied from interface: AsyncKeyedStateBackend

Creates and returns a new state.

Specified by:

createState in interface AsyncKeyedStateBackend<K>

Type Parameters:

N - the type of namespace for partitioning.

S - The type of the public API state.

SV - The type of the stored state value.

Parameters:

defaultNamespace - the default namespace for this state.

namespaceSerializer - the serializer for namespace.

stateDesc - The StateDescriptor that contains the name of the state.

Throws:

Exception - Exceptions may occur during initialization of the state.

createStateExecutor

@Nonnull
public StateExecutor createStateExecutor()

Description copied from interface: AsyncKeyedStateBackend

Creates a StateExecutor which supports to execute a batch of state requests asynchronously.

Notice that the AsyncKeyedStateBackend is responsible for shutting down the StateExecutors created by itself when they are no longer in use.

Specified by:

createStateExecutor in interface AsyncKeyedStateBackend<K>

Returns:

a StateExecutor which supports to execute a batch of state requests asynchronously.

switchContext

public void switchContext(RecordContext<K> context)

Description copied from interface: AsyncKeyedStateBackend

By default, a state backend does nothing when a key is switched in async processing.

Specified by:

switchContext in interface AsyncExecutionController.SwitchContextListener<K>

Specified by:

switchContext in interface AsyncKeyedStateBackend<K>

dispose

public void dispose()

Specified by:

dispose in interface AsyncKeyedStateBackend<K>

Specified by:

dispose in interface org.apache.flink.util.Disposable

close

public void close()
           throws IOException

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Throws:

IOException

notifyCheckpointComplete

public void notifyCheckpointComplete(long checkpointId)
                              throws Exception

Specified by:

notifyCheckpointComplete in interface org.apache.flink.api.common.state.CheckpointListener

Throws:

Exception

notifyCheckpointAborted

public void notifyCheckpointAborted(long checkpointId)
                             throws Exception

Specified by:

notifyCheckpointAborted in interface org.apache.flink.api.common.state.CheckpointListener

Throws:

Exception

notifyCheckpointSubsumed

public void notifyCheckpointSubsumed(long checkpointId)
                              throws Exception

Specified by:

notifyCheckpointSubsumed in interface org.apache.flink.api.common.state.InternalCheckpointListener

Throws:

Exception

snapshot

@Nonnull
public RunnableFuture<SnapshotResult<KeyedStateHandle>> snapshot(long checkpointId,
                                                                 long timestamp,
                                                                 @Nonnull
                                                                 CheckpointStreamFactory streamFactory,
                                                                 @Nonnull
                                                                 CheckpointOptions checkpointOptions)
                                                          throws Exception

Description copied from interface: Snapshotable

Operation that writes a snapshot into a stream that is provided by the given CheckpointStreamFactory and returns a @RunnableFuture that gives a state handle to the snapshot. It is up to the implementation if the operation is performed synchronous or asynchronous. In the later case, the returned Runnable must be executed first before obtaining the handle.

Specified by:

snapshot in interface Snapshotable<K>

Parameters:

checkpointId - The ID of the checkpoint.

timestamp - The timestamp of the checkpoint.

streamFactory - The factory that we can use for writing our state to streams.

checkpointOptions - Options for how to perform this checkpoint.

Returns:

A runnable future that will yield a StateObject.

Throws:

Exception