net.openhft.chronicle.queue.impl

Interface TableStore<T extends Metadata>

All Superinterfaces:

AutoCloseable, Closeable, CommonStore, net.openhft.chronicle.wire.Demarshallable, net.openhft.chronicle.core.ReferenceCounted, net.openhft.chronicle.wire.WriteMarshallable, net.openhft.chronicle.wire.WriteValue

All Known Implementing Classes:

ReadonlyTableStore, SingleTableStore

public interface TableStore<T extends Metadata>
extends CommonStore

Field Summary

Fields inherited from interface net.openhft.chronicle.wire.Demarshallable

DEMARSHALLABLES

Fields inherited from interface net.openhft.chronicle.wire.WriteMarshallable

EMPTY

Method Summary

Modifier and Type	Method and Description
net.openhft.chronicle.core.values.LongValue	acquireValueFor(CharSequence key) Acquire LongValue mapped to underlying file, providing atomic operations on the value that is shared across threads and/or JVMs.
<R> R	doWithExclusiveLock(Function<TableStore<T>,? extends R> code) Acquires file-system level lock on the underlying file, to prevent concurrent access from multiple processes.
T	metadata()

Methods inherited from interface net.openhft.chronicle.queue.impl.CommonStore

bytes, dump, file

Methods inherited from interface net.openhft.chronicle.core.ReferenceCounted

refCount, release, release, releaseAll, reserve, tryReserve

Methods inherited from interface net.openhft.chronicle.wire.Demarshallable

newInstance

Methods inherited from interface net.openhft.chronicle.wire.WriteMarshallable

writeMarshallable, writeValue

Methods inherited from interface net.openhft.chronicle.core.io.Closeable

close, closeQuietly, closeQuietly, isClosed, notifyClosing

Method Detail

acquireValueFor

net.openhft.chronicle.core.values.LongValue acquireValueFor(CharSequence key)

Acquire LongValue mapped to underlying file, providing atomic operations on the value that is shared across threads and/or JVMs. Note: The implementation of this method is not required to guarantee that if the value does not exist in the file, it will create one and only one value in the file in case of concurrent access. On the contrary, it's possible that different threads or processes acquire LongValues pointing to different fields in the underlying file. To prevent this, it is advised to use doWithExclusiveLock(Function) to wrap calls to this method, which will ensure exclusive access to file while initially acquiring values.

Parameters:

key - the key of the value

Returns:

LongValue object pointing to particular location in mapped underlying file

doWithExclusiveLock

<R> R doWithExclusiveLock(Function<TableStore<T>,? extends R> code)

Acquires file-system level lock on the underlying file, to prevent concurrent access from multiple processes. It is recommended to use this when acquiring your values for the first time, otherwise it is possible to get unpredictable results in case of multiple processes/threads trying to acquire values for the same key. In addition, it allows to batch multiple acquireValueFor(CharSequence) calls, to atomically acquire multiple values.

Type Parameters:

R - result type

Parameters:

code - code block to execute using locked table store

Returns:

result of code block execution

metadata

T metadata()