net.openhft.chronicle.wire

Class BinaryWire

java.lang.Object

net.openhft.chronicle.wire.AbstractWire

net.openhft.chronicle.wire.BinaryWire

All Implemented Interfaces:

DocumentWritten, MarshallableIn, MarshallableOut, RollbackIfNotCompleteNotifier, Wire, WireCommon, WireIn, WireOut

public class BinaryWire
extends AbstractWire
implements Wire

Represents a binary translation of TextWire, which is a subset of YAML. This class provides functionalities for reading from and writing to binary wire formats. It encapsulates various configurations such as field representation, delta support, and compression settings. Extends the `AbstractWire` and implements the `Wire` interface to ensure compatibility and a common API with other wire formats.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	BinaryWire.BinaryValueIn Represents a binary input value and provides methods to read and manage the state of this binary input.
protected class	BinaryWire.BinaryValueOut Extends the FixedBinaryValueOut class to support binary value outputs with additional logic for converting and writing different types of numbers, namely integers and longs.
protected class	BinaryWire.FixedBinaryValueOut Implementation of the ValueOut interface, providing methods to write values in a fixed binary format.

Nested classes/interfaces inherited from interface net.openhft.chronicle.wire.WireIn

WireIn.HeaderType

Nested classes/interfaces inherited from interface net.openhft.chronicle.wire.WireOut

WireOut.EndOfWire

Field Summary

Fields

Modifier and Type	Field and Description
protected @NotNull BinaryWire.BinaryValueIn	valueIn

Fields inherited from class net.openhft.chronicle.wire.AbstractWire

bytes, classLookup, commentListener, DEFAULT_USE_PADDING, parent, use8bit

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

MARSHALLABLE_IN_INTERN_SIZE

Constructor Summary

Constructors

Constructor and Description
BinaryWire(@NotNull net.openhft.chronicle.bytes.Bytes<?> bytes) Constructs a BinaryWire with default settings.
BinaryWire(@NotNull net.openhft.chronicle.bytes.Bytes<?> bytes, boolean fixed, boolean numericFields, boolean fieldLess, int compressedSize, String compression, boolean supportDelta) Constructs a BinaryWire with specified configurations.

Method Summary

