net.openhft.chronicle.wire

Class AbstractWire

java.lang.Object

net.openhft.chronicle.wire.AbstractWire

All Implemented Interfaces:

Wire, WireCommon, WireIn, WireOut

Direct Known Subclasses:

AbstractAnyWire, BinaryWire, RawWire, TextWire

public abstract class AbstractWire
extends Object
implements Wire

Created by peter on 10/03/16.

Nested Class Summary

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

WireIn.HeaderType

Field Summary

Fields

Modifier and Type	Field and Description
protected static boolean	ASSERTIONS
protected net.openhft.chronicle.bytes.Bytes<?>	bytes
protected net.openhft.chronicle.core.pool.ClassLookup	classLookup
protected Object	parent
protected boolean	use8bit

Constructor Summary

Constructors

Constructor and Description
AbstractWire(net.openhft.chronicle.bytes.Bytes bytes, boolean use8bit)

Method Summary

Modifier and Type	Method and Description
net.openhft.chronicle.bytes.Bytes<?>	bytes()
protected void	checkNoDataAfterEnd(long pos)
net.openhft.chronicle.core.pool.ClassLookup	classLookup()
void	classLookup(net.openhft.chronicle.core.pool.ClassLookup classLookup) Define how classes should be looked up.
void	clear() reset the state of the current wire for reuse.
boolean	endUse() Check the Wire was not used by another thread.
boolean	hasMore()
long	headerNumber()
Wire	headerNumber(long headerNumber)
void	headNumberCheck(HeadNumberChecker headNumberChecker)
boolean	isInsideHeader()
boolean	notCompleteIsNotPresent() If a message is marked as NOT_COMPLETE is it still present.
void	notCompleteIsNotPresent(boolean notCompleteIsNotPresent)
ObjectInput	objectInput()
ObjectOutput	objectOutput()
Object	parent() Obtain the parent class of this wire if there is one
void	parent(Object parent) Assign a parent object to this wire for later retrieval.
net.openhft.chronicle.threads.Pauser	pauser()
void	pauser(net.openhft.chronicle.threads.Pauser pauser)
void	readAndSetLength(long position)
WireIn.HeaderType	readDataHeader(boolean includeMetaData)
void	readFirstHeader(long timeout, TimeUnit timeUnit)
void	readMetaDataHeader()
boolean	startUse() Used to check that the wire is being used by only one thread
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.
void	writeEndOfWire(long timeout, TimeUnit timeUnit) Write the end of wire marker, unless one is already written.
boolean	writeFirstHeader() Start the first header, if there is none This will increment the headerNumber as appropriate if successful
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.

Methods inherited from class java.lang.Object

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

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

fromFile

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

asText, consumePadding, copyTo, getValueIn, rawReadData, read, read, read, read, readAlignTo, readAllAsMap, readComment, readDataHeader, readDocument, readDocument, readEvent, readEventName, readingDocument, readingDocument

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

addPadding, endEvent, getValueOut, padToCacheAlign, startEvent, updateHeader, write, write, write, writeAlignTo, writeAllAsMap, writeComment, writeDocument, writeEvent, writeEventName, writeEventName, writeHeader, writeNotCompleteDocument, writingDocument

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

newIntReference, newLongArrayReference, newLongReference

Field Detail

ASSERTIONS

protected static final boolean ASSERTIONS

bytes

protected final net.openhft.chronicle.bytes.Bytes<?> bytes

use8bit

protected final boolean use8bit

classLookup

protected net.openhft.chronicle.core.pool.ClassLookup classLookup

parent

protected Object parent

Constructor Detail

AbstractWire

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

Method Detail

isInsideHeader

public boolean isInsideHeader()

pauser

public net.openhft.chronicle.threads.Pauser pauser()

Specified by:

pauser in interface WireCommon

Returns:

pauser used.

pauser

public void pauser(net.openhft.chronicle.threads.Pauser pauser)

Specified by:

pauser in interface WireCommon

