org.apache.flink.runtime.state

类 SharedStateRegistry

java.lang.Object

org.apache.flink.runtime.state.SharedStateRegistry

所有已实现的接口:

AutoCloseable

public class SharedStateRegistry
extends Object
implements AutoCloseable

This registry manages state that is shared across (incremental) checkpoints, and is responsible for deleting shared state that is no longer used in any valid checkpoint. A SharedStateRegistry will be deployed in the CheckpointCoordinator to maintain the reference count of StreamStateHandles by a key that (logically) identifies them.

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	SharedStateRegistry.Result The result of an attempt to (un)/reference state

字段概要

字段

限定符和类型	字段和说明
static SharedStateRegistryFactory	DEFAULT_FACTORY A singleton object for the default implementation of a SharedStateRegistryFactory

构造器概要

构造器

构造器和说明
SharedStateRegistry() Default uses direct executor to delete unreferenced state
SharedStateRegistry(Executor asyncDisposalExecutor)

方法概要

限定符和类型	方法和说明
void	close()
void	registerAll(Iterable<? extends CompositeStateHandle> stateHandles) Register given shared states in the registry.
SharedStateRegistry.Result	registerReference(SharedStateRegistryKey registrationKey, StreamStateHandle state) Register a reference to the given shared state in the registry.
String	toString()
SharedStateRegistry.Result	unregisterReference(SharedStateRegistryKey registrationKey) Releases one reference to the given shared state in the registry.

从类继承的方法 java.lang.Object

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

字段详细资料

DEFAULT_FACTORY

public static final SharedStateRegistryFactory DEFAULT_FACTORY

A singleton object for the default implementation of a SharedStateRegistryFactory

构造器详细资料

SharedStateRegistry

public SharedStateRegistry()

Default uses direct executor to delete unreferenced state

SharedStateRegistry

public SharedStateRegistry(Executor asyncDisposalExecutor)

方法详细资料

registerReference

public SharedStateRegistry.Result registerReference(SharedStateRegistryKey registrationKey,
                                                    StreamStateHandle state)

Register a reference to the given shared state in the registry. This does the following: We check if the state handle is actually new by the registrationKey. If it is new, we register it with a reference count of 1. If there is already a state handle registered under the given key, we dispose the given "new" state handle, uptick the reference count of the previously existing state handle and return it as a replacement with the result.

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.

参数:

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

返回:

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.

unregisterReference

public SharedStateRegistry.Result unregisterReference(SharedStateRegistryKey registrationKey)

Releases one reference to the given shared state in the registry. This decreases the reference count by one. Once the count reaches zero, the shared state is deleted.

参数:

registrationKey - the shared state for which we release a reference.

返回:

the result of the request, consisting of the reference count after this operation and the state handle, or null if the state handle was deleted through this request. Returns null if the registry was previously closed.

registerAll

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

Register given shared states in the registry.

参数:

stateHandles - The shared states to register.

toString

public String toString()

覆盖:

toString 在类中 Object

close

public void close()

指定者:

close 在接口中 AutoCloseable