net.openhft.chronicle.wire

Class BinaryWire

java.lang.Object

net.openhft.chronicle.wire.AbstractWire

net.openhft.chronicle.wire.BinaryWire

All Implemented Interfaces:

Wire, WireCommon, WireIn, WireOut

public class BinaryWire
extends AbstractWire
implements Wire

This Wire is a binary translation of TextWire which is a sub set of YAML.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	BinaryWire.BinaryValueIn
protected class	BinaryWire.BinaryValueOut
protected class	BinaryWire.FixedBinaryValueOut

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

WireIn.HeaderType

Field Summary

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

ASSERTIONS, bytes, classLookup, parent, use8bit

Constructor Summary

Constructors

Constructor and Description
BinaryWire(net.openhft.chronicle.bytes.Bytes bytes)
BinaryWire(net.openhft.chronicle.bytes.Bytes bytes, boolean fixed, boolean numericFields, boolean fieldLess, int compressedSize, String compression, boolean supportDelta)

Method Summary

Modifier and Type	Method and Description
WireOut	addPadding(int paddingToAdd)
static BinaryWire	binaryOnly(net.openhft.chronicle.bytes.Bytes bytes)
void	clear() reset the state of the current wire for reuse.
void	consumePadding()
void	copyOne(WireOut wire)
void	copyTo(WireOut wire)
void	endEvent()
boolean	fieldLess()
protected BinaryWire.BinaryValueIn	getBinaryValueIn()
protected BinaryWire.FixedBinaryValueOut	getFixedBinaryValueOut(boolean fixed)
ValueIn	getValueIn() Obtain the value in (for internal use)
ValueOut	getValueOut() Obtain the value out
net.openhft.chronicle.core.values.IntValue	newIntReference()
net.openhft.chronicle.bytes.ref.BinaryLongArrayReference	newLongArrayReference()
net.openhft.chronicle.core.values.LongValue	newLongReference()
protected int	peekCode()
ValueIn	read() Read the field if present, or empty string if not present.
ValueIn	read(StringBuilder name) Read the field if present, or empty string if not present.
ValueIn	read(WireKey key) Read the field if present which must match the WireKey.
protected ValueIn	read2(WireKey key, net.openhft.chronicle.wire.ValueInState curr, StringBuilder sb, CharSequence name)
Wire	readComment(StringBuilder s)
<K> K	readEvent(Class<K> expectedClass) Read a field which might be an object of any type.
ValueIn	readEventName(StringBuilder name) Read a field, or string which is always written, even for formats which might drop the field such as RAW.
protected StringBuilder	readFieldAnchor(StringBuilder sb)
protected StringBuilder	readFieldNumber(WireKey key, StringBuilder sb, long fieldId)
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
DocumentContext	readingDocument(long readLocation)
void	readWithLength(WireOut wire, int len)
void	startEvent() Start an event object, mostly for internal use.
String	toString()
ValueOut	write() Write an empty filed marker
ValueOut	write(CharSequence key)
ValueOut	write(WireKey key) Write a key for wires that support fields.
protected net.openhft.chronicle.bytes.Bytes	writeCode(int code)
Wire	writeComment(CharSequence s)
ValueOut	writeEventName(CharSequence name)
ValueOut	writeEventName(WireKey key) Always write a key.
DocumentContext	writingDocument(boolean metaData) This will increment the headerNumber as appropriate if successful

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

bytes, checkNoDataAfterEnd, classLookup, classLookup, endUse, hasMore, headerNumber, headerNumber, headNumberCheck, isInsideHeader, notCompleteIsNotPresent, notCompleteIsNotPresent, objectInput, objectOutput, parent, parent, pauser, pauser, readAndSetLength, readDataHeader, readFirstHeader, readMetaDataHeader, startUse, updateFirstHeader, updateHeader, writeEndOfWire, writeFirstHeader, writeHeader

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

fromFile, headerNumber

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

asText, hasMore, objectInput, rawReadData, read, readAlignTo, readAllAsMap, readAndSetLength, readDataHeader, readDataHeader, readDocument, readDocument, readFirstHeader, readMetaDataHeader

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

objectOutput, padToCacheAlign, updateFirstHeader, updateHeader, updateHeader, writeAlignTo, writeAllAsMap, writeDocument, writeEndOfWire, writeEvent, writeFirstHeader, writeHeader, writeHeader, writeNotCompleteDocument

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

bytes, classLookup, classLookup, endUse, headerNumber, notCompleteIsNotPresent, notCompleteIsNotPresent, parent, parent, pauser, pauser, startUse

Constructor Detail

BinaryWire

public BinaryWire(net.openhft.chronicle.bytes.Bytes bytes)

BinaryWire

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

Method Detail

binaryOnly

public static BinaryWire binaryOnly(net.openhft.chronicle.bytes.Bytes bytes)

getFixedBinaryValueOut