Modifier and Type	Method and Description
protected @NotNull StringBuilder	acquireStringBuilder() Acquires and clears the internal StringBuilder for use.
DocumentContext	acquireWritingDocument(boolean metaData) Retrieves a context for writing either data or metadata, reusing an existing context if available.
@NotNull WireOut	addPadding(int paddingToAdd) Adds padding to the wire.
protected void	anchor(@NotNull WireOut wire) Placeholder or handler for anchor processing in the WireOut stream.
static @NotNull BinaryWire	binaryOnly(@NotNull net.openhft.chronicle.bytes.Bytes<?> bytes) Creates and returns a new instance of BinaryWire with the delta support disabled.
void	clear() Clears the WireIn, effectively resetting its state.
void	consumePadding() Consumes and discards any padding that may exist between the current read position and the next piece of meaningful data.
void	copyOne(@NotNull WireOut wire) Copies one unit of data from this BinaryWire to the provided WireOut instance.
void	copyTo(@NotNull WireOut wire) Copies the content from the current WireIn source to the provided WireOut destination.
protected void	fieldAnchor(@NotNull WireOut wire) Placeholder or handler for field anchor processing in the WireOut stream.
boolean	fieldLess() Checks and returns if this BinaryWire instance is field-less.
protected @NotNull BinaryWire.BinaryValueIn	getBinaryValueIn() Creates and returns a new DeltaValueIn instance.
protected @NotNull BinaryWire.FixedBinaryValueOut	getFixedBinaryValueOut(boolean fixed) Provides a FixedBinaryValueOut instance based on the given boolean parameter.
Boolean	getOverrideSelfDescribing() Retrieves the current override setting for the self-describing nature of this BinaryWire.
@NotNull ValueIn	getValueIn() Obtains the value associated with a field or event for more advanced use cases.
@NotNull ValueOut	getValueOut() Retrieves the interface for defining the output of a value that will be written to the stream.
boolean	isBinary() Determine whether direct access to the underlying byte() makes sense or should it be treated as text
@NotNull net.openhft.chronicle.core.values.BooleanValue	newBooleanReference() Creates and returns a new BooleanValue.
@NotNull net.openhft.chronicle.core.values.IntArrayValues	newIntArrayReference() Creates and returns a new IntArrayValues.
@NotNull net.openhft.chronicle.core.values.IntValue	newIntReference() Creates and returns a new IntValue.
@NotNull net.openhft.chronicle.bytes.ref.BinaryLongArrayReference	newLongArrayReference() Creates and returns a new LongArrayValues.
@NotNull net.openhft.chronicle.core.values.LongValue	newLongReference() Creates and returns a new LongValue.
@NotNull net.openhft.chronicle.core.values.TwoLongValue	newTwoLongReference() Creates and returns a new TwoLongValue.
protected int	peekCode() Peeks the code from the current position without advancing the read pointer.
@NotNull ValueIn	read() Reads the next field if present, or returns an empty string if not present.
@NotNull ValueIn	read(@NotNull String fieldName) Reads the next field based on the provided field name.
@NotNull ValueIn	read(@NotNull StringBuilder name) Reads a specific field based on the provided field name.
@NotNull ValueIn	read(@NotNull WireKey key) Reads the next field if present.
protected <T> ValueIn	read2(CharSequence keyName, int keyCode, T defaultSource, @NotNull Function<T,Object> defaultLookup, @NotNull net.openhft.chronicle.wire.ValueInState curr, @NotNull StringBuilder sb, CharSequence name) A secondary method to continue the field search process, specifically to handle cases where the field may have been missed in a previous pass or if the field still hasn't been found.
@NotNull Wire	readComment(@NotNull StringBuilder s) Reads a comment from the Wire data and appends it to the provided StringBuilder.
<K> K	readEvent(@NotNull Class<K> expectedClass) Reads a field which may contain an object of any specified type.
@NotNull ValueIn	readEventName(@NotNull StringBuilder name) Reads a field or string, ensuring the value is always read.
long	readEventNumber() Reads the next event number.
protected @NotNull StringBuilder	readFieldAnchor(@NotNull StringBuilder sb) Reads a field anchor from the wire and populates the provided StringBuilder.
protected @NotNull StringBuilder	readFieldNumber(CharSequence keyName, int keyCode, @NotNull StringBuilder sb, long fieldId) Reads a field number from the wire and populates the provided StringBuilder.
@NotNull DocumentContext	readingDocument() equivalent to WireIn.readDocument(net.openhft.chronicle.wire.ReadMarshallable, net.openhft.chronicle.wire.ReadMarshallable) but with out the use of a lambda expression
@NotNull DocumentContext	readingDocument(long readLocation) Provides a context for reading a document starting at a specific position.
@NotNull String	readingPeekYaml() Typicality used for debugging, this method does not progress the read position and should only be used when inside a reading document.
void	readWithLength(@NotNull WireOut wire, int len) Reads data of a specified length from the bytes stream and writes to the WireOut stream while interpreting the type of data (Map, Sequence, or Object).
void	reset() Reset the state of the wire
void	rollbackIfNotComplete() Rolls back the current operation if it is not complete.
BinaryWire	setOverrideSelfDescribing(Boolean overrideSelfDescribing) Sets an override for the self-describing nature of this BinaryWire.
@NotNull String	toString() Converts the current state of the bytes storage to a debug string.
protected static void	unexpectedCode() Throws an exception indicating an unexpected code was encountered.
protected void	unknownCode(@NotNull WireOut wire) Throws an exception indicating an unknown code was encountered.
boolean	useSelfDescribingMessage(@NotNull net.openhft.chronicle.bytes.CommonMarshallable object) Determines whether a given object should use the self-describing message format.
@NotNull ValueOut	write() Writes an empty field marker to the stream.
@NotNull ValueOut	write(@NotNull CharSequence key) Writes a CharSequence key to the stream.
@NotNull ValueOut	write(@NotNull WireKey key) Writes a WireKey to the stream.
protected net.openhft.chronicle.bytes.Bytes<?>	writeCode(int code) Writes a byte code to the byte buffer.
@NotNull Wire	writeComment(CharSequence s) Writes a comment to the wire.
void	writeEndEvent()
ValueOut	writeEventId(int methodId) Writes an event identifier to the stream.
ValueOut	writeEventId(String name, int methodId) Writes an event identifier with a name to the stream.
@NotNull ValueOut	writeEventName(@NotNull CharSequence name) Writes a CharSequence key to the stream.
@NotNull ValueOut	writeEventName(@NotNull WireKey key) Writes a key to the stream.
void	writeStartEvent() Start an event object, mostly for internal use.
@NotNull DocumentContext	writingDocument(boolean metaData) Starts the process of writing a document to the wire with an option for metadata.
boolean	writingIsComplete() Checks if the current writing operation is complete.

