org.refcodes.io

Interface LoopbackByteReceiver

All Superinterfaces:

ByteBlockProvider, ByteBlockReceiver, ByteDatagramProvider, ByteDatagramReceiver, ByteProvider, ByteReceiver, org.refcodes.component.Closable, org.refcodes.component.Closable.CloseAutomaton, org.refcodes.component.ClosedAccessor, org.refcodes.component.ConnectableComponent, org.refcodes.component.ConnectableComponent.ConnectableAutomaton, ConnectionByteReceiver<LoopbackByteSender>, org.refcodes.component.ConnectionComponent<LoopbackByteSender>, org.refcodes.component.ConnectionComponent.ConnectionAutomaton<LoopbackByteSender>, org.refcodes.component.ConnectionOpenable<LoopbackByteSender>, org.refcodes.component.ConnectionOpenable.ConnectionOpenAutomaton<LoopbackByteSender>, org.refcodes.component.ConnectionStatusAccessor, org.refcodes.component.OpenedAccessor, Receivable, org.refcodes.mixin.Releaseable

All Known Implementing Classes:

LoopbackByteReceiverImpl

public interface LoopbackByteReceiver
extends ConnectionByteReceiver<LoopbackByteSender>

A LoopbackByteReceiver is a DatagramReceiver connected directly within the same JVM with a LoopbackByteSender; 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 interface org.refcodes.component.ConnectableComponent

org.refcodes.component.ConnectableComponent.ConnectableAutomaton

Nested classes/interfaces inherited from interface org.refcodes.component.OpenedAccessor

org.refcodes.component.OpenedAccessor.OpenedMutator, org.refcodes.component.OpenedAccessor.OpenedProperty

Nested classes/interfaces inherited from interface org.refcodes.component.Closable

org.refcodes.component.Closable.CloseAutomaton, org.refcodes.component.Closable.CloseBuilder<B extends org.refcodes.component.Closable.CloseBuilder<B>>

Nested classes/interfaces inherited from interface org.refcodes.component.ClosedAccessor

org.refcodes.component.ClosedAccessor.ClosedMutator, org.refcodes.component.ClosedAccessor.ClosedProperty

Nested classes/interfaces inherited from interface org.refcodes.component.ConnectionStatusAccessor

org.refcodes.component.ConnectionStatusAccessor.ConnectionStatusMutator, org.refcodes.component.ConnectionStatusAccessor.ConnectionStatusProperty

Nested classes/interfaces inherited from interface org.refcodes.component.ConnectionComponent

org.refcodes.component.ConnectionComponent.ConnectionAutomaton<CON>, org.refcodes.component.ConnectionComponent.ConnectionComponentBuilder<CON,B extends org.refcodes.component.ConnectionComponent.ConnectionComponentBuilder<CON,B>>

Nested classes/interfaces inherited from interface org.refcodes.component.ConnectionOpenable

org.refcodes.component.ConnectionOpenable.ConnectionOpenAutomaton<CON>, org.refcodes.component.ConnectionOpenable.ConnectionOpenBuilder<CON,B extends org.refcodes.component.ConnectionOpenable.ConnectionOpenBuilder<CON,B>>

Method Summary

Modifier and Type	Method and Description
void	pushDatagram(byte aDatagram) Pushes a datagram into the LoopbackByteReceiver.
default void	pushDatagrams(byte[] aDatagrams) Pushes the datagrams into the LoopbackByteReceiver.
default void	pushDatagrams(byte[] aDatagrams, int aOffset, int aLength) Pushes the according number of datagrams beginning at the given offset into the LoopbackByteReceiver.

Methods inherited from interface org.refcodes.io.ByteReceiver

readDatagrams, readDatagrams

Methods inherited from interface org.refcodes.io.ByteDatagramProvider

readDatagram

Methods inherited from interface org.refcodes.io.Receivable

hasDatagram

Methods inherited from interface org.refcodes.component.OpenedAccessor

isOpened

Methods inherited from interface org.refcodes.component.Closable.CloseAutomaton

isClosable

Methods inherited from interface org.refcodes.component.Closable

close, closeIn, closeQuietly, closeUnchecked

Methods inherited from interface org.refcodes.component.ClosedAccessor

isClosed

Methods inherited from interface org.refcodes.component.ConnectionStatusAccessor

getConnectionStatus, isConnectionOpened

Methods inherited from interface org.refcodes.mixin.Releaseable

releaseAll

Methods inherited from interface org.refcodes.component.ConnectionOpenable.ConnectionOpenAutomaton

isOpenable

Methods inherited from interface org.refcodes.component.ConnectionOpenable

open, openUnchecked

Method Detail

pushDatagram

void pushDatagram(byte aDatagram)
           throws org.refcodes.component.OpenException

Pushes a datagram into the LoopbackByteReceiver. Them datagrams can be retrieved via ByteDatagramProvider.readDatagram(): use Receivable.hasDatagram() to test beforehand whether there is a datagram available.

Parameters:

aDatagram - The datagram to be pushed into the LoopbackByteReceiver; to be retrieved with the ByteDatagramProvider.readDatagram() method.

Throws:

org.refcodes.component.OpenException - the open exception

pushDatagrams

default void pushDatagrams(byte[] aDatagrams)
                    throws org.refcodes.component.OpenException

Pushes the datagrams into the LoopbackByteReceiver. Them datagrams can be retrieved via ByteDatagramProvider.readDatagram(): use Receivable.hasDatagram() to test beforehand whether there is a datagram available.

Parameters:

aDatagrams - The datagrams to be pushed into the LoopbackByteReceiver; to be retrieved with the ByteDatagramProvider.readDatagram() method.

Throws:

org.refcodes.component.OpenException - the open exception

pushDatagrams

default void pushDatagrams(byte[] aDatagrams,
                           int aOffset,
                           int aLength)
                    throws org.refcodes.component.OpenException

Pushes the according number of datagrams beginning at the given offset into the LoopbackByteReceiver. Them datagrams can be retrieved via ByteDatagramProvider.readDatagram(): use Receivable.hasDatagram() to test beforehand whether there is a datagram available.

Parameters:

aDatagrams - The datagrams to be pushed into the LoopbackByteReceiver; to be retrieved with the ByteDatagramProvider.readDatagram() method.

aOffset - The offset from which to begin pushing.

aLength - The number of elements to be pushed.

Throws:

org.refcodes.component.OpenException - the open exception