Class LoopbackPort

java.lang.Object

org.refcodes.component.ConnectionAutomatonImpl<PortMetrics>

org.refcodes.serial.AbstractPort<PortMetrics>

org.refcodes.serial.LoopbackPort

All Implemented Interfaces:

Flushable, Comparable<Port<?>>, Closable, Closable.CloseAutomaton, ClosedAccessor, ConnectableComponent, ConnectableComponent.ConnectableAutomaton, ConnectionComponent<PortMetrics>, ConnectionComponent.ConnectionAutomaton<PortMetrics>, ConnectionOpenable<PortMetrics>, ConnectionOpenable.ConnectionOpenAutomaton<PortMetrics>, ConnectionOpenable.ConnectionOpenBuilder<PortMetrics, Port<PortMetrics>>, ConnectionStatusAccessor, Flushable, LinkComponent, LinkComponent.LinkAutomaton, Openable, Openable.OpenAutomaton, Openable.OpenBuilder<Port<PortMetrics>>, OpenedAccessor, Availability, ByteDestination, ByteReceiver, BytesDestination, ByteSource, BytesReceiver, BytesSource, BytesTransceiver, BytesTransmitter, ByteTransceiver, ByteTransmitter, Receivable, Skippable, TimeoutInputStreamAccessor, Transmittable, AliasAccessor, InputStreamAccessor, OutputStreamAccessor, Port<PortMetrics>, PortMetricsAccessor<PortMetrics>, SegmentDestination, SegmentReceiver, SegmentSource, SegmentTransceiver, SegmentTransmitter, SerialReceiver, SerialTransceiver, SerialTransmitter

Direct Known Subclasses:

CrossoverLoopbackPort

public class LoopbackPort
extends AbstractPort<PortMetrics>

The LoopbackPort is an in-memory implementation of a Port which loops its output directly back to its input. This is suitable for straight forward cases where data is first transmitted to be received in the next step by the same Port. For cases using a some kind of frequent handshake between a transmitter and a receiver on the same line please use the CrossoverLoopbackPort as counterpart of a LoopbackPort for simulating a bidirectional in-memory communication between these two ports.

Nested Class Summary

Nested classes/interfaces inherited from interface AliasAccessor

AliasAccessor.AliasBuilder<B>, AliasAccessor.AliasMutator, AliasAccessor.AliasProperty

Nested classes/interfaces inherited from interface BytesReceiver

BytesReceiver.ReceiverInputStream

Nested classes/interfaces inherited from interface BytesTransmitter

BytesTransmitter.TransmitterOutputStream

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 Flushable

Flushable.FlushBuilder<B>

Nested classes/interfaces inherited from interface InputStreamAccessor

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

Nested classes/interfaces inherited from interface LinkComponent

LinkComponent.LinkAutomaton, LinkComponent.LinkComponentBuilder<B>

Nested classes/interfaces inherited from interface Openable

Openable.OpenAutomaton, Openable.OpenBuilder<B>

Nested classes/interfaces inherited from interface OpenedAccessor

OpenedAccessor.OpenedMutator, OpenedAccessor.OpenedProperty

Nested classes/interfaces inherited from interface OutputStreamAccessor

OutputStreamAccessor.OutputStreamBuilder<B>, OutputStreamAccessor.OutputStreamMutator, OutputStreamAccessor.OutputStreamProperty

Nested classes/interfaces inherited from interface PortMetricsAccessor

PortMetricsAccessor.PortMetricsBuilder<PM,B>, PortMetricsAccessor.PortMetricsMutator<PM>, PortMetricsAccessor.PortMetricsProperty<PM>

Nested classes/interfaces inherited from interface TimeoutInputStreamAccessor

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

Field Summary

Fields

Modifier and Type	Field	Description
protected LoopbackPort	_crossoverPort
protected ByteArraySequence	_transmitSequence

Fields inherited from class AbstractPort

_alias, _executorService, _portMetrics

Fields inherited from class ConnectionAutomatonImpl

_connectionComponent

Constructor Summary

Constructors

Constructor	Description
LoopbackPort(String aAlias)	Constructs a LoopbackPort.
LoopbackPort(String aAlias, ExecutorService aExecutorService)	Instantiates the class LoopbackPort.

Method Summary

Modifier and Type	Method	Description
int	available()	Returns the number of bytes which can be read directly e.g. which are already been stored in an internal buffer.
void	close()	Attention: Implementations of this method should do a Object.notifyAll() in order to terminate any pending asynchronous operations such as SegmentReceiver.onReceiveSegment(Segment) or SegmentReceiver.onReceiveSegment(Segment, SegmentConsumer).
String	getAlias()	Returns the unambiguous technical name of the TTY-/COM-Port.
PortMetrics	getPortMetrics()	Retrieves the PortMetrics from the PortMetrics property.
void	open()	Attention: Implementations of this method should do a Object.notifyAll() in order to terminate any pending asynchronous operations such as SegmentReceiver.onReceiveSegment(Segment) or SegmentReceiver.onReceiveSegment(Segment, SegmentConsumer).
void	receiveBytes(byte[] aBuffer, int aOffset, int aLength)
protected void	setCrossoverPort(LoopbackPort aPort)	Hook to set a crossover loopback port in order to attach a LoopbackPort to the other end of the wire and transform a loopback device into two crossover loopback devices.
String	toString()
void	transmitSequence(Sequence aSequence)	Transmits a Sequence (and blocks this thread) till all it's data has been sent.
LoopbackPort	withOpen()
LoopbackPort	withOpen(PortMetrics aPortMetrics)
LoopbackPort	withOpenUnchecked()
LoopbackPort	withOpenUnchecked(PortMetrics aPortMetrics)

