net.openhft.chronicle.wire

Class TextWire

java.lang.Object

net.openhft.chronicle.wire.AbstractWire

net.openhft.chronicle.wire.TextWire

All Implemented Interfaces:

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

Direct Known Subclasses:

CSVWire, JSONWire, QueryWire

public class TextWire
extends AbstractWire
implements Wire

YAML Based wire format

Nested Class Summary

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

WireIn.HeaderType

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

MarshallableOut.Padding

Field Summary

Fields

Modifier and Type	Field and Description
static net.openhft.chronicle.bytes.BytesStore	BINARY
protected long	lineStart
static net.openhft.chronicle.bytes.BytesStore	TYPE
static @NotNull net.openhft.chronicle.bytes.Bytes<byte[]>	TYPE_STR
protected net.openhft.chronicle.wire.TextWire.TextValueIn	valueIn

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

ASSERTIONS, bytes, classLookup, parent, use8bit

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

MARSHALLABLE_IN_INTERN_SIZE

Constructor Summary

Constructors

Constructor and Description
TextWire(@NotNull net.openhft.chronicle.bytes.Bytes bytes)
TextWire(@NotNull net.openhft.chronicle.bytes.Bytes bytes, boolean use8bit)

Method Summary

Modifier and Type	Method and Description
DocumentContext	acquireWritingDocument(boolean metaData) Start or reuse an existing a DocumentContext, optionally call close() when done.
@NotNull WireOut	addPadding(int paddingToAdd)
boolean	addTimeStamps()
TextWire	addTimeStamps(boolean addTimeStamps)
void	append(@NotNull CharSequence cs)
void	append(@NotNull CharSequence cs, int offset, int length)
static String	asText(@NotNull Wire wire)
@NotNull net.openhft.chronicle.bytes.Bytes<?>	bytes() Returns the underlying Bytes stored by the wire.
net.openhft.chronicle.core.pool.ClassLookup	classLookup() Returns the current ClassLookup implementation being used for class lookup.
void	classLookup(net.openhft.chronicle.core.pool.ClassLookup classLookup) Sets the ClassLookup implementation to be used for class lookup.
void	clear() Resets the state of the underlying Bytes stored by the wire.
protected void	consumeDocumentStart()
void	consumePadding()
void	consumePadding(int commas)
void	consumeWhiteSpace()
void	copyTo(@NotNull WireOut wire)
protected @NotNull net.openhft.chronicle.wire.TextWire.TextValueIn	createValueIn()
protected @NotNull net.openhft.chronicle.wire.TextWire.TextValueOut	createValueOut()
@NotNull WireOut	dropDefault(boolean dropDefault)
protected void	escape0(@NotNull CharSequence s, @NotNull net.openhft.chronicle.wire.Quotes quotes)
static @NotNull TextWire	from(@NotNull String text)
static @NotNull TextWire	fromFile(String name)
protected @NotNull net.openhft.chronicle.bytes.StopCharsTester	getEscapingEndEventName()
protected @NotNull net.openhft.chronicle.bytes.StopCharTester	getEscapingEndOfText()
protected @Nullable net.openhft.chronicle.bytes.StopCharTester	getEscapingQuotes()
protected @NotNull net.openhft.chronicle.bytes.StopCharsTester	getStrictEscapingEndOfText()
@NotNull ValueIn	getValueIn() Obtain the value in (for internal use)
@NotNull ValueOut	getValueOut() Obtain the value out
protected void	initReadContext()
static <T> T	load(String filename) Loads an Object from a file
@NotNull VanillaMethodReaderBuilder	methodReaderBuilder()
<T> T	methodWriter(@NotNull Class<T> tClass, Class... additional) Proxy an interface so each message called is written to a file for replay.
<T> @NotNull net.openhft.chronicle.bytes.MethodWriterBuilder<T>	methodWriterBuilder(@NotNull Class<T> tClass)
protected @NotNull net.openhft.chronicle.wire.Quotes	needsQuotes(@NotNull CharSequence s)
@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.core.values.LongArrayValues	newLongArrayReference() Creates and returns a new LongArrayValues.
@NotNull net.openhft.chronicle.core.values.LongValue	newLongReference() Creates and returns a new LongValue.
void	parseUntil(@NotNull StringBuilder sb, @NotNull net.openhft.chronicle.bytes.StopCharsTester testers)
void	parseUntil(@NotNull StringBuilder sb, @NotNull net.openhft.chronicle.bytes.StopCharTester testers)
void	parseWord(@NotNull StringBuilder sb)
protected boolean	peekStringIgnoreCase(@NotNull String source) returns true if the next string is str
@NotNull ValueIn	read() Read the field if present, or empty string if not present.
@NotNull ValueIn	read(@NotNull StringBuilder name) Read the field if present, or empty string if not present.
@NotNull ValueIn	read(@NotNull WireKey key) Read the field if present which must match the WireKey.
protected ValueIn	read2(CharSequence keyName, int keyCode, Object defaultValue, @NotNull net.openhft.chronicle.wire.ValueInState curr, @NotNull StringBuilder sb, @NotNull CharSequence name)
protected int	readCode()
@NotNull Wire	readComment(@NotNull StringBuilder s)
<K> K	readEvent(@NotNull Class<K> expectedClass) Read a field which might be an object of any type.
long	readEventNumber()
protected @NotNull StringBuilder	readField(@NotNull StringBuilder sb)
@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)
@NotNull String	readingPeekYaml()
@Nullable Object	readObject()
boolean	strict()
TextWire	strict(boolean strict)
String	toString()
static <ACS extends Appendable & CharSequence> void	unescape(ACS sb)
@NotNull TextWire	useBinaryDocuments()
@NotNull TextWire	useTextDocuments()
@NotNull ValueOut	write() Write an empty filed marker
@NotNull ValueOut	write(@NotNull CharSequence name)
@NotNull ValueOut	write(@NotNull WireKey key) Write a key for wires that support fields.
@NotNull Wire	writeComment(@NotNull CharSequence s)
void	writeEndEvent()
ValueOut	writeEvent(Class expectedType, Object eventKey)
void	writeObject(Object o)
void	writeStartEvent() Start an event object, mostly for internal use.
@NotNull DocumentContext	writingDocument(boolean metaData) This will increment the headerNumber as appropriate if successful

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

