Class LoopbackBytesReceiver

java.lang.Object

org.refcodes.component.AbstractConnectable

org.refcodes.io.AbstractBytesDestination

org.refcodes.io.AbstractBytesReceiver

org.refcodes.io.LoopbackBytesReceiver

All Implemented Interfaces:

Closable, Closable.CloseAutomaton, ClosedAccessor, ConnectableComponent, ConnectableComponent.ConnectableAutomaton, ConnectionComponent<LoopbackBytesTransmitter>, ConnectionComponent.ConnectionAutomaton<LoopbackBytesTransmitter>, ConnectionOpenable<LoopbackBytesTransmitter>, ConnectionOpenable.ConnectionOpenAutomaton<LoopbackBytesTransmitter>, ConnectionStatusAccessor, OpenedAccessor, Availability, ByteDestination, ByteReceiver, BytesDestination, BytesReceiver, ConnectionBytesReceiver<LoopbackBytesTransmitter>, Receivable, Skippable, TimeoutInputStreamAccessor, InputStreamAccessor

public class LoopbackBytesReceiver
extends AbstractBytesReceiver
implements ConnectionBytesReceiver<LoopbackBytesTransmitter>

A LoopbackBytesReceiver is a DatagramReceiver connected directly within the same JVM with a LoopbackBytesTransmitter; a "loopback" connection is used for establishing the connection which cannot be accessed outside the JVM or the running machine.

Nested Class Summary

Nested classes/interfaces inherited from class AbstractBytesReceiver

AbstractBytesReceiver.ConnectableAutomaton

Nested classes/interfaces inherited from interface BytesReceiver

BytesReceiver.ReceiverInputStream

Nested classes/interfaces inherited from interface Closable

Closable.CloseAutomaton, Closable.CloseBuilder<B>

Nested classes/interfaces inherited from interface ClosedAccessor

ClosedAccessor.ClosedMutator, ClosedAccessor.ClosedProperty

Nested classes/interfaces inherited from interface ConnectableComponent

ConnectableComponent.ConnectableAutomaton

Nested classes/interfaces inherited from interface ConnectionComponent

ConnectionComponent.ConnectionAutomaton<CON>, ConnectionComponent.ConnectionComponentBuilder<CON,B>

Nested classes/interfaces inherited from interface ConnectionOpenable

ConnectionOpenable.ConnectionOpenAutomaton<CON>, ConnectionOpenable.ConnectionOpenBuilder<CON,B>

Nested classes/interfaces inherited from interface ConnectionStatusAccessor

ConnectionStatusAccessor.ConnectionStatusMutator, ConnectionStatusAccessor.ConnectionStatusProperty

Nested classes/interfaces inherited from interface InputStreamAccessor

InputStreamAccessor.InputStreamBuilder<B>, InputStreamAccessor.InputStreamMutator, InputStreamAccessor.InputStreamProperty

Nested classes/interfaces inherited from interface OpenedAccessor

OpenedAccessor.OpenedMutator, OpenedAccessor.OpenedProperty

Nested classes/interfaces inherited from interface TimeoutInputStreamAccessor

TimeoutInputStreamAccessor.TimeoutInputStreamBuilder<B>, TimeoutInputStreamAccessor.TimeoutInputStreamMutator, TimeoutInputStreamAccessor.TimeoutInputStreamProperty

Field Summary

Fields inherited from class AbstractBytesReceiver

_automaton

Fields inherited from class AbstractBytesDestination

_datagramQueue, DATAGRAM_QUEUE_SIZE

Constructor Summary

Constructors

Constructor	Description
LoopbackBytesReceiver()	Instantiates a new loopback byte receiver impl.
LoopbackBytesReceiver(int aCapacity)	Instantiates a new loopback byte receiver impl.

Method Summary

Modifier and Type	Method	Description
void	close()
boolean	isOpenable(LoopbackBytesTransmitter aLoopbackSender)
void	open(LoopbackBytesTransmitter aLoopbackSender)
void	pushDatagram(byte aDatagram)	Pushes a datagram into the receiver and puts it into the blocking queue containing the so far received datagrams.
void	pushDatagrams(byte[] aDatagrams)	Pushes datagrams into the receiver and puts them into the blocking queue containing the so far received datagrams.
void	pushDatagrams(byte[] aDatagrams, int aOffset, int aLength)	Pushes datagrams into the receiver and puts them into the blocking queue containing the so far received datagrams.

