net.openhft.chronicle.wire

Interface WireOut

All Superinterfaces:

WireCommon

All Known Subinterfaces:

Wire

All Known Implementing Classes:

AbstractAnyWire, AbstractWire, BinaryWire, CSVWire, DeferredTypeWire, HashWire, JSONWire, QueryWire, RawWire, ReadAnyWire, TextWire

public interface WireOut
extends WireCommon

The defines the stand interface for writing and reading sequentially to/from a Bytes stream.

Created by peter.lawrey on 12/01/15.

Method Summary

Modifier and Type	Method and Description
WireOut	addPadding(int paddingToAdd)
void	clear() This will reset the positions and the header number.
default WireOut	dropDefault(boolean dropDefault)
void	endEvent()
ValueOut	getValueOut() Obtain the value out
ObjectOutput	objectOutput()
default WireOut	padToCacheAlign() If near the end of a cache line, pad it so a following 4-byte int value will not split a cache line.
void	startEvent() Start an event object, mostly for internal use.
void	updateFirstHeader() update the first header after writing.
void	updateHeader(int length, long position, boolean metaData) Change the header from NOT_COMPLETE | length to metaData * META_DATA | length.
default void	updateHeader(long position, boolean metaData) Change the header from NOT_COMPLETE | UNKNOWN_LENGTH to metaData * META_DATA | length.
ValueOut	write() Write an empty filed marker
ValueOut	write(CharSequence key)
ValueOut	write(WireKey key) Write a key for wires that support fields.
default WireOut	writeAlignTo(int alignment, int plus)
default <K,V> void	writeAllAsMap(Class<K> kClass, Class<V> vClass, Map<K,V> map)
WireOut	writeComment(CharSequence s)
default void	writeDocument(boolean metaData, WriteMarshallable writer) This will increment the headerNumber as appropriate if successful
void	writeEndOfWire(long timeout, TimeUnit timeUnit, long lastPosition) Write the end of wire marker, unless one is already written.
default ValueOut	writeEvent(Class expectedType, Object eventKey)
default ValueOut	writeEventName(CharSequence key)
default ValueOut	writeEventName(WireKey key) Always write a key.
boolean	writeFirstHeader() Start the first header, if there is none This will increment the headerNumber as appropriate if successful
long	writeHeader(int length, int safeLength, long timeout, TimeUnit timeUnit, net.openhft.chronicle.core.values.LongValue lastPosition)
default long	writeHeader(int length, long timeout, TimeUnit timeUnit, net.openhft.chronicle.core.values.LongValue lastPosition) Write a message of a known length, handling timeouts and the end of wire marker.
default long	writeHeader(long timeout, TimeUnit timeUnit, net.openhft.chronicle.core.values.LongValue lastPosition) Write a new header, an unknown length, handling timeouts and the end of wire marker.
default void	writeNotCompleteDocument(boolean metaData, WriteMarshallable writer) This will increment the headerNumber as appropriate if successful
default DocumentContext	writingDocument()
DocumentContext	writingDocument(boolean metaData) This will increment the headerNumber as appropriate if successful

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

bytes, classLookup, classLookup, endUse, headerNumber, headerNumber, newIntReference, newLongArrayReference, newLongReference, notCompleteIsNotPresent, notCompleteIsNotPresent, parent, parent, pauser, pauser, startUse

Method Detail

write

@NotNull
ValueOut write()

Write an empty filed marker

writeEventName

@NotNull
default ValueOut writeEventName(WireKey key)

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

writeEventName

default ValueOut writeEventName(CharSequence key)

writeEvent

default ValueOut writeEvent(Class expectedType,
                            Object eventKey)

write

@NotNull
ValueOut write(WireKey key)

Write a key for wires that support fields.

write

ValueOut write(CharSequence key)

getValueOut

@NotNull
ValueOut getValueOut()

Obtain the value out

objectOutput

ObjectOutput objectOutput()

writeComment

@NotNull
WireOut writeComment(CharSequence s)

addPadding

@NotNull
WireOut addPadding(int paddingToAdd)

padToCacheAlign

@NotNull
default WireOut padToCacheAlign()

If near the end of a cache line, pad it so a following 4-byte int value will not split a cache line.

Returns:

this

writeAlignTo