bytesComment, endUse, enterHeader, forceNotInsideHeader, headerNumber, headerNumber, headNumberCheck, isInsideHeader, notCompleteIsNotPresent, notCompleteIsNotPresent, objectInput, objectOutput, parent, parent, pauser, pauser, readAndSetLength, readDataHeader, readFirstHeader, readFirstHeader, readMetaDataHeader, startUse, 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

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

asText, endEvent, hasMore, hintReadInputOrder, isEmpty, isEndEvent, isNotEmptyAfterPadding, objectInput, rawReadData, read, readAlignTo, readAllAsMap, readAndSetLength, readDataHeader, readDataHeader, readDocument, readDocument, readEventName, readFirstHeader, readFirstHeader, readMetaDataHeader, startEvent

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

methodReader, peekDocument, readBytes, readBytes, readDocument, readMap, readText, readText

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

enterHeader, objectOutput, padToCacheAlign, updateFirstHeader, updateHeader, writeAlignTo, writeAllAsMap, writeDocument, writeEndOfWire, writeEventId, writeEventId, writeEventName, writeEventName, writeFirstHeader, writeNotCompleteDocument, writingDocument

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

bytesComment, endUse, headerNumber, newTwoLongReference, notCompleteIsNotPresent, notCompleteIsNotPresent, parent, parent, pauser, pauser, startUse, usePadding, usePadding

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

methodWriter, padToCacheAlignMode, recordHistory, writeBytes, writeDocument, writeDocument, writeMap, writeMessage, writeMessage, writeText

Field Detail

TYPE

public static final net.openhft.chronicle.bytes.BytesStore TYPE

BINARY

public static final net.openhft.chronicle.bytes.BytesStore BINARY

TYPE_STR

@NotNull
public static final @NotNull net.openhft.chronicle.bytes.Bytes<byte[]> TYPE_STR

valueIn

protected final net.openhft.chronicle.wire.TextWire.TextValueIn valueIn

lineStart

protected long lineStart

Constructor Detail

TextWire

public TextWire(@NotNull
                @NotNull net.openhft.chronicle.bytes.Bytes bytes,
                boolean use8bit)

TextWire

public TextWire(@NotNull
                @NotNull net.openhft.chronicle.bytes.Bytes bytes)

Method Detail

fromFile

@NotNull
public static @NotNull TextWire fromFile(String name)
                                           throws IOException

Specified by:

fromFile in interface Wire

Throws:

IOException

from

@NotNull
public static @NotNull TextWire from(@NotNull
                                              @NotNull String text)

asText

public static String asText(@NotNull
                            @NotNull Wire wire)

unescape