Methods inherited from class AbstractPort

doTransmitSegment, doTransmitSegment, isOpenable, onReceiveSegment, onReceiveSegment, open, receiveSegment

Methods inherited from class ConnectionAutomatonImpl

getConnectionStatus, isClosable, isClosed, isOpenable, isOpened

Methods inherited from class Object

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

Methods inherited from interface Availability

hasAvailable

Methods inherited from interface BytesReceiver

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

Methods inherited from interface BytesSource

transmitByte

Methods inherited from interface BytesTransmitter

getOutputStream

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 ConnectionOpenable.ConnectionOpenAutomaton

isOpenable

Methods inherited from interface ConnectionStatusAccessor

getConnectionStatus, isOpened

Methods inherited from interface Flushable

flushUnchecked, isFlushable

Methods inherited from interface Openable

openUnchecked

Methods inherited from interface Port

compareTo

Methods inherited from interface SegmentTransmitter

flush

Methods inherited from interface SerialReceiver

receiveByte, receiveBytes, receiveSegmentWithin, receiveSequence, receiveSequenceWithin

Methods inherited from interface SerialTransceiver

transmitSegment

Methods inherited from interface SerialTransmitter

flush, transmitBytes, transmitBytes, transmitSequence

Methods inherited from interface Skippable

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

Field Details

_transmitSequence

protected ByteArraySequence _transmitSequence

_crossoverPort

protected LoopbackPort _crossoverPort

Constructor Details

LoopbackPort

public LoopbackPort(String aAlias)

Constructs a LoopbackPort.

Parameters:

aAlias - The alias to use for this port.

LoopbackPort

public LoopbackPort(String aAlias,
 ExecutorService aExecutorService)

Instantiates the class LoopbackPort.

Parameters:

aAlias - the alias

aExecutorService - the executor service

See Also:

• AbstractPort(String, PortMetrics, ExecutorService)

Method Details

transmitSequence

public void transmitSequence(Sequence aSequence)
                      throws IOException

Transmits a Sequence (and blocks this thread) till all it's data has been sent.

Parameters:

aSequence - The Sequence containing the data to be send.

Throws:

IOException - thrown in case of I/O issues (e.g. a timeout) while sending

receiveBytes

public void receiveBytes(byte[] aBuffer,
 int aOffset,
 int aLength)
                  throws IOException

Throws:

IOException

getPortMetrics

public PortMetrics getPortMetrics()

Retrieves the PortMetrics from the PortMetrics property.

Returns:

The PortMetrics stored by the PortMetrics property.

getAlias

public String getAlias()

Returns the unambiguous technical name of the TTY-/COM-Port.

Specified by:

getAlias in interface AliasAccessor

Overrides:

getAlias in class AbstractPort<PortMetrics>

Returns:

The port's name.

available

public int available()

Returns the number of bytes which can be read directly e.g. which are already been stored in an internal buffer. May return (0 or) a value less than 0 (-1) when it is not supported. Similar to InputStream.available(): "Returns an estimate of the number of bytes that can be read (or skipped over) from this input stream without blocking by the next invocation of a method for this input stream. The next invocation might be the same thread or another thread. A single read or skip of this many bytes will not block, but may read or skip fewer bytes. Note that while some implementations of InputStream will return the total number of bytes in the stream, many will not. It is never correct to use the return value of this method to allocate a buffer intended to hold all data in this stream. A subclass' implementation of this method may choose to throw an IOException if this input stream has been closed by invoking the close() method. The available method for class InputStream always returns 0. This method should be overridden by subclasses."

Returns:

The number of available bytes: An estimate of the number of bytes that can be read (or skipped over) from this input stream without blocking or 0 when it reaches the end of the input stream. Throws:

open

public void open()
          throws IOException

Attention: Implementations of this method should do a Object.notifyAll() in order to terminate any pending asynchronous operations such as SegmentReceiver.onReceiveSegment(Segment) or SegmentReceiver.onReceiveSegment(Segment, SegmentConsumer).

Specified by:

open in interface Openable

Specified by:

open in interface SerialReceiver

Overrides:

open in class AbstractPort<PortMetrics>

Throws:

IOException

close

public void close()
           throws IOException

Attention: Implementations of this method should do a Object.notifyAll() in order to terminate any pending asynchronous operations such as SegmentReceiver.onReceiveSegment(Segment) or SegmentReceiver.onReceiveSegment(Segment, SegmentConsumer).

Specified by:

close in interface Closable

Specified by:

close in interface SerialReceiver

Overrides:

close in class AbstractPort<PortMetrics>

Throws:

IOException

withOpen

public LoopbackPort withOpen()
                      throws IOException

Throws:

IOException

withOpen

public LoopbackPort withOpen(PortMetrics aPortMetrics)
                      throws IOException

Throws:

IOException

withOpenUnchecked

public LoopbackPort withOpenUnchecked()

withOpenUnchecked

public LoopbackPort withOpenUnchecked(PortMetrics aPortMetrics)

toString

public String toString()

Overrides:

toString in class Object

setCrossoverPort

protected void setCrossoverPort(LoopbackPort aPort)

Hook to set a crossover loopback port in order to attach a LoopbackPort to the other end of the wire and transform a loopback device into two crossover loopback devices.

Parameters:

aPort - The LoopbackPort to act as the crossover loopback device at the other end of the wire.