@NotNull
default WireOut writeAlignTo(int alignment,
                                      int plus)

clear

void clear()

This will reset the positions and the header number.

Specified by:

clear in interface WireCommon

writeDocument

default void writeDocument(boolean metaData,
                           @NotNull
                           WriteMarshallable writer)

This will increment the headerNumber as appropriate if successful

Parameters:

metaData -

writer -

writingDocument

DocumentContext writingDocument(boolean metaData)

This will increment the headerNumber as appropriate if successful

Parameters:

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

Returns:

a document context used for witting

writingDocument

default DocumentContext writingDocument()

writeNotCompleteDocument

default void writeNotCompleteDocument(boolean metaData,
                                      @NotNull
                                      WriteMarshallable writer)

This will increment the headerNumber as appropriate if successful

Parameters:

metaData - true if the write should write metaData rather than data

writer - writes bytes to the wire

writeHeader

default long writeHeader(long timeout,
                         TimeUnit timeUnit,
                         @Nullable
                         net.openhft.chronicle.core.values.LongValue lastPosition)
                  throws TimeoutException,
                         EOFException

Write a new header, an unknown length, handling timeouts and the end of wire marker. This will increment the headerNumber as appropriate if successful

Parameters:

timeout - throw a TimeoutException if the header could not be written in this time.

timeUnit - of the timeOut

lastPosition - the last known position

Returns:

the position of the start of the header

Throws:

TimeoutException - the underlying pauser timed out.

EOFException - the end of wire marker was reached.

updateHeader

default void updateHeader(long position,
                          boolean metaData)
                   throws StreamCorruptedException

Change the header from NOT_COMPLETE | UNKNOWN_LENGTH to metaData * META_DATA | length.

Parameters:

position - returned by writeHeader

metaData - whether the message is meta data or not.

Throws:

StreamCorruptedException - if the steam has become corrupted

writeHeader

default long writeHeader(int length,
                         long timeout,
                         TimeUnit timeUnit,
                         @Nullable
                         net.openhft.chronicle.core.values.LongValue lastPosition)
                  throws TimeoutException,
                         EOFException

Write a message of a known length, handling timeouts and the end of wire marker. This will increment the headerNumber as appropriate if successful

Parameters:

length - the maximum length of the message.

timeout - throw a TimeoutException if the header could not be written in this time.

timeUnit - of the timeOut

lastPosition - the last known position

Returns:

the position of the start of the header

Throws:

TimeoutException - the underlying pauser timed out.

EOFException - the end of wire marker was reached.

writeHeader

long writeHeader(int length,
                 int safeLength,
                 long timeout,
                 TimeUnit timeUnit,
                 @Nullable
                 net.openhft.chronicle.core.values.LongValue lastPosition)
          throws TimeoutException,
                 EOFException

Throws:

TimeoutException

EOFException

updateHeader

void updateHeader(int length,
                  long position,
                  boolean metaData)
           throws StreamCorruptedException

Change the header from NOT_COMPLETE | length to metaData * META_DATA | length.

Parameters:

length - provided to make the header, note this can be larger than the message actually used.

position - returned by writeHeader

metaData - whether the message is meta data or not.

Throws:

StreamCorruptedException - if the steam has become corrupted

writeFirstHeader

boolean writeFirstHeader()

Start the first header, if there is none This will increment the headerNumber as appropriate if successful

Note: the file might contain other data and the caller has to check this.

Returns:

true if the header needs to be written, false if there is a data already

updateFirstHeader

void updateFirstHeader()

update the first header after writing.

writeEndOfWire

void writeEndOfWire(long timeout,
                    TimeUnit timeUnit,
                    long lastPosition)
             throws TimeoutException

Write the end of wire marker, unless one is already written. This will increment the headerNumber as appropriate if successful

Parameters:

timeout - throw TimeoutException if it could not write the marker in time.

timeUnit - of the timeout

lastPosition - the end of the wire

Throws:

TimeoutException - timeout exceeded.

startEvent

void startEvent()

Start an event object, mostly for internal use.

endEvent

void endEvent()

writeAllAsMap

default <K,V> void writeAllAsMap(Class<K> kClass,
                                 Class<V> vClass,
                                 @NotNull
                                 Map<K,V> map)

dropDefault

default WireOut dropDefault(boolean dropDefault)