org.apache.arrow.vector.util

Class MapWithOrdinalImpl<K,V>

java.lang.Object

org.apache.arrow.vector.util.MapWithOrdinalImpl<K,V>

Type Parameters:

K - key type

V - value type

All Implemented Interfaces:

MapWithOrdinal<K,V>

public class MapWithOrdinalImpl<K,V>
extends Object
implements MapWithOrdinal<K,V>

An implementation of map that supports constant time look-up by a generic key or an ordinal.

This class extends the functionality a regular Map with ordinal lookup support. Upon insertion an unused ordinal is assigned to the inserted (key, value) tuple. Upon update the same ordinal id is re-used while value is replaced. Upon deletion of an existing item, its corresponding ordinal is recycled and could be used by another item.

For any instance with N items, this implementation guarantees that ordinals are in the range of [0, N). However, the ordinal assignment is dynamic and may change after an insertion or deletion. Consumers of this class are responsible for explicitly checking the ordinal corresponding to a key via getOrdinal(Object) before attempting to execute a lookup with an ordinal.

Constructor Summary

Constructors

Constructor and Description
MapWithOrdinalImpl()

Method Summary

Modifier and Type	Method and Description
void	clear()
boolean	containsKey(Object key)
V	get(K key)
Collection<V>	getAll(K key)
V	getByOrdinal(int id) Returns the value corresponding to the given ordinal.
int	getOrdinal(K key) Returns the ordinal corresponding to the given key.
boolean	isEmpty()
Set<K>	keys()
boolean	put(K key, V value, boolean overwrite) Inserts the tuple (key, value) into the map extending the semantics of Map.put(K, V) with automatic ordinal assignment.
boolean	remove(K key, V value)
boolean	removeAll(K key) Removes the element corresponding to the key if exists extending the semantics of Map.remove(java.lang.Object) with ordinal re-cycling.
int	size()
Collection<V>	values()

Methods inherited from class java.lang.Object

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

Constructor Detail

MapWithOrdinalImpl

public MapWithOrdinalImpl()

Method Detail

getByOrdinal

public V getByOrdinal(int id)

Returns the value corresponding to the given ordinal.

Specified by:

getByOrdinal in interface MapWithOrdinal<K,V>

Parameters:

id - ordinal value for lookup

Returns:

an instance of V

getOrdinal

public int getOrdinal(K key)

Returns the ordinal corresponding to the given key.

Specified by:

getOrdinal in interface MapWithOrdinal<K,V>

Parameters:

key - key for ordinal lookup

Returns:

ordinal value corresponding to key if it exists or -1

size

public int size()

Specified by:

size in interface MapWithOrdinal<K,V>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface MapWithOrdinal<K,V>

getAll

public Collection<V> getAll(K key)

Specified by:

getAll in interface MapWithOrdinal<K,V>

get

public V get(K key)

Specified by:

get in interface MapWithOrdinal<K,V>

put

public boolean put(K key,
                   V value,
                   boolean overwrite)

Inserts the tuple (key, value) into the map extending the semantics of Map.put(K, V) with automatic ordinal assignment. A new ordinal is assigned if key does not exists. Otherwise the same ordinal is re-used but the value is replaced.

Specified by:

put in interface MapWithOrdinal<K,V>

See Also:

Map.put(K, V)

values

public Collection<V> values()

Specified by:

values in interface MapWithOrdinal<K,V>

remove

public boolean remove(K key,
                      V value)

Specified by:

remove in interface MapWithOrdinal<K,V>

containsKey

public boolean containsKey(Object key)

Specified by:

containsKey in interface MapWithOrdinal<K,V>

removeAll

public boolean removeAll(K key)

Removes the element corresponding to the key if exists extending the semantics of Map.remove(java.lang.Object) with ordinal re-cycling. The ordinal corresponding to the given key may be re-assigned to another tuple. It is important that consumer checks the ordinal value via getOrdinal(Object) before attempting to look-up by ordinal.

Specified by:

removeAll in interface MapWithOrdinal<K,V>

See Also:

Map.remove(java.lang.Object)

clear

public void clear()

Specified by:

clear in interface MapWithOrdinal<K,V>

keys

public Set<K> keys()

Specified by:

keys in interface MapWithOrdinal<K,V>