@NotNull
protected BinaryWire.FixedBinaryValueOut getFixedBinaryValueOut(boolean fixed)

getBinaryValueIn

@NotNull
protected BinaryWire.BinaryValueIn getBinaryValueIn()

clear

public void clear()

Description copied from interface: WireCommon

reset the state of the current wire for reuse.

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

writingDocument

public DocumentContext writingDocument(boolean metaData)

Description copied from interface: WireOut

This will increment the headerNumber as appropriate if successful

Specified by:

writingDocument in interface WireOut

Returns:

readingDocument

public 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 WireIn

Returns:

the document context

readingDocument

public DocumentContext readingDocument(long readLocation)

Specified by:

readingDocument in interface WireIn

copyTo

public void copyTo(@NotNull
                   WireOut wire)

Specified by:

copyTo in interface WireIn

copyOne

public void copyOne(@NotNull
                    WireOut wire)

readWithLength

public void readWithLength(@NotNull
                           WireOut wire,
                           int len)

read

@NotNull
public ValueIn read()

Description copied from interface: WireIn

Read the field if present, or empty string if not present.

Specified by:

read in interface WireIn

read

@NotNull
public ValueIn read(@NotNull
                             WireKey key)

Description copied from interface: WireIn

Read the field if present which must match the WireKey.

Specified by:

read in interface WireIn

read2

protected ValueIn read2(@NotNull
                        WireKey key,
                        net.openhft.chronicle.wire.ValueInState curr,
                        StringBuilder sb,
                        CharSequence name)

readEventName

@NotNull
public ValueIn readEventName(@NotNull
                                      StringBuilder name)

Description copied from interface: WireIn

Read a field, or string which is always written, even for formats which might drop the field such as RAW.

Specified by:

readEventName in interface WireIn

read

@NotNull
public ValueIn read(@NotNull
                             StringBuilder name)

Description copied from interface: WireIn

Read the field if present, or empty string if not present.

Specified by:

read in interface WireIn

getValueIn

@NotNull
public ValueIn getValueIn()

Description copied from interface: WireIn

Obtain the value in (for internal use)

Specified by:

getValueIn in interface WireIn

readComment

@NotNull
public Wire readComment(@NotNull
                                 StringBuilder s)

Specified by:

readComment in interface WireIn

readEvent

public <K> K readEvent(Class<K> expectedClass)

Description copied from interface: WireIn

Read a field which might be an object of any type.

Specified by:

readEvent in interface WireIn

Parameters:

expectedClass - to use as a hint, or Object.class if no hint available.

Returns:

an instance of expectedClass

consumePadding

public void consumePadding()

Specified by:

consumePadding in interface WireIn

peekCode

protected int peekCode()

readFieldAnchor

protected StringBuilder readFieldAnchor(StringBuilder sb)

readFieldNumber

@NotNull
protected StringBuilder readFieldNumber(WireKey key,
                                                 @NotNull
                                                 StringBuilder sb,
                                                 long fieldId)

write

@NotNull
public ValueOut write()

Description copied from interface: WireOut

Write an empty filed marker

Specified by:

write in interface WireOut

writeEventName

@NotNull
public ValueOut writeEventName(@NotNull
                                        WireKey key)

Description copied from interface: WireOut

Always write a key. For RAW types, this label with be in text. To read this, use readEventName()

Specified by:

writeEventName in interface WireOut

writeEventName

@NotNull
public ValueOut writeEventName(@NotNull
                                        CharSequence name)

Specified by:

writeEventName in interface WireOut

startEvent

public void startEvent()

Description copied from interface: WireOut

Start an event object, mostly for internal use.

Specified by:

startEvent in interface WireOut

endEvent

public void endEvent()

Specified by:

endEvent in interface WireOut

write

@NotNull
public ValueOut write(@NotNull
                               WireKey key)

Description copied from interface: WireOut

Write a key for wires that support fields.

Specified by:

write in interface WireOut

write

@NotNull
public ValueOut write(@NotNull
                               CharSequence key)

Specified by:

write in interface WireOut

getValueOut

@NotNull
public ValueOut getValueOut()

Description copied from interface: WireOut

Obtain the value out

Specified by:

getValueOut in interface WireOut

writeComment

@NotNull
public Wire writeComment(CharSequence s)

Specified by:

writeComment in interface WireOut

addPadding

@NotNull
public WireOut addPadding(int paddingToAdd)

Specified by:

addPadding in interface WireOut

writeCode

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

toString

@NotNull
public String toString()

Overrides:

toString in class Object

newLongReference

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

Specified by:

newLongReference in interface WireCommon

Returns:

a LongValue which appropriate for this wire.

newIntReference

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

Specified by:

newIntReference in interface WireCommon

Returns:

an IntValue which appropriate for this wire.

newLongArrayReference

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

Specified by:

newLongArrayReference in interface WireCommon

Returns:

a LongArrayValue which appropriate for this wire.