public static <ACS extends Appendable & CharSequence> void unescape(@NotNull
                                                                    ACS sb)

load

public static <T> T load(String filename)
                  throws IOException

Loads an Object from a file

Type Parameters:

T - the type of the object to load

Parameters:

filename - the file-path containing the object

Returns:

an instance of the object created fromt the data in the file

Throws:

IOException - if the file can not be found or read

strict

public boolean strict()

strict

public TextWire strict(boolean strict)

addTimeStamps

public boolean addTimeStamps()

addTimeStamps

public TextWire addTimeStamps(boolean addTimeStamps)

methodWriter

@NotNull
public <T> T methodWriter(@NotNull
                                   @NotNull Class<T> tClass,
                                   Class... additional)

Description copied from interface: MarshallableOut

Proxy an interface so each message called is written to a file for replay.

Specified by:

methodWriter in interface MarshallableOut

Parameters:

tClass - primary interface

additional - any additional interfaces

Returns:

a proxy which implements the primary interface (additional interfaces have to be cast)

methodWriterBuilder

@NotNull
public <T> @NotNull net.openhft.chronicle.bytes.MethodWriterBuilder<T> methodWriterBuilder(@NotNull
                                                                                                    @NotNull Class<T> tClass)

Specified by:

methodWriterBuilder in interface MarshallableOut

methodReaderBuilder

@NotNull
public @NotNull VanillaMethodReaderBuilder methodReaderBuilder()

Specified by:

methodReaderBuilder in interface MarshallableIn

classLookup

public void classLookup(net.openhft.chronicle.core.pool.ClassLookup classLookup)

Description copied from interface: WireCommon

Sets the ClassLookup implementation to be used for class lookup.

Specified by:

classLookup in interface WireCommon

Overrides:

classLookup in class AbstractWire

Parameters:

classLookup - implementation to be used for class lookup.

classLookup

public net.openhft.chronicle.core.pool.ClassLookup classLookup()

Description copied from interface: WireCommon

Returns the current ClassLookup implementation being used for class lookup.

Specified by:

classLookup in interface WireCommon

Overrides:

classLookup in class AbstractWire

Returns:

the current ClassLookup implementation being used for class lookup

writingDocument

@NotNull
public @NotNull DocumentContext writingDocument(boolean metaData)

Description copied from interface: WireOut

This will increment the headerNumber as appropriate if successful

Specified by:

writingDocument in interface DocumentWritten

Specified by:

writingDocument in interface MarshallableOut

Specified by:

writingDocument in interface WireOut

Parameters:

metaData - if true the document context will be used for writing meta data, otherwise data

Returns:

a document context used for witting

acquireWritingDocument

public DocumentContext acquireWritingDocument(boolean metaData)

Description copied from interface: MarshallableOut

Start or reuse an existing a DocumentContext, optionally call close() when done.

Specified by:

acquireWritingDocument in interface DocumentWritten

Specified by:

acquireWritingDocument in interface MarshallableOut

Specified by:

acquireWritingDocument in interface WireOut

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

initReadContext

protected void initReadContext()

useBinaryDocuments

@NotNull
public @NotNull TextWire useBinaryDocuments()

useTextDocuments

@NotNull
public @NotNull TextWire useTextDocuments()

readingDocument

@NotNull
public @NotNull DocumentContext readingDocument(long readLocation)

Specified by:

readingDocument in interface WireIn

createValueOut

@NotNull
protected @NotNull net.openhft.chronicle.wire.TextWire.TextValueOut createValueOut()

createValueIn

@NotNull
protected @NotNull net.openhft.chronicle.wire.TextWire.TextValueIn createValueIn()

toString

public String toString()

Overrides:

toString in class Object

copyTo

public void copyTo(@NotNull
                   @NotNull WireOut wire)

Specified by:

copyTo in interface WireIn

readEventNumber

public long readEventNumber()

Specified by:

readEventNumber in interface WireIn

Overrides:

readEventNumber in class AbstractWire

Returns:

field number or Long.MIN_VALUE if no number.

read

@NotNull
public @NotNull ValueIn read()

Description copied from interface: WireIn

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

Specified by:

read in interface WireIn

readField

@NotNull
protected @NotNull StringBuilder readField(@NotNull
                                                    @NotNull StringBuilder sb)

readEvent