Methods inherited from class AbstractBytesReceiver

available, getConnectionStatus, isClosable, isClosed, isOpenable, isOpened, open, receiveAllBytes, receiveByte, receiveBytes, setConnectionStatus

Methods inherited from class AbstractConnectable

isThrownAsOfAlreadyClosed

Methods inherited from class Object

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

Methods inherited from interface Availability

available, hasAvailable

Methods inherited from interface BytesDestination

receiveByte, receiveBytes

Methods inherited from interface BytesReceiver

getInputStream, getInputStream, receiveAllBytes, receiveBytes, receiveBytesWithin, receiveBytesWithin, receiveByteWithin, skip

Methods inherited from interface Closable

closeIn, closeQuietly, closeUnchecked

Methods inherited from interface Closable.CloseAutomaton

isClosable

Methods inherited from interface ClosedAccessor

isClosed

Methods inherited from interface ConnectionOpenable

openUnchecked

Methods inherited from interface ConnectionStatusAccessor

getConnectionStatus, isOpened

Methods inherited from interface Skippable

available, skipAvailable, skipAvailableExcept, skipAvailableTill, skipAvailableTillSilenceFor, skipAvailableTillSilenceFor, skipAvailableWithin, skipAvailableWithin, skipAvailableWithin

Constructor Details

LoopbackBytesReceiver

public LoopbackBytesReceiver()

Instantiates a new loopback byte receiver impl.

LoopbackBytesReceiver

public LoopbackBytesReceiver(int aCapacity)

Instantiates a new loopback byte receiver impl.

Parameters:

aCapacity - the capacity

Method Details

isOpenable

public boolean isOpenable(LoopbackBytesTransmitter aLoopbackSender)

Specified by:

isOpenable in interface ConnectionOpenable.ConnectionOpenAutomaton<LoopbackBytesTransmitter>

open

public void open(LoopbackBytesTransmitter aLoopbackSender)
          throws IOException

Specified by:

open in interface ConnectionOpenable<LoopbackBytesTransmitter>

Throws:

IOException

pushDatagram

public void pushDatagram(byte aDatagram)
                  throws IOException

Pushes a datagram into the receiver and puts it into the blocking queue containing the so far received datagrams. Them datagrams can be retrieved via AbstractBytesDestination.receiveByte(): Use AbstractBytesReceiver extension's AbstractBytesReceiver.available() to test beforehand whether there is a datagram available.

Overrides:

pushDatagram in class AbstractBytesDestination

Parameters:

aDatagram - The datagram to be pushed at the end of the blocking queue; to be retrieved with the AbstractBytesDestination.receiveByte() method.

Throws:

IOException - the open exception

pushDatagrams

public void pushDatagrams(byte[] aDatagrams)
                   throws IOException

Pushes datagrams into the receiver and puts them into the blocking queue containing the so far received datagrams. Them datagrams can be retrieved via AbstractBytesDestination.receiveByte(): Use AbstractBytesReceiver extension's AbstractBytesReceiver.available() to test beforehand whether there is a datagram available.

Overrides:

pushDatagrams in class AbstractBytesDestination

Parameters:

aDatagrams - The datagrams to be pushed at the end of the blocking queue; to be retrieved with the AbstractBytesDestination.receiveByte() method.

Throws:

IOException - the open exception

pushDatagrams

public void pushDatagrams(byte[] aDatagrams,
 int aOffset,
 int aLength)
                   throws IOException

Pushes datagrams into the receiver and puts them into the blocking queue containing the so far received datagrams. Them datagrams can be retrieved via AbstractBytesDestination.receiveByte(): Use AbstractBytesReceiver extension's AbstractBytesReceiver.available() to test beforehand whether there is a datagram available.

Overrides:

pushDatagrams in class AbstractBytesDestination

Parameters:

aDatagrams - The datagrams to be pushed at the end of the blocking queue; to be retrieved with the AbstractBytesDestination.receiveByte() method.

aOffset - The offset to start taking data from to be pushed.

aLength - The number of elements to be pushed from the offset onwards.

Throws:

IOException - the open exception

close

public void close()
           throws IOException

Specified by:

close in interface Closable

Overrides:

close in class AbstractBytesReceiver

Throws:

IOException