net.openhft.chronicle.bytes.ref

Class BinaryIntReference

java.lang.Object

net.openhft.chronicle.core.io.AbstractCloseable

net.openhft.chronicle.bytes.ref.AbstractReference

net.openhft.chronicle.bytes.ref.BinaryIntReference

All Implemented Interfaces:

Closeable, AutoCloseable, Byteable, net.openhft.chronicle.core.io.ManagedCloseable, net.openhft.chronicle.core.io.QueryCloseable, net.openhft.chronicle.core.io.ReferenceOwner, net.openhft.chronicle.core.io.SingleThreadedChecked, net.openhft.chronicle.core.values.IntValue

public class BinaryIntReference
extends AbstractReference
implements net.openhft.chronicle.core.values.IntValue

Represents a 32-bit integer in binary form, backed by a BytesStore.

This class provides various operations to access and manipulate a single integer in binary form. The integer is stored in a BytesStore, and this class provides methods for atomic operations, reading/writing the value, and managing its state.

The class also supports volatile reads, ordered writes, and compare-and-swap operations. The maximum size of the backing storage is 4 bytes, corresponding to a 32-bit integer.

Example usage:

 BytesStore bytesStore = BytesStore.nativeStoreWithFixedCapacity(32);
 try (BinaryIntReference ref = new BinaryIntReference()) {
     ref.bytesStore(bytesStore, 16, 4);
     ref.setValue(10);
     int value = ref.getVolatileValue();
 }
 

Note: This class is not thread-safe. External synchronization may be necessary if instances are shared between threads.

See Also:

BytesStore, IntValue

Field Summary

Fields

Modifier and Type	Field and Description
static int	INT_NOT_COMPLETE

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

bytes, offset

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

closedHere, DISABLE_DISCARD_WARNING, DISABLE_THREAD_SAFETY, STRICT_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
BinaryIntReference()

Method Summary

Modifier and Type	Method and Description
int	addAtomicValue(int delta) Adds a delta to the current 32-bit integer value atomically and returns the result.
int	addValue(int delta) Adds a delta to the current 32-bit integer value and returns the result.
void	bytesStore(@NotNull BytesStore bytes, long offset, long length) Sets the BytesStore which this reference points to.
boolean	compareAndSwapValue(int expected, int value) Atomically sets the 32-bit integer value to the given updated value if the current value is equal to the expected value.
int	getValue() Retrieves the 32-bit integer value from the BytesStore.
int	getVolatileValue() Retrieves the 32-bit integer value using volatile memory semantics.
long	maxSize() Returns the maximum size of this reference in bytes (4 bytes for a 32-bit integer).
void	setOrderedValue(int value) Sets the 32-bit integer value using ordered or lazy set memory semantics.
void	setValue(int value) Sets the 32-bit integer value in the BytesStore.
@NotNull String	toString() Returns a string representation of this BinaryIntReference.

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

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

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

assertCloseable, assertCloseablesClosed, clearUsedByThread, close, createdHere, disableCloseableTracing, disableThreadSafetyCheck, disableThreadSafetyCheck, enableCloseableTracing, gcAndWaitForCloseablesToClose, isClosed, isClosing, isInUserThread, referenceId, resetUsedByThread, shouldPerformCloseInBackground, shouldWaitForClosed, singleThreadedCheckDisabled, singleThreadedCheckDisabled, singleThreadedCheckReset, threadSafetyCheck, throwExceptionIfClosed, throwExceptionIfClosedInSetter, unmonitor, 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.IntValue

close, isClosed

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.core.io.ReferenceOwner

referenceName, temporary

Field Detail

INT_NOT_COMPLETE

public static final int INT_NOT_COMPLETE

See Also:

Constant Field Values

Constructor Detail

BinaryIntReference

public BinaryIntReference()

Method Detail

bytesStore

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

Sets the BytesStore which this reference points to.

Specified by:

bytesStore in interface Byteable

Overrides:

bytesStore in class AbstractReference

Parameters:

bytes - the BytesStore

offset - the offset within the BytesStore

length - the length of the value

Throws:

IllegalArgumentException - If the length is not equal to maxSize

BufferOverflowException - If the offset is too large

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()

Returns the maximum size of this reference in bytes (4 bytes for a 32-bit integer).

Specified by:

maxSize in interface Byteable

Returns:

the maximum size in bytes

toString

@NotNull
public @NotNull String toString()

Returns a string representation of this BinaryIntReference.

Overrides:

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

Returns:

a string representation

getValue

public int getValue()
             throws IllegalStateException,
                    BufferUnderflowException

Retrieves the 32-bit integer value from the BytesStore.

Specified by:

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

Returns:

the 32-bit integer value

Throws:

BufferUnderflowException - If the offset is too large

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(int value)
              throws IllegalStateException,
                     BufferOverflowException

Sets the 32-bit integer value in the BytesStore.

Specified by:

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

Parameters:

value - the 32-bit integer value to set

Throws:

BufferOverflowException - If the offset is too large

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

getVolatileValue

public int getVolatileValue()
                     throws IllegalStateException,
                            BufferUnderflowException

Retrieves the 32-bit integer value using volatile memory semantics.

Specified by:

getVolatileValue in interface net.openhft.chronicle.core.values.IntValue

Returns:

the 32-bit integer value

Throws:

BufferUnderflowException - If the offset is too large

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

setOrderedValue

public void setOrderedValue(int value)
                     throws IllegalStateException,
                            BufferOverflowException

Sets the 32-bit integer value using ordered or lazy set memory semantics.

Specified by:

setOrderedValue in interface net.openhft.chronicle.core.values.IntValue

Parameters:

value - the 32-bit integer value to set

Throws:

BufferOverflowException - If the offset is too large

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

addValue

public int addValue(int delta)
             throws IllegalStateException,
                    BufferUnderflowException

Adds a delta to the current 32-bit integer value and returns the result.

Specified by:

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

Parameters:

delta - the value to add

Returns:

the resulting 32-bit integer value

Throws:

BufferUnderflowException - If the offset is too large

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

addAtomicValue

public int addAtomicValue(int delta)
                   throws IllegalStateException,
                          BufferUnderflowException

Adds a delta to the current 32-bit integer value atomically and returns the result.

Specified by:

addAtomicValue in interface net.openhft.chronicle.core.values.IntValue

Parameters:

delta - the value to add

Returns:

the resulting 32-bit integer value

Throws:

BufferUnderflowException - If the offset is too large

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

compareAndSwapValue

public boolean compareAndSwapValue(int expected,
                                   int value)
                            throws IllegalStateException,
                                   BufferOverflowException

Atomically sets the 32-bit integer 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.IntValue

Parameters:

expected - the expected 32-bit integer value

value - the new 32-bit integer value

Returns:

true if successful, false otherwise

Throws:

BufferOverflowException - If the offset is too large

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