Class BaseEncoder

java.lang.Object

org.refcodes.component.AbstractConnectable

org.refcodes.component.AbstractConnectableAutomaton

org.refcodes.codec.BaseEncoder

All Implemented Interfaces:

Flushable, BaseMetricsAccessor, BaseMetricsAccessor.BaseMetricsBuilder<BaseEncoder>, BaseMetricsAccessor.BaseMetricsMutator, BaseMetricsAccessor.BaseMetricsProperty, Encoder, Closable, Closable.CloseAutomaton, ClosedAccessor, ConnectableComponent, ConnectableComponent.ConnectableAutomaton, ConnectionStatusAccessor, Flushable, OpenedAccessor, ByteSource, BytesSource, BytesTransmitter, ByteTransmitter, Transmittable, OutputStreamAccessor

Direct Known Subclasses:

BaseEncoder.BaseEncoderConnection

public class BaseEncoder
extends AbstractConnectableAutomaton
implements BaseMetricsAccessor.BaseMetricsProperty, BaseMetricsAccessor.BaseMetricsBuilder<BaseEncoder>, Encoder

The BaseEncoder implements the BaseBuilder functionality in terms of a BytesTransmitter.

Make sure to call close() when done as the final padding bytes are appended to the end!

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	BaseEncoder.BaseEncoderConnection	The BaseEncoder.BaseEncoderConnection implements the BaseEncoder 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 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 ConnectionStatusAccessor

ConnectionStatusAccessor.ConnectionStatusMutator, ConnectionStatusAccessor.ConnectionStatusProperty

Nested classes/interfaces inherited from interface Flushable

Flushable.FlushBuilder<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

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	BaseEncoder()	Explicit default constructor.
	BaseEncoder(OutputStream aOutputStream)	Constructs the BaseEncoder instance using the provided OutputStream to receive the encoded data.
	BaseEncoder(OutputStream aOutputStream, BaseMetrics aBaseMetrics)	Constructs the BaseEncoder instance using the provided OutputStream to receive the encoded data.
	BaseEncoder(BytesSource aByteConsumer)	Constructs the BaseEncoder instance using the provided BytesSource to receive the encoded data.
	BaseEncoder(BytesTransmitter aByteSender)	Constructs the BaseEncoder instance using the provided BytesTransmitter to receive the encoded data.
	BaseEncoder(OutputStreamBytesTransmitter aOutputStreamBytesTransmitter, BaseMetrics aBaseMetrics)	Constructs the BaseEncoder instance using the provided OutputStreamBytesTransmitter to receive the encoded data.

Method Summary

Modifier and Type	Method	Description
void	close()
void	flush()
BaseMetrics	getBaseMetrics()	Retrieves the base codec metrics from the base codec metrics property.
protected void	open(BytesSource aConnection)	Open.
void	setBaseMetrics(BaseMetrics aBaseMetrics)	Sets the base codec metrics for the base codec metrics property.
void	transmitByte(byte aByte)
void	transmitBytes(byte[] aDatagram)
void	transmitBytes(byte[] aDatagram, int aOffset, int aLength)
BaseEncoder	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 BaseMetricsAccessor.BaseMetricsProperty

letBaseMetrics

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 ConnectionStatusAccessor

getConnectionStatus, isOpened

Methods inherited from interface Flushable

flushUnchecked, isFlushable

Constructor Details

BaseEncoder

public BaseEncoder(OutputStream aOutputStream)
            throws IOException

Constructs the BaseEncoder instance using the provided OutputStream to receive the encoded data.

Parameters:

aOutputStream - the output stream

Throws:

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

BaseEncoder

public BaseEncoder(OutputStream aOutputStream,
 BaseMetrics aBaseMetrics)
            throws IOException

Constructs the BaseEncoder instance using the provided OutputStream to receive the encoded data.

Parameters:

aOutputStream - the output stream

aBaseMetrics - The BaseMetrics to use.

Throws:

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

BaseEncoder

public BaseEncoder(BytesSource aByteConsumer)

Constructs the BaseEncoder instance using the provided BytesSource to receive the encoded data.

Parameters:

aByteConsumer - The BytesSource to be fed with the encoded data.

BaseEncoder

public BaseEncoder(BytesTransmitter aByteSender)
            throws IOException

Constructs the BaseEncoder instance using the provided BytesTransmitter to receive the encoded data.

Parameters:

aByteSender - The BytesTransmitter to be fed with the encoded data.

Throws:

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

BaseEncoder

public BaseEncoder(OutputStreamBytesTransmitter aOutputStreamBytesTransmitter,
 BaseMetrics aBaseMetrics)
            throws IOException

Constructs the BaseEncoder instance using the provided OutputStreamBytesTransmitter to receive the encoded data.

Parameters:

aOutputStreamBytesTransmitter - The OutputStreamBytesTransmitter to use.

aBaseMetrics - The BaseMetrics to use.

Throws:

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

BaseEncoder

protected BaseEncoder()

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 BaseEncoder withBaseMetrics(BaseMetrics aBaseMetrics)

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

Specified by:

withBaseMetrics in interface BaseMetricsAccessor.BaseMetricsBuilder<BaseEncoder>

Parameters:

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

Returns:

The builder for applying multiple build operations.

transmitByte

public void transmitByte(byte aByte)
                  throws IOException

Specified by:

transmitByte in interface ByteSource

Specified by:

transmitByte in interface BytesSource

Throws:

IOException

transmitBytes

public void transmitBytes(byte[] aDatagram)
                   throws IOException

Specified by:

transmitBytes in interface BytesSource

Throws:

IOException

transmitBytes

public void transmitBytes(byte[] aDatagram,
 int aOffset,
 int aLength)
                   throws IOException

Specified by:

transmitBytes in interface BytesSource

Specified by:

transmitBytes in interface BytesTransmitter

Throws:

IOException

flush

public void flush()
           throws IOException

Specified by:

flush in interface ByteTransmitter

Specified by:

flush in interface Flushable

Specified by:

flush in interface Flushable

Throws:

IOException

close

public void close()
           throws IOException

Make sure to call close() when done as the final padding bytes are appended to the end!

Specified by:

close in interface Closable

Overrides:

close in class AbstractConnectableAutomaton

Throws:

IOException

open

protected void open(BytesSource aConnection)
             throws IOException

Open.

Parameters:

aConnection - the connection

Throws:

IOException - the open exception