net.openhft.chronicle.map

Interface MapContext<K,V,R>

Type Parameters:

K - the map key type

V - the map value type

R - the return type of MapEntryOperations specified for the queried map

All Superinterfaces:

DefaultValueProvider<K,V>, HashContext<K>, MapEntryOperations<K,V,R>

All Known Subinterfaces:

ExternalMapQueryContext<K,V,R>, MapQueryContext<K,V,R>, MapSegmentContext<K,V,R>

public interface MapContext<K,V,R>
extends HashContext<K>, MapEntryOperations<K,V,R>, DefaultValueProvider<K,V>

Context, in which MapEntries are accessed. MapContext allows to access MapEntryOperations, configured for the accessed ChronicleMap via ChronicleMapBuilder.entryOperations(MapEntryOperations). MapContext implements MapEntryOperations by delegation to the configured entryOperations. The same for DefaultValueProvider: MapContext delegates to the DefaultValueProvider configured for the accessed ChronicleMap via ChronicleMapBuilder.defaultValueProvider(DefaultValueProvider), or the default DefaultValueProvider implementation.

Method Summary

Modifier and Type	Method and Description
ChronicleHash<K,?,?,?>	hash() Returns the accessed ChronicleMap.
ChronicleMap<K,V>	map() Returns the accessed ChronicleMap.
Data<V>	wrapValueAsData(V value) Wraps the given value as a Data.
Data<V>	wrapValueBytesAsData(net.openhft.chronicle.bytes.BytesStore valueBytes, long offset, long size) Wraps the given value bytes as a Data.

Methods inherited from interface net.openhft.chronicle.map.MapEntryOperations

insert, remove, replaceValue

Methods inherited from interface net.openhft.chronicle.map.DefaultValueProvider

defaultValue

Method Detail

hash

ChronicleHash<K,?,?,?> hash()

Returns the accessed ChronicleMap. Synonym to map().

Specified by:

hash in interface HashContext<K>

map

ChronicleMap<K,V> map()

Returns the accessed ChronicleMap. Synonym to hash().

wrapValueAsData

Data<V> wrapValueAsData(V value)

Wraps the given value as a Data. Useful when you need to pass a value to some method accepting Data, for example, MapEntryOperations.replaceValue( MapEntry, Data), without allocating new objects (i. e. garbage) and ThreadLocals.

The returned Data object shouldn't outlive this MapContext.

Parameters:

value - the value object to wrap

Returns:

the value as Data

wrapValueBytesAsData

Data<V> wrapValueBytesAsData(net.openhft.chronicle.bytes.BytesStore valueBytes,
                             long offset,
                             long size)

Wraps the given value bytes as a Data. Useful when you need to pass a value to some method accepting Data, for example, MapEntryOperations.replaceValue( MapEntry, Data), without allocating manual deserialization and ThreadLocals.

The returned Data object shouldn't outlive this MapContext.

Parameters:

valueBytes - the value bytes to wrap

offset - offset within the given valueBytes, the actual value bytes start from

size - length of the value bytes sequence

Returns:

the value bytes as Data