net.openhft.chronicle.bytes

Interface BytesIn<U>

All Superinterfaces:

ByteStringParser<Bytes<U>>, RandomDataInput, StreamingCommon<Bytes<U>>, StreamingDataInput<Bytes<U>>

All Known Subinterfaces:

Bytes<U>

All Known Implementing Classes:

AbstractBytes, ChunkedMappedBytes, CommonMappedBytes, EmbeddedBytes, GuardedNativeBytes, HexDumpBytes, MappedBytes, NativeBytes, OnHeapBytes, SingleMappedBytes, SubBytes, UncheckedBytes, UncheckedNativeBytes, VanillaBytes

public interface BytesIn<U>
extends RandomDataInput, StreamingDataInput<Bytes<U>>, ByteStringParser<Bytes<U>>

Field Summary

Fields inherited from interface net.openhft.chronicle.bytes.RandomDataInput

charToString

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

INIT, TMP

Method Summary

Modifier and Type	Method and Description
long	addressForRead(long offset) Obtain the underlying addressForRead.
default long	addressForRead(long offset, int buffer)
long	addressForWrite(long offset) Obtain the underlying addressForRead.
long	addressForWritePosition()
default ByteOrder	byteOrder()
@NotNull Bytes<?>	bytesForRead()
@NotNull Bytes<?>	bytesForWrite()
default @NotNull MethodReader	bytesMethodReader(Object... objects) Reads messages from this tails as methods.
default @NotNull BytesMethodReaderBuilder	bytesMethodReaderBuilder()
default long	capacity()
boolean	isDirectMemory()
default long	lengthWritten(long startPosition) Typically this calculates the difference however for HexDumpBytes it's not as simple.
default long	readLimit() If the resource is closed, the returned value is unspecified.
<T extends ReadBytesMarshallable> T	readMarshallableLength16(@NotNull Class<T> tClass, T using)
default <T> T	readObject(@NotNull Class<T> componentType0)
default long	readPosition() Returns the read position.
default long	readRemaining() Returns the remaining bytes that can be read.
default long	realReadRemaining() If the resource is closed, the returned value is unspecified.
default long	realWriteRemaining() If the resource is closed, the returned value is unspecified.
boolean	sharedMemory()
default long	start()
default long	writeLimit() Returns the write limit.
default long	writePosition() Returns the write position.
default long	writeRemaining() If the resource is closed, the returned value is unspecified.

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

addAndGetDouble, addAndGetFloat, addAndGetInt, addAndGetLong, canReadDirect, canReadDirect, compareAndSwapDouble, compareAndSwapFloat, compareAndSwapInt, compareAndSwapLong, compareUtf8, copyTo, copyTo, createCharToString, fastHash, findByte, nativeRead, parseLong, peekUnsignedByte, peekVolatileInt, printable, read, readBoolean, readByte, readDouble, readFloat, readIncompleteLong, readInt, readLong, readShort, readUnsignedByte, readUnsignedInt, readUnsignedInt24, readUnsignedShort, readUtf8, readUtf8Limited, readUtf8Limited, readVolatileByte, readVolatileDouble, readVolatileFloat, readVolatileInt, readVolatileLong, readVolatileShort, realCapacity, subBytes, testAndSetInt, toByteArray, toTemporaryDirectByteBuffer

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

lastDecimalPlaces, lastDecimalPlaces, lastNumberHadDigits, lastNumberHadDigits, parse8bit, parse8bit, parse8bit, parse8bit, parse8bit, parseBigDecimal, parseBoolean, parseBoolean, parseDouble, parseFlexibleLong, parseFloat, parseInt, parseLong, parseLongDecimal, parseUtf8, parseUtf8, parseUtf8, reader, skipTo

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

copyTo, copyTo, inputStream, lenient, lenient, parseHexLong, parseUtf8, parseUtf8, peekUnsignedByte, rawReadByte, rawReadInt, rawReadLong, read, read, read, read, read, read, read8bit, read8bit, read8bit, readBigDecimal, readBigInteger, readBoolean, readByte, readChar, readDouble, readEnum, readFloat, readHistogram, readIncompleteLong, readInt, readInt24, readLimit, readLimitToCapacity, readLong, readPosition, readPositionForHeader, readPositionRemaining, readPositionUnlimited, readShort, readSkip, readStopBit, readStopBitChar, readStopBitDecimal, readStopBitDouble, readUnsignedByte, readUnsignedInt, readUnsignedInt24, readUnsignedShort, readUtf8, readUtf8, readUtf8, readUtf8, readVolatileInt, readVolatileLong, readWithLength, readWithLength, readWithLength0, uncheckedReadSkipBackOne, uncheckedReadSkipOne, uncheckedReadUnsignedByte, unsafeRead, unsafeReadObject, unsafeReadObject

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

clear

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

addReferenceChangeListener, refCount, release, releaseLast, releaseLast, removeReferenceChangeListener, reserve, reservedBy, reserveTransfer, tryReserve

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

