org.apache.flink.runtime.state

Class SharedStateRegistryImpl

java.lang.Object

org.apache.flink.runtime.state.SharedStateRegistryImpl

All Implemented Interfaces:

AutoCloseable, SharedStateRegistry

@Internal
public class SharedStateRegistryImpl
extends Object
implements SharedStateRegistry

SharedStateRegistry implementation.

Field Summary

Fields inherited from interface org.apache.flink.runtime.state.SharedStateRegistry

DEFAULT_FACTORY

Constructor Summary

Constructors

Constructor and Description
SharedStateRegistryImpl() Default uses direct executor to delete unreferenced state
SharedStateRegistryImpl(Executor asyncDisposalExecutor)

Method Summary

Modifier and Type	Method and Description
void	checkpointCompleted(long checkpointId)
void	close()
void	registerAll(Iterable<? extends CompositeStateHandle> stateHandles, long checkpointID) Register given shared states in the registry.
void	registerAllAfterRestored(CompletedCheckpoint checkpoint, RestoreMode mode) Set the lowest checkpoint ID below which no state is discarded, inclusive.
StreamStateHandle	registerReference(SharedStateRegistryKey registrationKey, StreamStateHandle state, long checkpointID) Register a reference to the given shared state in the registry.
String	toString()
void	unregisterUnusedState(long lowestCheckpointID) Unregister state that is not referenced by the given checkpoint ID or any newer.

Methods inherited from class java.lang.Object

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

Constructor Detail

SharedStateRegistryImpl

public SharedStateRegistryImpl()

Default uses direct executor to delete unreferenced state

SharedStateRegistryImpl

public SharedStateRegistryImpl(Executor asyncDisposalExecutor)

Method Detail

registerReference

public StreamStateHandle registerReference(SharedStateRegistryKey registrationKey,
                                           StreamStateHandle state,
                                           long checkpointID)

Description copied from interface: SharedStateRegistry

Register a reference to the given shared state in the registry. If there is already a state handle registered under the given key, the "new" state handle is disposed .

IMPORTANT: caller should check the state handle returned by the result, because the registry is performing de-duplication and could potentially return a handle that is supposed to replace the one from the registration request.

Specified by:

registerReference in interface SharedStateRegistry

state - the shared state for which we register a reference.

checkpointID - which uses the state

Returns:

the result of this registration request, consisting of the state handle that is registered under the key by the end of the operation and its current reference count.

unregisterUnusedState

public void unregisterUnusedState(long lowestCheckpointID)

Description copied from interface: SharedStateRegistry

Unregister state that is not referenced by the given checkpoint ID or any newer.

Specified by:

unregisterUnusedState in interface SharedStateRegistry

Parameters:

lowestCheckpointID - which is still valid

registerAll

public void registerAll(Iterable<? extends CompositeStateHandle> stateHandles,
                        long checkpointID)

Description copied from interface: SharedStateRegistry

Register given shared states in the registry.

NOTE: For state from checkpoints from other jobs or runs (i.e. after recovery), please use SharedStateRegistry.registerAllAfterRestored(CompletedCheckpoint, RestoreMode)

Specified by:

registerAll in interface SharedStateRegistry

Parameters:

stateHandles - The shared states to register.

checkpointID - which uses the states.

registerAllAfterRestored

public void registerAllAfterRestored(CompletedCheckpoint checkpoint,
                                     RestoreMode mode)

Description copied from interface: SharedStateRegistry

Set the lowest checkpoint ID below which no state is discarded, inclusive.

After recovery from an incremental checkpoint, its state should NOT be discarded, even if not used anymore (unless recovering in CLAIM mode).

This should hold for both cases: when recovering from that initial checkpoint; and from any subsequent checkpoint derived from it.

Specified by:

registerAllAfterRestored in interface SharedStateRegistry

checkpointCompleted

public void checkpointCompleted(long checkpointId)

Specified by:

checkpointCompleted in interface SharedStateRegistry

toString

public String toString()

Overrides:

toString in class Object

close

public void close()

Specified by:

close in interface AutoCloseable