@Nullable
public <K> K readEvent(@NotNull
                                 @NotNull 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

getEscapingEndOfText

@NotNull
protected @NotNull net.openhft.chronicle.bytes.StopCharTester getEscapingEndOfText()

getStrictEscapingEndOfText

@NotNull
protected @NotNull net.openhft.chronicle.bytes.StopCharsTester getStrictEscapingEndOfText()

getEscapingEndEventName

@NotNull
protected @NotNull net.openhft.chronicle.bytes.StopCharsTester getEscapingEndEventName()

getEscapingQuotes

@Nullable
protected @Nullable net.openhft.chronicle.bytes.StopCharTester getEscapingQuotes()

consumePadding

public void consumePadding()

Specified by:

consumePadding in interface WireIn

readingPeekYaml

@NotNull
public @NotNull String readingPeekYaml()

Specified by:

readingPeekYaml in interface WireIn

consumePadding

public void consumePadding(int commas)

consumeDocumentStart

protected void consumeDocumentStart()

peekStringIgnoreCase

protected boolean peekStringIgnoreCase(@NotNull
                                       @NotNull String source)

returns true if the next string is str

Parameters:

source - string

Returns:

true if the strings are the same

readCode

protected int readCode()

read

@NotNull
public @NotNull ValueIn read(@NotNull
                                      @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(CharSequence keyName,
                        int keyCode,
                        Object defaultValue,
                        @NotNull
                        @NotNull net.openhft.chronicle.wire.ValueInState curr,
                        @NotNull
                        @NotNull StringBuilder sb,
                        @NotNull
                        @NotNull CharSequence name)

read

@NotNull
public @NotNull ValueIn read(@NotNull
                                      @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 @NotNull ValueIn getValueIn()

Description copied from interface: WireIn

Obtain the value in (for internal use)

Specified by:

getValueIn in interface WireIn

readComment

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

Specified by:

readComment in interface WireIn

consumeWhiteSpace

public void consumeWhiteSpace()

clear

public void clear()

Description copied from interface: WireCommon

Resets the state of the underlying Bytes stored by the wire.

Specified by:

clear in interface WireCommon

Specified by:

clear in interface WireIn

Specified by:

clear in interface WireOut

Overrides:

clear in class AbstractWire

bytes

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

Description copied from interface: WireCommon

Returns the underlying Bytes stored by the wire.

Specified by:

bytes in interface WireCommon

Overrides:

bytes in class AbstractWire

Returns:

the underlying Bytes stored by the wire

write

@NotNull
public @NotNull ValueOut write()

Description copied from interface: WireOut

Write an empty filed marker

Specified by:

write in interface WireOut

write

@NotNull
public @NotNull ValueOut write(@NotNull
                                        @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 @NotNull ValueOut write(@NotNull
                                        @NotNull CharSequence name)

Specified by:

write in interface WireOut

writeEvent

public ValueOut writeEvent(Class expectedType,
                           Object eventKey)

Specified by:

writeEvent in interface WireOut

dropDefault

@NotNull
public @NotNull WireOut dropDefault(boolean dropDefault)

Specified by:

dropDefault in interface WireOut

getValueOut

@NotNull
public @NotNull ValueOut getValueOut()

Description copied from interface: WireOut

Obtain the value out

Specified by:

getValueOut in interface WireOut

writeComment

@NotNull
public @NotNull Wire writeComment(@NotNull
                                           @NotNull CharSequence s)

Specified by:

writeComment in interface WireOut

addPadding

@NotNull
public @NotNull WireOut addPadding(int paddingToAdd)

Specified by:

addPadding in interface WireOut

escape0

protected void escape0(@NotNull
                       @NotNull CharSequence s,
                       @NotNull
                       @NotNull net.openhft.chronicle.wire.Quotes quotes)

needsQuotes

@NotNull
protected @NotNull net.openhft.chronicle.wire.Quotes needsQuotes(@NotNull
                                                                          @NotNull CharSequence s)

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.

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.core.values.LongArrayValues 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

parseWord

public void parseWord(@NotNull
                      @NotNull StringBuilder sb)

parseUntil

public void parseUntil(@NotNull
                       @NotNull StringBuilder sb,
                       @NotNull
                       @NotNull net.openhft.chronicle.bytes.StopCharTester testers)

parseUntil

public void parseUntil(@NotNull
                       @NotNull StringBuilder sb,
                       @NotNull
                       @NotNull net.openhft.chronicle.bytes.StopCharsTester testers)

append

public void append(@NotNull
                   @NotNull CharSequence cs)

append

public void append(@NotNull
                   @NotNull CharSequence cs,
                   int offset,
                   int length)

readObject

@Nullable
public @Nullable Object readObject()

writeObject

public void writeObject(Object o)

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