Class BaseDecoder

java.lang.Object

org.refcodes.component.AbstractConnectable

org.refcodes.component.AbstractConnectableAutomaton

org.refcodes.codec.BaseDecoder

All Implemented Interfaces:

BaseMetricsAccessor, BaseMetricsAccessor.BaseMetricsBuilder<BaseDecoder>, BaseMetricsAccessor.BaseMetricsMutator, BaseMetricsAccessor.BaseMetricsProperty, Decoder, Closable, Closable.CloseAutomaton, ClosedAccessor, ConnectableComponent, ConnectableComponent.ConnectableAutomaton, ConnectionStatusAccessor, OpenedAccessor, Availability, ByteDestination, ByteReceiver, BytesDestination, BytesReceiver, Receivable, Skippable, TimeoutInputStreamAccessor, InputStreamAccessor

Direct Known Subclasses:

BaseDecoder.BaseDecoderConnection

public class BaseDecoder
extends AbstractConnectableAutomaton
implements BaseMetricsAccessor.BaseMetricsProperty, BaseMetricsAccessor.BaseMetricsBuilder<BaseDecoder>, Decoder

The BaseDecoder implements the BaseBuilder functionality in terms of a BytesReceiver. It implements the Decoder interface attaching to the "refcodes-io" artifact via the BytesReceiver interface. This increases the scope of usage scenarios.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	BaseDecoder.BaseDecoderConnection	The BaseDecoder.BaseDecoderConnection implements the BaseDecoder functionality in terms of a ConnectionComponent.

Nested classes/interfaces inherited from interface BaseMetricsAccessor

BaseMetricsAccessor.BaseMetricsBuilder<B>, BaseMetricsAccessor.BaseMetricsMutator, BaseMetricsAccessor.BaseMetricsProperty

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 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

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	BaseDecoder()	Explicit default constructor.
	BaseDecoder(InputStream aInputStream)	Constructs the BaseDecoder reading the data to be decoded from the provided InputStream.
	BaseDecoder(InputStream aInputStream, BaseMetrics aBaseMetrics)	Constructs the BaseDecoder reading the data to be decoded from the provided InputStream.
	BaseDecoder(BytesDestination aByteProvider)	Constructs the BaseDecoder reading the data to be decoded from the provided BytesDestination.
	BaseDecoder(BytesReceiver aByteReceiver)	Constructs the BaseDecoder reading the data to be decoded from the provided BytesReceiver.
	BaseDecoder(InputStreamByteReceiver aInputStreamByteReceiver, BaseMetrics aBaseMetrics)	Constructs the BaseDecoder reading the data to be decoded from the provided InputStreamByteReceiver.

Method Summary

Modifier and Type	Method	Description
int	available()
void	close()
BaseMetrics	getBaseMetrics()	Retrieves the base codec metrics from the base codec metrics property.
protected void	open(BytesDestination aConnection)	Open.
byte[]	receiveAllBytes()
byte	receiveByte()
void	setBaseMetrics(BaseMetrics aBaseMetrics)	Sets the base codec metrics for the base codec metrics property.
BaseDecoder	withBaseMetrics(BaseMetrics aBaseMetrics)	Sets the base codec metrics for the base codec metrics property.

Methods inherited from class AbstractConnectableAutomaton

getConnectionStatus, isClosable, isClosed, isOpenable, isOpened, open, 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

hasAvailable

Methods inherited from interface BaseMetricsAccessor.BaseMetricsProperty

letBaseMetrics

Methods inherited from interface BytesDestination

receiveBytes

Methods inherited from interface BytesReceiver

getInputStream, getInputStream, 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 ConnectionStatusAccessor

getConnectionStatus, isOpened

Methods inherited from interface Skippable

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

Constructor Details

BaseDecoder

public BaseDecoder(InputStream aInputStream)
            throws IOException

Constructs the BaseDecoder reading the data to be decoded from the provided InputStream.

Parameters:

aInputStream - the input stream

Throws:

IOException - throw in case using the InputStream caused I/O related problems.

BaseDecoder

public BaseDecoder(InputStream aInputStream,
 BaseMetrics aBaseMetrics)
            throws IOException

Constructs the BaseDecoder reading the data to be decoded from the provided InputStream.

Parameters:

aInputStream - the input stream

aBaseMetrics - The BaseMetrics to use.

Throws:

IOException - throw in case using the InputStream caused I/O related problems.

BaseDecoder

public BaseDecoder(BytesDestination aByteProvider)

Constructs the BaseDecoder reading the data to be decoded from the provided BytesDestination.

Parameters:

aByteProvider - The BytesDestination from which to read the data.

BaseDecoder

public BaseDecoder(BytesReceiver aByteReceiver)
            throws IOException

Constructs the BaseDecoder reading the data to be decoded from the provided BytesReceiver.

Parameters:

aByteReceiver - The BytesReceiver from which to read the data.

Throws:

IOException - in case opening or accessing an open line (connection, junction, link) caused problems.

BaseDecoder

public BaseDecoder(InputStreamByteReceiver aInputStreamByteReceiver,
 BaseMetrics aBaseMetrics)
            throws IOException

Constructs the BaseDecoder reading the data to be decoded from the provided InputStreamByteReceiver.

Parameters:

aInputStreamByteReceiver - The InputStreamByteReceiver to use.

aBaseMetrics - The BaseMetrics to use.

Throws:

IOException - in case opening or accessing an open line (connection, junction, link) caused problems.

BaseDecoder

protected BaseDecoder()

Explicit default constructor.

Method Details

getBaseMetrics

public BaseMetrics getBaseMetrics()

Retrieves the base codec metrics from the base codec metrics property.

Specified by:

getBaseMetrics in interface BaseMetricsAccessor

Returns:

The base codec metrics stored by the base codec metrics property.

setBaseMetrics

public void setBaseMetrics(BaseMetrics aBaseMetrics)

Sets the base codec metrics for the base codec metrics property.

Specified by:

setBaseMetrics in interface BaseMetricsAccessor.BaseMetricsMutator

Parameters:

aBaseMetrics - The base codec metrics to be stored by the font style property.

withBaseMetrics

public BaseDecoder withBaseMetrics(BaseMetrics aBaseMetrics)

Sets the base codec metrics for the base codec metrics property.

Specified by:

withBaseMetrics in interface BaseMetricsAccessor.BaseMetricsBuilder<BaseDecoder>

Parameters:

aBaseMetrics - The base codec metrics to be stored by the font style property.

Returns:

The builder for applying multiple build operations.

available

public int available()
              throws IOException

Specified by:

available in interface Availability

Specified by:

available in interface Skippable

Throws:

IOException

receiveAllBytes

public byte[] receiveAllBytes()
                       throws IOException

Specified by:

receiveAllBytes in interface BytesDestination

Specified by:

receiveAllBytes in interface BytesReceiver

Throws:

IOException

receiveByte

public byte receiveByte()
                 throws IOException

Specified by:

receiveByte in interface ByteDestination

Specified by:

receiveByte in interface BytesDestination

Throws:

IOException

close

public void close()
           throws IOException

Specified by:

close in interface Closable

Overrides:

close in class AbstractConnectableAutomaton

Throws:

IOException

open

protected void open(BytesDestination aConnection)
             throws IOException

Open.

Parameters:

aConnection - the connection

Throws:

IOException - the open exception