Methods inherited from class net.openhft.chronicle.wire.AbstractWire

bytes, bytesComment, classLookup, classLookup, commentListener, endOfWire, enterHeader, forceNotInsideHeader, headerNumber, headerNumber, headNumberCheck, isInsideHeader, notCompleteIsNotPresent, notCompleteIsNotPresent, objectInput, objectOutput, parent, parent, pauser, pauser, readAndSetLength, readDataHeader, readFirstHeader, readFirstHeader, readMetaDataHeader, updateFirstHeader, updateFirstHeader, updateHeader, usePadding, usePadding, writeEndOfWire, writeFirstHeader

Methods inherited from class java.lang.Object

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

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

headerNumber, newYamlWireOnHeap

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

commentListener, endEvent, hasMetaDataPrefix, hasMore, hintReadInputOrder, isEmpty, isEndEvent, isNotEmptyAfterPadding, objectInput, rawReadData, readAlignTo, readAllAsMap, readAndSetLength, readDataHeader, readDataHeader, readDocument, readDocument, readFirstHeader, readFirstHeader, readMetaDataHeader, startEvent

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

methodReader, methodReaderBuilder, readBytes, readBytes, readDocument, readMap, readText, readText

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

dropDefault, endOfWire, enterHeader, objectOutput, padToCacheAlign, updateFirstHeader, updateFirstHeader, updateHeader, writeAlignTo, writeAllAsMap, writeDocument, writeEndOfWire, writeEvent, writeFirstHeader, writeNotCompleteDocument, writingDocument

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

bytes, bytesComment, classLookup, classLookup, headerNumber, notCompleteIsNotPresent, notCompleteIsNotPresent, parent, parent, pauser, pauser, usePadding, usePadding

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

builder, methodWriter, methodWriterBuilder, methodWriterBuilder, recordHistory, writeBytes, writeDocument, writeDocument, writeMap, writeMessage, writeMessage, writeText

Field Detail

valueIn

@NotNull
protected final @NotNull BinaryWire.BinaryValueIn valueIn

Constructor Detail

BinaryWire

public BinaryWire(@NotNull
                  @NotNull net.openhft.chronicle.bytes.Bytes<?> bytes)

Constructs a BinaryWire with default settings.

Parameters:

bytes - The bytes to be processed by this wire

BinaryWire

public BinaryWire(@NotNull
                  @NotNull net.openhft.chronicle.bytes.Bytes<?> bytes,
                  boolean fixed,
                  boolean numericFields,
                  boolean fieldLess,
                  int compressedSize,
                  String compression,
                  boolean supportDelta)

Constructs a BinaryWire with specified configurations.

Parameters:

bytes - The bytes to be processed by this wire

fixed - Indicates whether the value output is fixed

numericFields - Indicates if fields are represented numerically

fieldLess - Indicates if fields are absent

compressedSize - Threshold size for compression

compression - Type of compression (e.g., "binary")

supportDelta - Indicates if delta support is activated

Method Detail

binaryOnly

@NotNull
public static @NotNull BinaryWire binaryOnly(@NotNull
                                                      @NotNull net.openhft.chronicle.bytes.Bytes<?> bytes)

