Class AbstractPrefetchInputStreamByteReceiver

java.lang.Object

org.refcodes.component.AbstractConnectable

org.refcodes.io.AbstractBytesDestination

org.refcodes.io.AbstractBytesReceiver

org.refcodes.io.AbstractPrefetchInputStreamByteReceiver

All Implemented Interfaces:

Closable, Closable.CloseAutomaton, ClosedAccessor, ConnectableComponent, ConnectableComponent.ConnectableAutomaton, ConnectionStatusAccessor, OpenedAccessor, Availability, ByteDestination, ByteReceiver, BytesDestination, BytesReceiver, Receivable, Skippable, TimeoutInputStreamAccessor, InputStreamAccessor

Direct Known Subclasses:

PrefetchBidirectionalStreamConnectionByteTransceiver, PrefetchInputStreamConnectionByteReceiver

public abstract class AbstractPrefetchInputStreamByteReceiver
extends AbstractBytesReceiver

Abstract implementation of the BytesReceiver interface. As of the prefetching functionality, a separate daemon thread (retrieved via an ExecutorService) reads from the provided InputStream and places the datagrams into a datagram queue until the datagram queue's capacity is reached. Datagrams are read by the AbstractBytesReceiver.receiveByte() (AbstractBytesReceiver.receiveAllBytes()) by them methods popping the datagrams from the datagram queue. If the queue is empty, then the AbstractBytesReceiver.receiveByte() ( AbstractBytesReceiver.receiveAllBytes()) method is blocked until the daemon thread places new datagrams into the queue.

See Also:

• AbstractBytesReceiver

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 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
AbstractPrefetchInputStreamByteReceiver()	Creates an AbstractPrefetchInputStreamByteReceiver.
AbstractPrefetchInputStreamByteReceiver(int aQueueCapacity)	Creates an AbstractPrefetchInputStreamByteReceiver using the given datagram queue capacity.
AbstractPrefetchInputStreamByteReceiver(int aQueueCapacity, ExecutorService aExecutorService)	Creates an AbstractPrefetchInputStreamByteReceiver using the given ExecutorService required for thread generation in an JEE environment.
AbstractPrefetchInputStreamByteReceiver(ExecutorService aExecutorService)	Creates an AbstractPrefetchInputStreamByteReceiver using the given ExecutorService required for thread generation in an JEE environment.

Method Summary

Modifier and Type	Method	Description
void	close()
protected boolean	isOpenable(InputStream aInputStream)	Checks if is openable.
protected void	open(InputStream aInputStream)	Open, see also ConnectionOpenable.open(Object).

Methods inherited from class AbstractBytesReceiver

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

Methods inherited from class AbstractBytesDestination

pushDatagram, pushDatagrams, pushDatagrams

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

hasAvailable

Methods inherited from interface BytesDestination

receiveBytes

Methods inherited from interface BytesReceiver

getInputStream, getInputStream, receiveBytesWithin, receiveBytesWithin, receiveByteWithin, skip

Methods inherited from interface Closable

closeIn, closeQuietly, closeUnchecked

Methods inherited from interface Skippable

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

Constructor Details

AbstractPrefetchInputStreamByteReceiver

public AbstractPrefetchInputStreamByteReceiver()

Creates an AbstractPrefetchInputStreamByteReceiver.

AbstractPrefetchInputStreamByteReceiver

public AbstractPrefetchInputStreamByteReceiver(ExecutorService aExecutorService)

Creates an AbstractPrefetchInputStreamByteReceiver using the given ExecutorService required for thread generation in an JEE environment.

Parameters:

aExecutorService - The ExecutorService to be used, when null then an ExecutorService something line Executors.newCachedThreadPool() is then retrieved.

AbstractPrefetchInputStreamByteReceiver

public AbstractPrefetchInputStreamByteReceiver(int aQueueCapacity)

Creates an AbstractPrefetchInputStreamByteReceiver using the given datagram queue capacity.

Parameters:

aQueueCapacity - The capacity of the prefetch queue before it blocks until data is read via AbstractBytesReceiver.receiveByte() ( AbstractBytesReceiver.receiveAllBytes()).

AbstractPrefetchInputStreamByteReceiver

public AbstractPrefetchInputStreamByteReceiver(int aQueueCapacity,
 ExecutorService aExecutorService)

Creates an AbstractPrefetchInputStreamByteReceiver using the given ExecutorService required for thread generation in an JEE environment.

Parameters:

aQueueCapacity - The capacity of the prefetch queue before it blocks until data is read via AbstractBytesReceiver.receiveByte() ( AbstractBytesReceiver.receiveAllBytes()).

aExecutorService - The ExecutorService to be used, when null then an ExecutorService something line Executors.newCachedThreadPool() is then retrieved.

Method Details

close

public void close()
           throws IOException

Specified by:

close in interface Closable

Overrides:

close in class AbstractBytesReceiver

Throws:

IOException

open

protected void open(InputStream aInputStream)
             throws IOException

Open, see also ConnectionOpenable.open(Object).

Parameters:

aInputStream - the input stream

Throws:

IOException - the open exception

isOpenable

protected boolean isOpenable(InputStream aInputStream)

Checks if is openable. See also ConnectionOpenable.ConnectionOpenAutomaton.isOpenable(Object).

Parameters:

aInputStream - the input stream

Returns:

true, if is openable