- java.lang.Object
-
- org.refcodes.serial.AbstractMagicBytesTransmissionMultiplexer<Segment>
-
- org.refcodes.serial.MagicBytesSegmentMultiplexer
-
- All Implemented Interfaces:
Serializable
,Iterable<Segment>
,org.refcodes.mixin.ChildrenAccessor<Segment[]>
,org.refcodes.mixin.LengthAccessor
,Segment
,Transmission
public class MagicBytesSegmentMultiplexer extends AbstractMagicBytesTransmissionMultiplexer<Segment> implements Segment, Iterable<Segment>, org.refcodes.mixin.ChildrenAccessor<Segment[]>
THeMagicBytesSegmentMultiplexer
dispatches a transmission to one of the aggregatedSegment
instances depending on the magic number provided by the transmission. A transmission is passed to each of the aggregatedSegment
instances till oneSegment
accepts the transmission, e.g. until aSegment
does not throw aBadMagicBytesException
. To enforce throwing aBadMagicBytesException
use a magic bytesSegment
orSection
which enforces the magic bytes to of a transmission to match its own magic bytes, e.e. use one of the following:AssertMagicBytesSectionDecorator
,AssertMagicBytesSegment
,AssertMagicBytesSegmentDecorator
Attention: ASegment
throwing aTransmissionException
other than aBadMagicBytesException
is considered to be responsible for the transmission so that dispatching is *not* continued with the succeedingSegment
! The lastSegment
which was responsible for a transmission's magic bytes will be the responsibleSegment
till anotherSegment
claims responsibility for a transmsision's magic bytes. Initially the firstSegment
passed to this instance is the responsibleSegment
.- See Also:
- Serialized Form
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from interface org.refcodes.mixin.ChildrenAccessor
org.refcodes.mixin.ChildrenAccessor.ChildrenBuilder<T extends Object,B extends org.refcodes.mixin.ChildrenAccessor.ChildrenBuilder<T,B>>, org.refcodes.mixin.ChildrenAccessor.ChildrenMutator<T extends Object>, org.refcodes.mixin.ChildrenAccessor.ChildrenProperty<T extends Object>
-
Nested classes/interfaces inherited from interface org.refcodes.mixin.LengthAccessor
org.refcodes.mixin.LengthAccessor.LengthBuilder<B extends org.refcodes.mixin.LengthAccessor.LengthBuilder<B>>, org.refcodes.mixin.LengthAccessor.LengthMutator, org.refcodes.mixin.LengthAccessor.LengthProperty
-
Nested classes/interfaces inherited from interface org.refcodes.serial.Segment
Segment.SegmentMixin
-
Nested classes/interfaces inherited from interface org.refcodes.serial.Transmission
Transmission.TransmissionMixin
-
-
Field Summary
-
Fields inherited from class org.refcodes.serial.AbstractMagicBytesTransmissionMultiplexer
_children, _readLimit, _responsibility, DEFAULT_READ_LIMIT
-
-
Constructor Summary
Constructors Constructor Description MagicBytesSegmentMultiplexer()
MagicBytesSegmentMultiplexer(int aReadLimit, Segment... aSegments)
MagicBytesSegmentMultiplexer(Collection<Segment> aSegments)
MagicBytesSegmentMultiplexer(Collection<Segment> aSegments, int aReadLimit)
MagicBytesSegmentMultiplexer(Segment... aSegments)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description int
fromTransmission(byte[] aChunk)
(Re-)initializes this instance with the the given byte array data.int
fromTransmission(byte[] aChunk, int aOffset)
(Re-)initializes this instance with the the given byte array data.int
fromTransmission(Sequence aSequence)
(Re-)initializes this instance with the the givenSequence
data.int
fromTransmission(Sequence aSequence, int aOffset)
(Re-)initializes this instance with the the givenSequence
data.void
receiveFrom(InputStream aInputStream)
(Re-)initializes this instance by receiving the accordingSequence
from the givenInputStream
.void
receiveFrom(InputStream aInputStream, OutputStream aReturnStream)
(Re-)initializes this instance by receiving the accordingSequence
from the givenInputStream
.void
receiveFrom(SerialTransceiver aSerialTransceiver)
(Re-)initializes this instance by receiving the accordingSequence
from the givenSerialTransceiver
'sInputStream
.-
Methods inherited from class org.refcodes.serial.AbstractMagicBytesTransmissionMultiplexer
getCallee, getChildren, getLength, iterator, toSchema, toSequence, toSimpleTypeMap, transmitTo, transmitTo, transmitTo
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface java.lang.Iterable
forEach, iterator, spliterator
-
Methods inherited from interface org.refcodes.serial.Transmission
getLength, toSchema, toSequence, toSimpleTypeMap, transmitTo, transmitTo, transmitTo
-
-
-
-
Constructor Detail
-
MagicBytesSegmentMultiplexer
public MagicBytesSegmentMultiplexer()
-
MagicBytesSegmentMultiplexer
public MagicBytesSegmentMultiplexer(Collection<Segment> aSegments, int aReadLimit)
-
MagicBytesSegmentMultiplexer
public MagicBytesSegmentMultiplexer(Collection<Segment> aSegments)
-
MagicBytesSegmentMultiplexer
public MagicBytesSegmentMultiplexer(int aReadLimit, Segment... aSegments)
-
MagicBytesSegmentMultiplexer
public MagicBytesSegmentMultiplexer(Segment... aSegments)
-
-
Method Detail
-
fromTransmission
public int fromTransmission(byte[] aChunk) throws TransmissionException
(Re-)initializes this instance with the the given byte array data.- Specified by:
fromTransmission
in interfaceSegment
- Parameters:
aChunk
- The byte array data from which to (re-)initialize this instance.- Returns:
- The index after the last offset into the given byte array processed by this method.
- Throws:
TransmissionException
- thrown in case a givenSequence
cannot be processed.
-
fromTransmission
public int fromTransmission(Sequence aSequence) throws TransmissionException
(Re-)initializes this instance with the the givenSequence
data.- Specified by:
fromTransmission
in interfaceSegment
- Parameters:
aSequence
- TheSequence
data from which to (re-)initialize this instance.- Returns:
- The index after the last offset into the given
Sequence
processed by this method. - Throws:
TransmissionException
- thrown in case a givenSequence
cannot be processed.
-
fromTransmission
public int fromTransmission(byte[] aChunk, int aOffset) throws TransmissionException
(Re-)initializes this instance with the the given byte array data.- Specified by:
fromTransmission
in interfaceSegment
- Parameters:
aChunk
- The byte array data from which to (re-)initialize this instance.aOffset
- The offset where to start processing the provided byte array.- Returns:
- The index after the last offset into the given byte array processed by this method.
- Throws:
TransmissionException
- thrown in case a givenSequence
cannot be processed.
-
receiveFrom
public void receiveFrom(InputStream aInputStream) throws IOException, TransmissionException
(Re-)initializes this instance by receiving the accordingSequence
from the givenInputStream
. This is a convenience method in case there is no feedbackOutputStream
available (actually theSegment.receiveFrom(InputStream, OutputStream )
method is invoked withnull
for the feedbackOutputStream
). OverrideSegment.receiveFrom(InputStream, OutputStream)
for your custom receiving functionality.- Specified by:
receiveFrom
in interfaceSegment
- Parameters:
aInputStream
- TheInputStream
from which to read the instance's (re-)initializationSequence
from.- Throws:
IOException
- thrown in case reading data from theInputStream
caused problems.TransmissionException
- thrown in case a given transmission cannot be processed.
-
receiveFrom
public void receiveFrom(SerialTransceiver aSerialTransceiver) throws IOException, TransmissionException
(Re-)initializes this instance by receiving the accordingSequence
from the givenSerialTransceiver
'sInputStream
. Implementations providing error correction methods use the providedSerialTransceiver
's feedbackOutputStream
to do some sort of "stop-and-wait ARQ" or apply similar methods to ensure correctness of the received data. This is a convenience method (actually theSegment.receiveFrom(InputStream, OutputStream )
method is invoked). OverrideSegment.receiveFrom(InputStream, OutputStream)
for your custom receiving functionality.- Specified by:
receiveFrom
in interfaceSegment
- Parameters:
aSerialTransceiver
- TheSerialTransceiver
providing theInputStream
where to read this instance'sSequence
from and providing theOutputStream
being the feedback channel to handle "stop-and-wait ARQ".- Throws:
IOException
- thrown in case reading data from theInputStream
caused problems.TransmissionException
- thrown in case a given transmission cannot be processed.
-
fromTransmission
public int fromTransmission(Sequence aSequence, int aOffset) throws TransmissionException
(Re-)initializes this instance with the the givenSequence
data.- Specified by:
fromTransmission
in interfaceSegment
- Parameters:
aSequence
- TheSequence
data from which to (re-)initialize this instance.aOffset
- The offset where to start processing the providedSequence
.- Returns:
- The index after the last offset into the given
Sequence
processed by this method. - Throws:
TransmissionException
- thrown in case a givenSequence
cannot be processed.
-
receiveFrom
public void receiveFrom(InputStream aInputStream, OutputStream aReturnStream) throws IOException, TransmissionException
(Re-)initializes this instance by receiving the accordingSequence
from the givenInputStream
. Implementations providing error correction methods use the provided feedbackOutputStream
to do some sort of "stop-and-wait ARQ" or apply similar methods to ensure correctness of the received data.- Specified by:
receiveFrom
in interfaceSegment
- Parameters:
aInputStream
- TheInputStream
from which to read the instance's (re-)initializationSequence
from.aReturnStream
- AnOutputStream
being the return channel to handle "stop-and-wait ARQ" or the like in case of a bidirectional connection. Can be null in case we have a unidirectional connection.- Throws:
IOException
- thrown in case reading data from theInputStream
caused problems.TransmissionException
- thrown in case a given transmission cannot be processed.
-
-