Creates and returns a new instance of BinaryWire with the delta support disabled.

Parameters:

bytes - The bytes to be processed by this wire

Returns:

A new instance of BinaryWire without delta support

reset

public void reset()

Description copied from interface: WireCommon

Reset the state of the wire

Specified by:

reset in interface WireCommon

rollbackIfNotComplete

public void rollbackIfNotComplete()

Description copied from interface: RollbackIfNotCompleteNotifier

Rolls back the current operation if it is not complete. This method should be invoked to ensure data consistency and to prevent partial updates. Implementations may throw an UnsupportedOperationException if rollback is not supported.

Specified by:

rollbackIfNotComplete in interface RollbackIfNotCompleteNotifier

isBinary

public boolean isBinary()

Description copied from interface: WireCommon

Determine whether direct access to the underlying byte() makes sense or should it be treated as text

Specified by:

isBinary in interface WireCommon

Returns:

Is this a binary protocol

getOverrideSelfDescribing

public Boolean getOverrideSelfDescribing()

Retrieves the current override setting for the self-describing nature of this BinaryWire.

Returns:

null if there's no override, true if it always uses self-describing messages, false if it never uses self-describing messages.

setOverrideSelfDescribing

public BinaryWire setOverrideSelfDescribing(Boolean overrideSelfDescribing)

Sets an override for the self-describing nature of this BinaryWire.

Parameters:

overrideSelfDescribing - null if there's no override, true if it should always use self-describing messages, false if it should never use self-describing messages.

Returns:

The current instance of the BinaryWire class (following the builder pattern).

acquireStringBuilder

@NotNull
protected @NotNull StringBuilder acquireStringBuilder()

Acquires and clears the internal StringBuilder for use. This method is used to avoid frequent instantiation of new StringBuilder objects, improving performance.

Returns:

A cleared instance of the internal StringBuilder.

getFixedBinaryValueOut

@NotNull
protected @NotNull BinaryWire.FixedBinaryValueOut getFixedBinaryValueOut(boolean fixed)

Provides a FixedBinaryValueOut instance based on the given boolean parameter. If 'fixed' is true, the method returns a fixed instance; otherwise, it creates and returns a new BinaryValueOut instance.

Parameters:

fixed - Determines which type of FixedBinaryValueOut to return.

Returns:

An instance of FixedBinaryValueOut.

getBinaryValueIn

@NotNull
protected @NotNull BinaryWire.BinaryValueIn getBinaryValueIn()

Creates and returns a new DeltaValueIn instance.

Returns:

A new DeltaValueIn instance.

clear

public void clear()

Description copied from interface: WireIn

Clears the WireIn, effectively resetting its state.

Specified by:

clear in interface WireCommon

Specified by:

clear in interface WireIn

Specified by:

clear in interface WireOut

Overrides:

clear in class AbstractWire

fieldLess

public boolean fieldLess()

Checks and returns if this BinaryWire instance is field-less.

Returns:

true if the BinaryWire is field-less, false otherwise.

writingDocument

@NotNull
public @NotNull DocumentContext writingDocument(boolean metaData)

Description copied from interface: WireOut

Starts the process of writing a document to the wire with an option for metadata.

Specified by:

writingDocument in interface DocumentWritten

Specified by:

writingDocument in interface MarshallableOut

Specified by:

writingDocument in interface WireOut

Parameters:

metaData - If true, the returned document context will be used for writing metadata.

Returns:

A context for the document being written.

acquireWritingDocument

public DocumentContext acquireWritingDocument(boolean metaData)

Description copied from interface: WireOut

Retrieves a context for writing either data or metadata, reusing an existing context if available.

Specified by:

acquireWritingDocument in interface DocumentWritten

Specified by:

acquireWritingDocument in interface MarshallableOut

Specified by:

acquireWritingDocument in interface WireOut

Parameters:

metaData - If true, the returned context will be used for writing metadata.

Returns:

A context for the document being written.

readingDocument

@NotNull
public @NotNull DocumentContext readingDocument()

