org.apache.flink.runtime.state.heap

类 NestedMapsStateTable<K,N,S>

java.lang.Object

org.apache.flink.runtime.state.heap.StateTable<K,N,S>

org.apache.flink.runtime.state.heap.NestedMapsStateTable<K,N,S>

类型参数:

K - type of key.

N - type of namespace.

S - type of state.

所有已实现的接口:

StateSnapshotRestore

@Internal
public class NestedMapsStateTable<K,N,S>
extends StateTable<K,N,S>

This implementation of StateTable uses nested HashMap objects. It is also maintaining a partitioning by key-group.

In contrast to CopyOnWriteStateTable, this implementation does not support asynchronous snapshots. However, it might have a better memory footprint for some use-cases, e.g. it is naturally de-duplicating namespace objects.

字段概要

从类继承的字段 org.apache.flink.runtime.state.heap.StateTable

keyContext, metaInfo

构造器概要

构造器

构造器和说明
NestedMapsStateTable(InternalKeyContext<K> keyContext, RegisteredKeyValueStateBackendMetaInfo<N,S> metaInfo) Creates a new NestedMapsStateTable for the given key context and meta info.

方法概要

限定符和类型	方法和说明
boolean	containsKey(N namespace) Returns whether this table contains a mapping for the composite of active key and given namespace.
S	get(K key, N namespace) Returns the state for the composite of active key and given namespace.
S	get(N namespace) Returns the state of the mapping for the composite of active key and given namespace.
java.util.stream.Stream<K>	getKeys(N namespace)
Map<N,Map<K,S>>[]	getState() Returns the internal data structure.
InternalKvState.StateIncrementalVisitor<K,N,S>	getStateIncrementalVisitor(int recommendedMaxNumberOfReturnedRecords)
void	put(K key, int keyGroupIndex, N namespace, S value)
void	put(N namespace, S state) Maps the composite of active key and given namespace to the specified state.
S	putAndGetOld(N namespace, S state) Maps the composite of active key and given namespace to the specified state.
void	remove(N namespace) Removes the mapping for the composite of active key and given namespace.
S	removeAndGetOld(N namespace) Removes the mapping for the composite of active key and given namespace, returning the state that was found under the entry.
int	size() Returns the total number of entries in this StateTable.
int	sizeOfNamespace(Object namespace)
org.apache.flink.runtime.state.heap.NestedMapsStateTable.NestedMapsStateTableSnapshot<K,N,S>	stateSnapshot() Returns a snapshot of the state.
<T> void	transform(N namespace, T value, StateTransformationFunction<S,T> transformation) Applies the given StateTransformationFunction to the state (1st input argument), using the given value as second input argument.

从类继承的方法 org.apache.flink.runtime.state.heap.StateTable

getMetaInfo, getNamespaceSerializer, getStateSerializer, isEmpty, keyGroupReader, setMetaInfo

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

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

构造器详细资料

NestedMapsStateTable

public NestedMapsStateTable(InternalKeyContext<K> keyContext,
                            RegisteredKeyValueStateBackendMetaInfo<N,S> metaInfo)

Creates a new NestedMapsStateTable for the given key context and meta info.

参数:

keyContext - the key context.

metaInfo - the meta information for this state table.

方法详细资料

getState

@VisibleForTesting
public Map<N,Map<K,S>>[] getState()

Returns the internal data structure.

size

public int size()

从类复制的说明: StateTable

Returns the total number of entries in this StateTable. This is the sum of both sub-tables.

指定者:

size 在类中 StateTable<K,N,S>

返回:

the number of entries in this StateTable.

get

public S get(N namespace)

从类复制的说明: StateTable

Returns the state of the mapping for the composite of active key and given namespace.

指定者:

get 在类中 StateTable<K,N,S>

参数:

namespace - the namespace. Not null.

返回:

the states of the mapping with the specified key/namespace composite key, or null if no mapping for the specified key is found.

