net.openhft.chronicle.bytes.ref

Class TextLongReference

java.lang.Object

net.openhft.chronicle.core.io.AbstractCloseable

net.openhft.chronicle.bytes.ref.AbstractReference

net.openhft.chronicle.bytes.ref.TextLongReference

All Implemented Interfaces:

Closeable, AutoCloseable, Byteable, LongReference, net.openhft.chronicle.core.io.ManagedCloseable, net.openhft.chronicle.core.io.Monitorable, net.openhft.chronicle.core.io.QueryCloseable, net.openhft.chronicle.core.io.ReferenceOwner, net.openhft.chronicle.core.io.SingleThreadedChecked, net.openhft.chronicle.core.values.LongValue

public class TextLongReference
extends AbstractReference
implements LongReference

Reference to a 20-digit, zero-padded long held in text format.

The layout is exactly 34 bytes and includes a spin-lock flag. The lock is obtained via CAS in withLock(ThrowingLongSupplier).

FALSE and TRUE encode the lock state as four ASCII characters.

These text classes are intended for debugging rather than production use.

Field Summary

Fields inherited from class net.openhft.chronicle.bytes.ref.AbstractReference

bytesStore, offset

Fields inherited from class net.openhft.chronicle.core.io.AbstractCloseable

closedHere, DISABLE_DISCARD_WARNING, WARN_NS

Fields inherited from interface net.openhft.chronicle.core.io.ReferenceOwner

INIT, TMP

Fields inherited from interface net.openhft.chronicle.core.io.SingleThreadedChecked

DISABLE_SINGLE_THREADED_CHECK

Constructor Summary

Constructors

Constructor and Description
TextLongReference()

Method Summary

Modifier and Type	Method and Description
long	addValue(long delta)
void	bytesStore(@NotNull BytesStore bytes, long offset, long length) Configures the byte store for this reference.
boolean	compareAndSwapValue(long expected, long value) Atomically sets the value to the given updated value if the current value is equal to the expected value.
long	getValue() Retrieves the value from the Text wire format.
long	maxSize()
void	setValue(long value) Sets the value in the Text wire format.
@NotNull String	toString()
static void	write(@NotNull Bytes<?> bytes, long value) Writes the initial structure of a 64-bit long value to the specified Bytes instance in Text wire format, with the given value.

Methods inherited from class net.openhft.chronicle.bytes.ref.AbstractReference

acceptNewBytesStore, address, bytesStore, lock, offset, performClose, tryLock, unmonitor

Methods inherited from class net.openhft.chronicle.core.io.AbstractCloseable

assertCloseable, assertCloseablesClosed, close, createdHere, disableCloseableTracing, enableCloseableTracing, gcAndWaitForCloseablesToClose, isClosed, isClosing, isInUserThread, referenceId, shouldPerformCloseInBackground, shouldWaitForClosed, singleThreadedCheckDisabled, singleThreadedCheckDisabled, singleThreadedCheckReset, threadSafetyCheck, throwExceptionIfClosed, throwExceptionIfClosedInSetter, waitForCloseablesToClose, waitForClosed, warnAndCloseIfNotClosed

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.openhft.chronicle.core.values.LongValue

addAtomicValue, close, getVolatileValue, getVolatileValue, isClosed, setMaxValue, setMinValue, setOrderedValue, setVolatileValue

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

closeQuietly, closeQuietly

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

isClosing

Methods inherited from interface net.openhft.chronicle.bytes.Byteable

address, bytesStore, lock, offset, tryLock

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

referenceName, temporary

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

unmonitor

Constructor Detail

TextLongReference

public TextLongReference()

Method Detail

write

public static void write(@NotNull
                         @NotNull Bytes<?> bytes,
                         long value)
                  throws BufferOverflowException,
                         IllegalArgumentException,
                         IllegalStateException

Writes the initial structure of a 64-bit long value to the specified Bytes instance in Text wire format, with the given value.

Parameters:

bytes - the Bytes instance to write to.

value - the long value to be written.

Throws:

BufferOverflowException - If there's not enough space in the buffer to write the value.

IllegalArgumentException - If an illegal argument is provided.

net.openhft.chronicle.core.io.ClosedIllegalStateException - If the resource has been released or closed.

net.openhft.chronicle.core.io.ThreadingIllegalStateException - If this resource was accessed by multiple threads in an unsafe way

IllegalStateException

bytesStore

public void bytesStore(@NotNull
                       @NotNull BytesStore bytes,
                       long offset,
                       long length)
                throws IllegalArgumentException,
                       IllegalStateException,
                       BufferOverflowException

Configures the byte store for this reference.

Specified by:

bytesStore in interface Byteable

Overrides:

bytesStore in class AbstractReference

Parameters:

bytes - the BytesStore instance where the reference is to be stored.

offset - the offset in the byte store where the reference is to be positioned.

length - the length of the reference in bytes.

Throws:

IllegalArgumentException - If an illegal argument is provided.

BufferOverflowException - If there's not enough space in the buffer to write the reference.

net.openhft.chronicle.core.io.ClosedIllegalStateException - If the resource has been released or closed.

net.openhft.chronicle.core.io.ThreadingIllegalStateException - If this resource was accessed by multiple threads in an unsafe way

IllegalStateException

getValue

public long getValue()
              throws IllegalStateException

Retrieves the value from the Text wire format.

Specified by:

getValue in interface net.openhft.chronicle.core.values.LongValue

Returns:

the long value.

Throws:

net.openhft.chronicle.core.io.ClosedIllegalStateException - If the resource has been released or closed.

net.openhft.chronicle.core.io.ThreadingIllegalStateException - If this resource was accessed by multiple threads in an unsafe way

IllegalStateException

setValue

public void setValue(long value)
              throws IllegalStateException

Sets the value in the Text wire format.

Specified by:

setValue in interface net.openhft.chronicle.core.values.LongValue

Parameters:

value - the value to be set.

Throws:

net.openhft.chronicle.core.io.ClosedIllegalStateException - If the resource has been released or closed.

net.openhft.chronicle.core.io.ThreadingIllegalStateException - If this resource was accessed by multiple threads in an unsafe way

IllegalStateException

maxSize

public long maxSize()

Specified by:

maxSize in interface Byteable

Returns:

fixed byte size represented by this object

toString

@NotNull
public @NotNull String toString()

Overrides:

toString in class net.openhft.chronicle.core.io.AbstractCloseable

addValue

public long addValue(long delta)
              throws IllegalStateException

Specified by:

addValue in interface net.openhft.chronicle.core.values.LongValue

Throws:

IllegalStateException

compareAndSwapValue

public boolean compareAndSwapValue(long expected,
                                   long value)
                            throws IllegalStateException

Atomically sets the value to the given updated value if the current value is equal to the expected value.

Specified by:

compareAndSwapValue in interface net.openhft.chronicle.core.values.LongValue

Parameters:

expected - the expected value.

value - the new value.

Returns:

true if successful, false otherwise.

Throws:

net.openhft.chronicle.core.io.ClosedIllegalStateException - If the resource has been released or closed.

net.openhft.chronicle.core.io.ThreadingIllegalStateException - If this resource was accessed by multiple threads in an unsafe way

IllegalStateException