Description copied from interface: WireIn

equivalent to WireIn.readDocument(net.openhft.chronicle.wire.ReadMarshallable, net.openhft.chronicle.wire.ReadMarshallable) but with out the use of a lambda expression

Specified by:

readingDocument in interface MarshallableIn

Specified by:

readingDocument in interface WireIn

Returns:

the document context

readingDocument

@NotNull
public @NotNull DocumentContext readingDocument(long readLocation)

Description copied from interface: WireIn

Provides a context for reading a document starting at a specific position.

Specified by:

readingDocument in interface WireIn

Parameters:

readLocation - The position from which to start reading the document.

Returns:

the document context associated with the specific read location.

readingPeekYaml

@NotNull
public @NotNull String readingPeekYaml()

Typicality used for debugging, this method does not progress the read position and should only be used when inside a reading document.

Specified by:

readingPeekYaml in interface WireIn

Returns:

when readReading a document returns the current document as a YAML String, if you are not currently reading a document, and empty string will be return.

copyTo

public void copyTo(@NotNull
                   @NotNull WireOut wire)
            throws net.openhft.chronicle.core.io.InvalidMarshallableException

Description copied from interface: WireIn

Copies the content from the current WireIn source to the provided WireOut destination.

Specified by:

copyTo in interface WireIn

Parameters:

wire - The WireOut instance where the content will be copied to.

Throws:

net.openhft.chronicle.core.io.InvalidMarshallableException - If there's an error in the marshalling process.

copyOne

public void copyOne(@NotNull
                    @NotNull WireOut wire)
             throws net.openhft.chronicle.core.io.InvalidMarshallableException

Copies one unit of data from this BinaryWire to the provided WireOut instance.

Parameters:

wire - The destination WireOut instance.

Throws:

net.openhft.chronicle.core.io.InvalidMarshallableException - if the operation encounters an error during marshalling.

unexpectedCode

protected static void unexpectedCode()

Throws an exception indicating an unexpected code was encountered.

Throws:

net.openhft.chronicle.core.io.IORuntimeException - Always thrown with a specific message.

anchor

protected void anchor(@NotNull
                      @NotNull WireOut wire)

Placeholder or handler for anchor processing in the WireOut stream. This implementation throws an exception indicating it's unexpected in this context.

Parameters:

wire - The wire output stream.

fieldAnchor

protected void fieldAnchor(@NotNull
                           @NotNull WireOut wire)

Placeholder or handler for field anchor processing in the WireOut stream. This implementation throws an exception indicating it's unexpected in this context.

Parameters:

wire - The wire output stream.

readWithLength

public void readWithLength(@NotNull
                           @NotNull WireOut wire,
                           int len)
                    throws net.openhft.chronicle.core.io.InvalidMarshallableException

Reads data of a specified length from the bytes stream and writes to the WireOut stream while interpreting the type of data (Map, Sequence, or Object).

Parameters:

wire - The wire output stream to write data to.

len - The length of data to be read.

Throws:

net.openhft.chronicle.core.io.InvalidMarshallableException - If there's an issue during marshalling.

unknownCode

protected void unknownCode(@NotNull
                           @NotNull WireOut wire)

Throws an exception indicating an unknown code was encountered.

Parameters:

wire - The wire output stream.

Throws:

IllegalArgumentException - with the corresponding message for the unknown code.

read

@NotNull
public @NotNull ValueIn read(@NotNull
                                      @NotNull String fieldName)

Description copied from interface: WireIn

Reads the next field based on the provided field name.

Specified by:

read in interface WireIn

Parameters:

fieldName - The name of the field to read.

Returns:

The value of the specified field, encapsulated in a ValueIn instance.

read

@NotNull
public @NotNull ValueIn read()

Description copied from interface: WireIn

Reads the next field if present, or returns an empty string if not present.

Specified by:

read in interface WireIn

Returns:

The value of the next field, encapsulated in a ValueIn instance.

read

@NotNull
public @NotNull ValueIn read(@NotNull
                                      @NotNull WireKey key)

