net.openhft.chronicle.hash

Interface Value<V,T>

Type Parameters:

V - type of the accessed objects

T - type of the handle for bytes access

All Known Implementing Classes:

AbstractValue

public interface Value<V,T>

Dual bytes/object access to keys/values/elements.

Bytes access: access() + handle() + offset() + size().

Object access: get().

In most cases, each particular value wraps either some object or some bytes. Object is marshalled to bytes lazily on demand, and bytes are lazily deserialized to object, accordingly.

Method Summary

Modifier and Type	Method and Description
ReadAccess<T>	access() Returns access to the value's bytes.
static <T1,T2> boolean	bytesEquivalent(Value<?,T1> v1, Value<?,T2> v2)
default <S,T2,A extends ReadAccess<T2>> boolean	equivalent(Accessor<S,T2,A> accessor, S source, long index)
default <T2> boolean	equivalent(ReadAccess<T2> access, T2 handle, long offset)
V	get() Returns "cached" object, generally not eligible for using outside some context, or a block, synchronized with locks, or lambda, etc.
V	getUsing(V usingInstance) Reads the object from the value's bytes, trying to reuse the given object (might be null).
T	handle() Returns a handle to access the value's bytes.
default long	hash(LongHashFunction f)
long	offset() Returns the offset to the value's bytes.
long	size() Returns the size of the value's bytes.
default <S,T2,A extends WriteAccess<T2>> void	writeTo(Accessor<S,T2,A> accessor, S source, long index)
default <T2> void	writeTo(StreamingDataOutput<?,?,T2> output)
default <T2> void	writeTo(WriteAccess<T2> access, T2 handle, long offset)

Method Detail

access

ReadAccess<T> access()

Returns access to the value's bytes.

handle

T handle()

Returns a handle to access the value's bytes.

offset

long offset()

Returns the offset to the value's bytes.

size

long size()

Returns the size of the value's bytes.

hash

default long hash(LongHashFunction f)

equivalent

default <T2> boolean equivalent(ReadAccess<T2> access,
                                T2 handle,
                                long offset)

equivalent

default <S,T2,A extends ReadAccess<T2>> boolean equivalent(Accessor<S,T2,A> accessor,
                                                           S source,
                                                           long index)

writeTo

default <T2> void writeTo(WriteAccess<T2> access,
                          T2 handle,
                          long offset)

writeTo

default <T2> void writeTo(StreamingDataOutput<?,?,T2> output)

writeTo

default <S,T2,A extends WriteAccess<T2>> void writeTo(Accessor<S,T2,A> accessor,
                                                      S source,
                                                      long index)

get

V get()

Returns "cached" object, generally not eligible for using outside some context, or a block, synchronized with locks, or lambda, etc. If the Value is object wrapper -- this method just returns this object.

getUsing

V getUsing(@Nullable
           V usingInstance)

Reads the object from the value's bytes, trying to reuse the given object (might be null).

bytesEquivalent

static <T1,T2> boolean bytesEquivalent(Value<?,T1> v1,
                                       Value<?,T2> v2)