referenceId, referenceName, temporary

Method Detail

bytesMethodReader

@NotNull
default @NotNull MethodReader bytesMethodReader(@NotNull
                                                         Object... objects)

Reads messages from this tails as methods. It returns a BooleanSupplier which returns

Parameters:

objects - which implement the methods serialized to the file.

Returns:

a reader which will read one Excerpt at a time

bytesMethodReaderBuilder

@NotNull
default @NotNull BytesMethodReaderBuilder bytesMethodReaderBuilder()

readMarshallableLength16

<T extends ReadBytesMarshallable> T readMarshallableLength16(@NotNull
                                                             @NotNull Class<T> tClass,
                                                             @Nullable
                                                             T using)
                                                      throws BufferUnderflowException,
                                                             IllegalStateException

Throws:

BufferUnderflowException

IllegalStateException

readObject

default <T> T readObject(@NotNull
                         @NotNull Class<T> componentType0)
                  throws BufferUnderflowException,
                         IllegalArgumentException,
                         IllegalStateException,
                         ArithmeticException,
                         BufferOverflowException

Throws:

BufferUnderflowException

IllegalArgumentException

IllegalStateException

ArithmeticException

BufferOverflowException

start

default long start()

Returns:

The smallest position allowed in this buffer.

capacity

default long capacity()

Returns:

the highest limit allowed for this buffer.

readPosition

default long readPosition()

Returns the read position.

The read position is start() <= readPosition() && readPosition() <= readLimit() && readPosition < safeLimit()

If the resource is closed, the returned value is unspecified.

Returns:

position to read from.

writePosition

default long writePosition()

Returns the write position.

The write position is readPosition() <= writePosition() && writePosition() <= writeLimit()

If the resource is closed, the returned value is unspecified.

Returns:

position to write to.

lengthWritten

default long lengthWritten(long startPosition)

Typically this calculates the difference however for HexDumpBytes it's not as simple.

If the resource is closed, the returned value is unspecified.

Parameters:

startPosition - to compare against

Returns:

the length from the startPosition

readRemaining

default long readRemaining()

Returns the remaining bytes that can be read.

If the resource is closed, the returned value is unspecified.

Returns:

How many more bytes can we read.

realReadRemaining

default long realReadRemaining()

If the resource is closed, the returned value is unspecified.

Returns:

how much can be safely read directly.

writeRemaining

default long writeRemaining()

If the resource is closed, the returned value is unspecified.

Returns:

How many more bytes can we written.

realWriteRemaining

default long realWriteRemaining()

If the resource is closed, the returned value is unspecified.

Returns:

writeRemaining with resize

readLimit

default long readLimit()

If the resource is closed, the returned value is unspecified.

Returns:

the highest offset or position allowed for this buffer.

writeLimit

default long writeLimit()

Returns the write limit.

If the resource is closed, the returned value is unspecified.

Returns:

the write limit

addressForRead

long addressForRead(long offset)
             throws UnsupportedOperationException,
                    BufferUnderflowException,
                    IllegalStateException

Obtain the underlying addressForRead. This is for expert users only.

Parameters:

offset - within this buffer. addressForRead(start()) is the actual addressForRead of the first byte.

Returns:

the underlying addressForRead of the buffer

Throws:

UnsupportedOperationException - if the underlying buffer is on the heap

BufferUnderflowException - if the offset is before the start() or the after the capacity()

IllegalStateException

addressForRead

default long addressForRead(long offset,
                            int buffer)
                     throws UnsupportedOperationException,
                            BufferUnderflowException,
                            IllegalStateException

Throws:

UnsupportedOperationException

BufferUnderflowException

IllegalStateException

addressForWrite

long addressForWrite(long offset)
              throws UnsupportedOperationException,
                     BufferOverflowException,
                     IllegalStateException

Obtain the underlying addressForRead. This is for expert users only.

Parameters:

offset - within this buffer. addressForRead(start()) is the actual addressForRead of the first byte.

Returns:

the underlying addressForRead of the buffer

Throws:

UnsupportedOperationException - if the underlying buffer is on the heap

BufferOverflowException - if the offset is before the start() or the after the capacity()

IllegalStateException

addressForWritePosition

long addressForWritePosition()
                      throws UnsupportedOperationException,
                             BufferOverflowException,
                             IllegalStateException

Throws:

UnsupportedOperationException

BufferOverflowException

IllegalStateException

byteOrder

default ByteOrder byteOrder()

bytesForRead

@NotNull
@NotNull Bytes<?> bytesForRead()
                                 throws IllegalStateException

Returns:

the streaming bytes for reading.

Throws:

IllegalStateException

bytesForWrite

@NotNull
@NotNull Bytes<?> bytesForWrite()
                                  throws IllegalStateException

Returns:

the streaming bytes for writing.

Throws:

IllegalStateException

sharedMemory

boolean sharedMemory()

Returns:

true if these Bytes use shared memory.

isDirectMemory

boolean isDirectMemory()