Description copied from interface: WireIn

Reads the next field if present. The field should match the provided WireKey.

Specified by:

read in interface WireIn

Parameters:

key - The WireKey that should match the next field.

Returns:

The value of the matched field, encapsulated in a ValueIn instance.

read2

protected <T> ValueIn read2(CharSequence keyName,
                            int keyCode,
                            T defaultSource,
                            @NotNull
                            @NotNull Function<T,Object> defaultLookup,
                            @NotNull
                            @NotNull net.openhft.chronicle.wire.ValueInState curr,
                            @NotNull
                            @NotNull StringBuilder sb,
                            CharSequence name)

A secondary method to continue the field search process, specifically to handle cases where the field may have been missed in a previous pass or if the field still hasn't been found. It will revert to the default value if the field cannot be located.

Type Parameters:

T - The type of the default source.

Parameters:

keyName - The name of the key to be searched for.

keyCode - The code corresponding to the key.

defaultSource - The source to revert to if the key isn't found.

defaultLookup - The function used to derive a default value based on the defaultSource.

curr - The current state of ValueIn.

sb - The StringBuilder used for string manipulations during search.

name - The actual name of the field being sought.

Returns:

Returns a ValueIn object which represents the found or default value.

readEventNumber

public long readEventNumber()

Description copied from interface: WireIn

Reads the next event number. If no number is present, returns Long.MIN_VALUE.

Specified by:

readEventNumber in interface WireIn

Overrides:

readEventNumber in class AbstractWire

Returns:

The next event number or Long.MIN_VALUE if no number is present.

readEventName

@NotNull
public @NotNull ValueIn readEventName(@NotNull
                                               @NotNull StringBuilder name)

Description copied from interface: WireIn

Reads a field or string, ensuring the value is always read. This method is specifically designed to ensure reading even for formats that might potentially omit the field, such as RAW.

Specified by:

readEventName in interface WireIn

Parameters:

name - The StringBuilder that holds the name of the field or string.

Returns:

The value of the field or string, encapsulated in a ValueIn instance.

read

@NotNull
public @NotNull ValueIn read(@NotNull
                                      @NotNull StringBuilder name)

Description copied from interface: WireIn

Reads a specific field based on the provided field name. If the field is not present, it returns an empty string.

Specified by:

read in interface WireIn

Parameters:

name - The name of the field to read.

Returns:

The value of the specified field, encapsulated in a ValueIn instance.

getValueIn

@NotNull
public @NotNull ValueIn getValueIn()

Description copied from interface: WireIn

Obtains the value associated with a field or event for more advanced use cases. Typically used after a call to WireIn.readEvent(Class).

Specified by:

getValueIn in interface WireIn

Returns:

The value of the field or event, encapsulated in a ValueIn instance.

readComment

@NotNull
public @NotNull Wire readComment(@NotNull
                                          @NotNull StringBuilder s)

Description copied from interface: WireIn

Reads a comment from the Wire data and appends it to the provided StringBuilder.

Specified by:

readComment in interface WireIn

Parameters:

s - StringBuilder to which the comment will be appended.

Returns:

the WireIn instance for method chaining.

readEvent

@Nullable
public <K> K readEvent(@NotNull
                                 @NotNull Class<K> expectedClass)
                          throws net.openhft.chronicle.core.io.InvalidMarshallableException

Description copied from interface: WireIn

Reads a field which may contain an object of any specified type.

Specified by:

readEvent in interface WireIn

Type Parameters:

K - The type of object expected.

Parameters:

expectedClass - The class type hint of the expected object. If no hint is available, use Object.class.

Returns:

An instance of the specified expectedClass.

Throws:

net.openhft.chronicle.core.io.InvalidMarshallableException - If there's an error in the marshalling process.

consumePadding

public void consumePadding()

Description copied from interface: WireIn

Consumes and discards any padding that may exist between the current read position and the next piece of meaningful data.

Specified by:

consumePadding in interface WireIn

peekCode

protected int peekCode()

Peeks the code from the current position without advancing the read pointer.

Returns:

The unsigned byte at the current read position.