containsKey

public boolean containsKey(N namespace)

从类复制的说明: StateTable

Returns whether this table contains a mapping for the composite of active key and given namespace.

指定者:

containsKey 在类中 StateTable<K,N,S>

参数:

namespace - the namespace in the composite key to search for. Not null.

返回:

true if this map contains the specified key/namespace composite key, false otherwise.

put

public void put(N namespace,
                S state)

从类复制的说明: StateTable

Maps the composite of active key and given namespace to the specified state. This method should be preferred over #putAndGetOld(N, S) (Namespace, State)} when the caller is not interested in the old state.

指定者:

put 在类中 StateTable<K,N,S>

参数:

namespace - the namespace. Not null.

state - the state. Can be null.

putAndGetOld

public S putAndGetOld(N namespace,
                      S state)

从类复制的说明: StateTable

Maps the composite of active key and given namespace to the specified state. Returns the previous state that was registered under the composite key.

指定者:

putAndGetOld 在类中 StateTable<K,N,S>

参数:

namespace - the namespace. Not null.

state - the state. Can be null.

返回:

the state of any previous mapping with the specified key or null if there was no such mapping.

remove

public void remove(N namespace)

从类复制的说明: StateTable

Removes the mapping for the composite of active key and given namespace. This method should be preferred over #removeAndGetOld(N) when the caller is not interested in the old state.

指定者:

remove 在类中 StateTable<K,N,S>

参数:

namespace - the namespace of the mapping to remove. Not null.

removeAndGetOld

public S removeAndGetOld(N namespace)

从类复制的说明: StateTable

Removes the mapping for the composite of active key and given namespace, returning the state that was found under the entry.

指定者:

removeAndGetOld 在类中 StateTable<K,N,S>

参数:

namespace - the namespace of the mapping to remove. Not null.

返回:

the state of the removed mapping or null if no mapping for the specified key was found.

get

public S get(K key,
             N namespace)

从类复制的说明: StateTable

Returns the state for the composite of active key and given namespace. This is typically used by queryable state.

指定者:

get 在类中 StateTable<K,N,S>

参数:

key - the key. Not null.

namespace - the namespace. Not null.

返回:

the state of the mapping with the specified key/namespace composite key, or null if no mapping for the specified key is found.

getKeys

public java.util.stream.Stream<K> getKeys(N namespace)

指定者:

getKeys 在类中 StateTable<K,N,S>

getStateIncrementalVisitor

public InternalKvState.StateIncrementalVisitor<K,N,S> getStateIncrementalVisitor(int recommendedMaxNumberOfReturnedRecords)

指定者:

getStateIncrementalVisitor 在类中 StateTable<K,N,S>

put

public void put(K key,
                int keyGroupIndex,
                N namespace,
                S value)

指定者:

put 在类中 StateTable<K,N,S>

sizeOfNamespace

public int sizeOfNamespace(Object namespace)

指定者:

sizeOfNamespace 在类中 StateTable<K,N,S>

transform

public <T> void transform(N namespace,
                          T value,
                          StateTransformationFunction<S,T> transformation)
                   throws Exception

从类复制的说明: StateTable

Applies the given StateTransformationFunction to the state (1st input argument), using the given value as second input argument. The result of StateTransformationFunction.apply(Object, Object) is then stored as the new state. This function is basically an optimization for get-update-put pattern.

指定者:

transform 在类中 StateTable<K,N,S>

参数:

namespace - the namespace. Not null.

value - the value to use in transforming the state. Can be null.

transformation - the transformation function.

抛出:

Exception - if some exception happens in the transformation function.

stateSnapshot

@Nonnull
public org.apache.flink.runtime.state.heap.NestedMapsStateTable.NestedMapsStateTableSnapshot<K,N,S> stateSnapshot()

从接口复制的说明: StateSnapshotRestore

Returns a snapshot of the state.