Parameters:

pauser - to use for blocking operations.

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

headerNumber

public Wire headerNumber(long headerNumber)

Specified by:

headerNumber in interface Wire

Specified by:

headerNumber in interface WireCommon

headNumberCheck

public void headNumberCheck(HeadNumberChecker headNumberChecker)

headerNumber

public long headerNumber()

Specified by:

headerNumber in interface WireCommon

classLookup

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

Description copied from interface: WireCommon

Define how classes should be looked up.

Specified by:

classLookup in interface WireCommon

Parameters:

classLookup - to use

classLookup

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

Specified by:

classLookup in interface WireCommon

Returns:

the current implementation for looking up classes.

bytes

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

Specified by:

bytes in interface WireCommon

Returns:

the underlying Bytes

hasMore

public boolean hasMore()

Specified by:

hasMore in interface WireIn

Returns:

if there is more data to be read in this document.

readDataHeader

public WireIn.HeaderType readDataHeader(boolean includeMetaData)
                                 throws EOFException

Specified by:

readDataHeader in interface WireIn

Throws:

EOFException

readAndSetLength

public void readAndSetLength(long position)

Specified by:

readAndSetLength in interface WireIn

readMetaDataHeader

public void readMetaDataHeader()

Specified by:

readMetaDataHeader in interface WireIn

readFirstHeader

public void readFirstHeader(long timeout,
                            TimeUnit timeUnit)
                     throws TimeoutException,
                            StreamCorruptedException

Specified by:

readFirstHeader in interface WireIn

Throws:

TimeoutException

StreamCorruptedException

writeHeader

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

Description copied from interface: WireOut

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

Specified by:

writeHeader in interface WireOut

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

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

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

Description copied from interface: WireOut

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

Specified by:

updateHeader in interface WireOut

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

checkNoDataAfterEnd

protected void checkNoDataAfterEnd(long pos)

writeFirstHeader

public boolean writeFirstHeader()

Description copied from interface: WireOut

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.

Specified by:

writeFirstHeader in interface WireOut

Returns:

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

updateFirstHeader

public void updateFirstHeader()

Description copied from interface: WireOut

update the first header after writing.

Specified by:

updateFirstHeader in interface WireOut

writeEndOfWire

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

Description copied from interface: WireOut

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

Specified by:

writeEndOfWire in interface WireOut

Parameters:

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

timeUnit - of the timeout

Throws:

TimeoutException - timeout exceeded.

parent

public Object parent()

Description copied from interface: WireCommon

Obtain the parent class of this wire if there is one

Specified by:

parent in interface WireCommon

Returns:

the parent or null if none was assigned.

parent

public void parent(Object parent)

Description copied from interface: WireCommon

Assign a parent object to this wire for later retrieval.

Specified by:

parent in interface WireCommon

Parameters:

parent - to set, or null if there isn't one.

startUse

public boolean startUse()

Description copied from interface: WireCommon

Used to check that the wire is being used by only one thread

Specified by:

startUse in interface WireCommon

Returns:

true always, so it can be used in an assert line

endUse

public boolean endUse()

Description copied from interface: WireCommon

Check the Wire was not used by another thread.

Specified by:

endUse in interface WireCommon

Returns:

true always, so it can be used in an assert line

notCompleteIsNotPresent

public boolean notCompleteIsNotPresent()

Description copied from interface: WireCommon

If a message is marked as NOT_COMPLETE is it still present.

Specified by:

notCompleteIsNotPresent in interface WireCommon

Returns:

true if NOT_COMPLETE messages can be seen, false if they cannot.

notCompleteIsNotPresent

public void notCompleteIsNotPresent(boolean notCompleteIsNotPresent)

Specified by:

notCompleteIsNotPresent in interface WireCommon

objectOutput

public ObjectOutput objectOutput()

Specified by:

objectOutput in interface WireOut

objectInput

public ObjectInput objectInput()

Specified by:

objectInput in interface WireIn