readFieldAnchor

@NotNull
protected @NotNull StringBuilder readFieldAnchor(@NotNull
                                                          @NotNull StringBuilder sb)

Reads a field anchor from the wire and populates the provided StringBuilder. This method specifically handles the case when the valueIn is an instance of DeltaValueIn.

Parameters:

sb - The StringBuilder to be populated with the read field anchor.

Returns:

The populated StringBuilder with the read field anchor.

Throws:

UnsupportedOperationException - If the valueIn is not an instance of DeltaValueIn.

readFieldNumber

@NotNull
protected @NotNull StringBuilder readFieldNumber(CharSequence keyName,
                                                          int keyCode,
                                                          @NotNull
                                                          @NotNull StringBuilder sb,
                                                          long fieldId)

Reads a field number from the wire and populates the provided StringBuilder.

Parameters:

keyName - The key name of the field to be matched against.

keyCode - The key code of the field to be matched against.

sb - The StringBuilder to be populated with the read field number.

fieldId - The ID of the field read from the wire.

Returns:

The populated StringBuilder with the read field number.

write

@NotNull
public @NotNull ValueOut write()

Description copied from interface: WireOut

Writes an empty field marker to the stream.

Specified by:

write in interface WireOut

Returns:

An interface to further define the output for the written value.

writeEventName

@NotNull
public @NotNull ValueOut writeEventName(@NotNull
                                                 @NotNull WireKey key)

Description copied from interface: WireOut

Writes a key to the stream. For RAW types, the label will be in text. This can be read using readEventName().

Specified by:

writeEventName in interface WireOut

Parameters:

key - The key to write to the stream.

Returns:

An interface to further define the output for the written value.

writeEventName

@NotNull
public @NotNull ValueOut writeEventName(@NotNull
                                                 @NotNull CharSequence name)

Description copied from interface: WireOut

Writes a CharSequence key to the stream.

Specified by:

writeEventName in interface WireOut

Parameters:

name - The CharSequence key to write to the stream.

Returns:

An interface to further define the output for the written value.

writeEventId

public ValueOut writeEventId(int methodId)

Description copied from interface: WireOut

Writes an event identifier to the stream.

Specified by:

writeEventId in interface WireOut

Parameters:

methodId - The ID of the method representing the event.

Returns:

An interface to further define the output for the written value.

writeEventId

public ValueOut writeEventId(String name,
                             int methodId)

Description copied from interface: WireOut

Writes an event identifier with a name to the stream.

Specified by:

writeEventId in interface WireOut

Parameters:

name - The name of the event.

methodId - The ID of the method representing the event.

Returns:

An interface to further define the output for the written value.

writeStartEvent

public void writeStartEvent()

Description copied from interface: WireOut

Start an event object, mostly for internal use.

Specified by:

writeStartEvent in interface WireOut

writeEndEvent

public void writeEndEvent()

Specified by:

writeEndEvent in interface WireOut

write

@NotNull
public @NotNull ValueOut write(@NotNull
                                        @NotNull WireKey key)

Description copied from interface: WireOut

Writes a WireKey to the stream. This method is typically used for wires that support fields with structured keys.

Specified by:

write in interface WireOut

Parameters:

key - The WireKey to write to the stream.

Returns:

An interface to further define the output for the written value.

write

@NotNull
public @NotNull ValueOut write(@NotNull
                                        @NotNull CharSequence key)

Description copied from interface: WireOut

Writes a CharSequence key to the stream. This provides flexibility to write non-standard keys to the wire.

Specified by:

write in interface WireOut

Parameters:

key - The CharSequence key to write to the stream.

Returns:

An interface to further define the output for the written value.

getValueOut

@NotNull
public @NotNull ValueOut getValueOut()

Description copied from interface: WireOut

Retrieves the interface for defining the output of a value that will be written to the stream.

Specified by:

getValueOut in interface WireOut

Returns:

The interface to further define the output for the written value.

writeComment

@NotNull
public @NotNull Wire writeComment(CharSequence s)

Description copied from interface: WireOut

