org.apache.flink.api.common.state

Class MapStateDescriptor<UK,UV>

java.lang.Object

org.apache.flink.api.common.state.StateDescriptor<MapState<UK,UV>,Map<UK,UV>>

org.apache.flink.api.common.state.MapStateDescriptor<UK,UV>

Type Parameters:

UK - The type of the keys that can be added to the map state.

All Implemented Interfaces:

Serializable

@PublicEvolving
public class MapStateDescriptor<UK,UV>
extends StateDescriptor<MapState<UK,UV>,Map<UK,UV>>

A StateDescriptor for MapState. This can be used to create state where the type is a map that can be updated and iterated over.

Using MapState is typically more efficient than manually maintaining a map in a ValueState, because the backing implementation can support efficient updates, rather then replacing the full map on write.

To create keyed map state (on a KeyedStream), use RuntimeContext.getMapState(MapStateDescriptor).

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.flink.api.common.state.StateDescriptor

StateDescriptor.Type

Field Summary

Fields inherited from class org.apache.flink.api.common.state.StateDescriptor

defaultValue, name, serializer

Constructor Summary

Constructors

Constructor and Description
MapStateDescriptor(String name, Class<UK> keyClass, Class<UV> valueClass) Create a new MapStateDescriptor with the given name and the given type information.
MapStateDescriptor(String name, TypeInformation<UK> keyTypeInfo, TypeInformation<UV> valueTypeInfo) Create a new MapStateDescriptor with the given name and the given type information.
MapStateDescriptor(String name, TypeSerializer<UK> keySerializer, TypeSerializer<UV> valueSerializer) Create a new MapStateDescriptor with the given name and the given type serializers.

Method Summary

Modifier and Type	Method and Description
MapState<UK,UV>	bind(StateBinder stateBinder) Creates a new State on the given StateBinder.
TypeSerializer<UK>	getKeySerializer() Gets the serializer for the keys in the state.
StateDescriptor.Type	getType()
TypeSerializer<UV>	getValueSerializer() Gets the serializer for the values in the state.

Methods inherited from class org.apache.flink.api.common.state.StateDescriptor

equals, getDefaultValue, getName, getQueryableStateName, getSerializer, hashCode, initializeSerializerUnlessSet, isQueryable, isSerializerInitialized, setQueryable, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

MapStateDescriptor

public MapStateDescriptor(String name,
                          TypeSerializer<UK> keySerializer,
                          TypeSerializer<UV> valueSerializer)

Create a new MapStateDescriptor with the given name and the given type serializers.

Parameters:

name - The name of the MapStateDescriptor.

keySerializer - The type serializer for the keys in the state.

valueSerializer - The type serializer for the values in the state.

MapStateDescriptor

public MapStateDescriptor(String name,
                          TypeInformation<UK> keyTypeInfo,
                          TypeInformation<UV> valueTypeInfo)

Create a new MapStateDescriptor with the given name and the given type information.

Parameters:

name - The name of the MapStateDescriptor.

keyTypeInfo - The type information for the keys in the state.

valueTypeInfo - The type information for the values in the state.

MapStateDescriptor

public MapStateDescriptor(String name,
                          Class<UK> keyClass,
                          Class<UV> valueClass)

Create a new MapStateDescriptor with the given name and the given type information.

If this constructor fails (because it is not possible to describe the type via a class), consider using the MapStateDescriptor(String, TypeInformation, TypeInformation) constructor.

Parameters:

name - The name of the MapStateDescriptor.

keyClass - The class of the type of keys in the state.

valueClass - The class of the type of values in the state.

Method Detail

bind

public MapState<UK,UV> bind(StateBinder stateBinder)
                     throws Exception

Description copied from class: StateDescriptor

Creates a new State on the given StateBinder.

Specified by:

bind in class StateDescriptor<MapState<UK,UV>,Map<UK,UV>>

Parameters:

stateBinder - The StateBackend on which to create the State.

Throws:

Exception

getType

public StateDescriptor.Type getType()

Specified by:

getType in class StateDescriptor<MapState<UK,UV>,Map<UK,UV>>

getKeySerializer

public TypeSerializer<UK> getKeySerializer()

Gets the serializer for the keys in the state.

Returns:

The serializer for the keys in the state.

getValueSerializer

public TypeSerializer<UV> getValueSerializer()

Gets the serializer for the values in the state.

Returns:

The serializer for the values in the state.