Writes a comment to the wire. Comments may be useful for debugging or providing context within the wire stream.

Specified by:

writeComment in interface WireOut

Parameters:

s - The comment to be written to the stream.

Returns:

This WireOut instance for method chaining.

addPadding

@NotNull
public @NotNull WireOut addPadding(int paddingToAdd)

Description copied from interface: WireOut

Adds padding to the wire. This is particularly useful for aligning data.

Specified by:

addPadding in interface WireOut

Parameters:

paddingToAdd - The amount of padding to add.

Returns:

This WireOut instance for method chaining.

writeCode

protected net.openhft.chronicle.bytes.Bytes<?> writeCode(int code)

Writes a byte code to the byte buffer.

Parameters:

code - The byte code to write.

Returns:

Returns the byte buffer after writing the code.

toString

@NotNull
public @NotNull String toString()

Converts the current state of the bytes storage to a debug string.

This method provides a string representation of the bytes, useful for debugging purposes.

Overrides:

toString in class Object

Returns:

A string representation of the bytes.

newLongReference

@NotNull
public @NotNull net.openhft.chronicle.core.values.LongValue newLongReference()

Description copied from interface: WireCommon

Creates and returns a new LongValue. The LongValue implementation that is returned depends on the wire implementation.

Specified by:

newLongReference in interface WireCommon

Returns:

a new LongValue

newBooleanReference

@NotNull
public @NotNull net.openhft.chronicle.core.values.BooleanValue newBooleanReference()

Description copied from interface: WireCommon

Creates and returns a new BooleanValue. The BooleanValue implementation that is returned depends on the wire implementation.

Specified by:

newBooleanReference in interface WireCommon

Returns:

a new BooleanValue.

newTwoLongReference

@NotNull
public @NotNull net.openhft.chronicle.core.values.TwoLongValue newTwoLongReference()

Description copied from interface: WireCommon

Creates and returns a new TwoLongValue. The TwoLongValue implementation that is returned depends on the wire implementation.

Specified by:

newTwoLongReference in interface WireCommon

Returns:

a new TwoLongValue

newIntReference

@NotNull
public @NotNull net.openhft.chronicle.core.values.IntValue newIntReference()

Description copied from interface: WireCommon

Creates and returns a new IntValue. The IntValue implementation that is returned depends on the wire implementation.

Specified by:

newIntReference in interface WireCommon

Returns:

a new IntValue.

newLongArrayReference

@NotNull
public @NotNull net.openhft.chronicle.bytes.ref.BinaryLongArrayReference newLongArrayReference()

Description copied from interface: WireCommon

Creates and returns a new LongArrayValues. The LongArrayValues implementation that is returned depends on the wire implementation.

Specified by:

newLongArrayReference in interface WireCommon

Returns:

a new LongArrayValues

newIntArrayReference

@NotNull
public @NotNull net.openhft.chronicle.core.values.IntArrayValues newIntArrayReference()

Description copied from interface: WireCommon

Creates and returns a new IntArrayValues. The IntArrayValues implementation that is returned depends on the wire implementation.

Specified by:

newIntArrayReference in interface WireCommon

Returns:

a new IntArrayValues

useSelfDescribingMessage

public boolean useSelfDescribingMessage(@NotNull
                                        @NotNull net.openhft.chronicle.bytes.CommonMarshallable object)

Determines whether a given object should use the self-describing message format.

This method first checks if an override value for self-describing is set. If not, it uses the self-describing value from the provided object.

Specified by:

useSelfDescribingMessage in interface WireCommon

Parameters:

object - The object whose self-describing status needs to be checked.

Returns:

true if the object should use the self-describing message format, false otherwise.

writingIsComplete

public boolean writingIsComplete()

Description copied from interface: RollbackIfNotCompleteNotifier

Checks if the current writing operation is complete. This method can be used to determine if it's safe to proceed with further operations or if a rollback is required.

Specified by:

writingIsComplete in interface RollbackIfNotCompleteNotifier

Specified by:

writingIsComplete in interface WireOut

Returns:

true unless there is an incomplete/chained message