Class AbstractMagicBytesTransmission

java.lang.Object

org.refcodes.serial.AbstractMagicBytesTransmission

All Implemented Interfaces:

Serializable, AliasAccessor, EncodingAccessor<Charset>, LengthAccessor, MagicBytesAccessor, MagicBytesAccessor.MagicBytesMutator, MagicBytesAccessor.MagicBytesProperty, PayloadAccessor<byte[]>, PayloadAccessor.PayloadBuilder<byte[], PayloadTransmission<byte[]>>, PayloadAccessor.PayloadMutator<byte[]>, PayloadAccessor.PayloadProperty<byte[]>, Resetable, Diagnosable, Schemable<DiagnosticOptions>, MagicBytesAccessor, MagicBytesAccessor.MagicBytesMutator, MagicBytesAccessor.MagicBytesProperty, MagicBytesLengthAccessor, PayloadTransmission<byte[]>, Transmission, Transmission.TransmissionMixin

Direct Known Subclasses:

AbstractMagicBytesTransmissionDecorator, MagicBytesSegment

public abstract class AbstractMagicBytesTransmission
extends Object
implements PayloadTransmission<byte[]>, Transmission.TransmissionMixin, MagicBytesAccessor.MagicBytesProperty, MagicBytesLengthAccessor, EncodingAccessor<Charset>

Magic bytes are usually found (somewhere) at the beginning of a file or a stream. A AbstractMagicBytesTransmission provides the base functionality to manage magic bytes.

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface AliasAccessor

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

Nested classes/interfaces inherited from interface EncodingAccessor

EncodingAccessor.EncodingBuilder<E,B>, EncodingAccessor.EncodingMutator<E>, EncodingAccessor.EncodingProperty<E>

Nested classes/interfaces inherited from interface LengthAccessor

LengthAccessor.LengthBuilder<B>, LengthAccessor.LengthMutator, LengthAccessor.LengthProperty

Nested classes/interfaces inherited from interface MagicBytesAccessor

MagicBytesAccessor.MagicBytesBuilder<B>, MagicBytesAccessor.MagicBytesMutator, MagicBytesAccessor.MagicBytesProperty

Nested classes/interfaces inherited from interface MagicBytesAccessor

MagicBytesAccessor.MagicBytesBuilder<B>, MagicBytesAccessor.MagicBytesMutator, MagicBytesAccessor.MagicBytesProperty

Nested classes/interfaces inherited from interface MagicBytesLengthAccessor

MagicBytesLengthAccessor.MagicBytesLengthBuilder<B>, MagicBytesLengthAccessor.MagicBytesLengthMutator, MagicBytesLengthAccessor.MagicBytesLengthProperty

Nested classes/interfaces inherited from interface PayloadAccessor

PayloadAccessor.PayloadBuilder<P,B>, PayloadAccessor.PayloadMutator<P>, PayloadAccessor.PayloadProperty<P>

Nested classes/interfaces inherited from interface Transmission

Transmission.TransmissionMixin

Field Summary

Fields

Modifier and Type	Field	Description
protected String	_alias
protected String	_charset
protected byte[]	_magicBytes
protected int	_magicBytesLength

Constructor Summary

Constructors

Constructor	Description
AbstractMagicBytesTransmission(String aAlias, byte[] aMagicBytes)	Constructs an AbstractMagicBytesTransmission with the according magic bytes.
AbstractMagicBytesTransmission(String aAlias, byte[] aMagicBytes, TransmissionMetrics aTransmissionMetrics)	Constructs an according instance for magic bytes of the given length.
AbstractMagicBytesTransmission(String aAlias, int aMagicBytesLength)	Constructs an AbstractMagicBytesTransmission for magic bytes of the given length.
AbstractMagicBytesTransmission(String aAlias, String aMagicBytes)	Constructs an AbstractMagicBytesTransmission with the according magic bytes (retrieved from the given String).
AbstractMagicBytesTransmission(String aAlias, String aMagicBytes, Charset aCharset)	Constructs an AbstractMagicBytesTransmission with the according magic bytes (retrieved from the given String).
AbstractMagicBytesTransmission(String aAlias, String aMagicBytes, TransmissionMetrics aTransmissionMetrics)	Constructs an according instance for magic bytes of the given length.
AbstractMagicBytesTransmission(String aAlias, TransmissionMetrics aTransmissionMetrics)	Constructs an according instance for magic bytes of the given length.

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object obj)
String	getAlias()
Charset	getEncoding()
byte[]	getMagicBytes()	Returns the magic bytes as stored by this instance.
int	getMagicBytesLength()	Retrieves the magic bytes length from the magic bytes magic bytes length property.
byte[]	getPayload()	Returns the magic bytes as of getMagicBytes().
int	hashCode()
void	reset()	Resets any dynamic data (e.g. values such as payloads or checksums) and must not(!)
void	setMagicBytes(byte[] aMagicBytes)	Sets the magic bytes to be stored by this instance.
void	setMagicBytes(String aMagicBytes)	Sets the magic bytes from the provided String to be stored by this instance (uses the TransmissionMetrics.DEFAULT_ENCODING) for byte conversion).
void	setMagicBytes(String aMagicBytes, Charset aCharset)	Sets the magic bytes from the provided String to be stored by this instance.
void	setPayload(byte[] aValue)	Sets the magic bytes as of setMagicBytes(byte[]).
String	toMagicBytesString()	Retrieves the String representation of the given magic bytes using the latest provided Charset for conversion or the TransmissionMetrics.DEFAULT_ENCODING in case no Charset has been provided.
String	toMagicBytesString(String aCharset)	Retrieves the String representation of the given magic bytes using the provided Charset for conversion or the TransmissionMetrics.DEFAULT_ENCODING in case no Charset has been provided.
Schema	toSchema()
Sequence	toSequence()	Provides the Sequence representation of this Transmission.
SimpleTypeTable	toSimpleTypeTable()	Returns the ImmutableSimpleTypeTable representation of this Transmission.
String	toString()

Methods inherited from class Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface MagicBytesAccessor

toMagicBytes, toMagicBytes

Methods inherited from interface MagicBytesAccessor.MagicBytesProperty

letMagicBytes, letMagicBytes

Methods inherited from interface MagicBytesAccessor.MagicBytesProperty

letMagicBytes

Methods inherited from interface PayloadAccessor

getPayloadOr

Methods inherited from interface PayloadAccessor.PayloadBuilder

withPayload

Methods inherited from interface PayloadAccessor.PayloadProperty

letPayload

Methods inherited from interface Schemable

toSchema

Methods inherited from interface Transmission

getLength, transmitTo, transmitTo

Methods inherited from interface Transmission.TransmissionMixin

transmitTo

Field Details

_magicBytes

protected byte[] _magicBytes

_magicBytesLength

protected int _magicBytesLength

_charset

protected String _charset

_alias

protected String _alias

Constructor Details

AbstractMagicBytesTransmission

public AbstractMagicBytesTransmission(String aAlias,
 TransmissionMetrics aTransmissionMetrics)

Constructs an according instance for magic bytes of the given length. The configuration attributes are taken from the TransmissionMetrics configuration object, though only those attributes are supported which are also supported by the other constructors!

Parameters:

aAlias - The alias which identifies the content of this segment.

aTransmissionMetrics - The TransmissionMetrics to be used for configuring this instance.

AbstractMagicBytesTransmission

public AbstractMagicBytesTransmission(String aAlias,
 String aMagicBytes,
 TransmissionMetrics aTransmissionMetrics)

Constructs an according instance for magic bytes of the given length. The configuration attributes are taken from the TransmissionMetrics configuration object, though only those attributes are supported which are also supported by the other constructors!

Parameters:

aAlias - The alias which identifies the content of this segment.

aMagicBytes - The String to be stored by this instance as magic bytes.

aTransmissionMetrics - The TransmissionMetrics to be used for configuring this instance.

AbstractMagicBytesTransmission

public AbstractMagicBytesTransmission(String aAlias,
 byte[] aMagicBytes,
 TransmissionMetrics aTransmissionMetrics)

Constructs an according instance for magic bytes of the given length. The configuration attributes are taken from the TransmissionMetrics configuration object, though only those attributes are supported which are also supported by the other constructors!

Parameters:

aAlias - The alias which identifies the content of this segment.

aMagicBytes - The bytes to be stored by this instance as magic bytes.

aTransmissionMetrics - The TransmissionMetrics to be used for configuring this instance.

AbstractMagicBytesTransmission

public AbstractMagicBytesTransmission(String aAlias,
 int aMagicBytesLength)

Constructs an AbstractMagicBytesTransmission for magic bytes of the given length.

Parameters:

aAlias - The alias which identifies the content of this segment.

aMagicBytesLength - The length of the magic bytes sequence.

AbstractMagicBytesTransmission

public AbstractMagicBytesTransmission(String aAlias,
 String aMagicBytes)

Constructs an AbstractMagicBytesTransmission with the according magic bytes (retrieved from the given String).

Parameters:

aAlias - The alias which identifies the content of this segment.

aMagicBytes - The String to be stored by this instance as magic bytes (uses the TransmissionMetrics.DEFAULT_ENCODING) for byte conversion).

AbstractMagicBytesTransmission

public AbstractMagicBytesTransmission(String aAlias,
 String aMagicBytes,
 Charset aCharset)

Constructs an AbstractMagicBytesTransmission with the according magic bytes (retrieved from the given String).

Parameters:

aAlias - The alias which identifies the content of this segment.

aMagicBytes - The String to be stored by this instance as magic bytes.

aCharset - The Charset to use when converting the String to a byte array.

AbstractMagicBytesTransmission

public AbstractMagicBytesTransmission(String aAlias,
 byte[] aMagicBytes)

Constructs an AbstractMagicBytesTransmission with the according magic bytes.

Parameters:

aAlias - The alias which identifies the content of this segment.

aMagicBytes - The magic bytes to be stored by this instance.

Method Details

setPayload

public void setPayload(byte[] aValue)

Sets the magic bytes as of setMagicBytes(byte[]).

Specified by:

setPayload in interface PayloadAccessor.PayloadMutator<byte[]>

getAlias

public String getAlias()

Specified by:

getAlias in interface AliasAccessor

getMagicBytes

public byte[] getMagicBytes()

Returns the magic bytes as stored by this instance.

Specified by:

getMagicBytes in interface MagicBytesAccessor

Returns:

The according magic bytes.

setMagicBytes

public void setMagicBytes(byte[] aMagicBytes)

Sets the magic bytes to be stored by this instance.

Specified by:

setMagicBytes in interface MagicBytesAccessor.MagicBytesMutator

Parameters:

aMagicBytes - The according magic bytes to store.

setMagicBytes

public void setMagicBytes(String aMagicBytes)

Sets the magic bytes from the provided String to be stored by this instance (uses the TransmissionMetrics.DEFAULT_ENCODING) for byte conversion).

Specified by:

setMagicBytes in interface MagicBytesAccessor.MagicBytesMutator

Specified by:

setMagicBytes in interface MagicBytesAccessor.MagicBytesMutator

Parameters:

aMagicBytes - The String from which to copy the according magic bytes from.

setMagicBytes

public void setMagicBytes(String aMagicBytes,
 Charset aCharset)

Sets the magic bytes from the provided String to be stored by this instance.

Specified by:

setMagicBytes in interface MagicBytesAccessor.MagicBytesMutator

Parameters:

aMagicBytes - The String from which to copy the according magic bytes from.

aCharset - The Charset to use when converting the String to a byte array.

toMagicBytesString

public String toMagicBytesString()

Retrieves the String representation of the given magic bytes using the latest provided Charset for conversion or the TransmissionMetrics.DEFAULT_ENCODING in case no Charset has been provided.

Returns:

The String representation of the magic bytes.

toMagicBytesString

public String toMagicBytesString(String aCharset)

Retrieves the String representation of the given magic bytes using the provided Charset for conversion or the TransmissionMetrics.DEFAULT_ENCODING in case no Charset has been provided.

Parameters:

aCharset - The Charset to use when converting the String to a byte array.

Returns:

The String representation of the magic bytes.

toSequence

public Sequence toSequence()

Provides the Sequence representation of this Transmission. In case of nested Transmission instances, all Sequence representations from all sub-segments are accumulated to the result as well. Caution, the Transmission (or its nested Transmission instances) may be backed by the returned Sequence.

Specified by:

toSequence in interface Transmission

Returns:

The according instance's Sequence.

getMagicBytesLength

public int getMagicBytesLength()

Retrieves the magic bytes length from the magic bytes magic bytes length property.

Specified by:

getMagicBytesLength in interface MagicBytesLengthAccessor

Returns:

The magic bytes length stored by the magic bytes magic bytes length property.

getPayload

public byte[] getPayload()

Returns the magic bytes as of getMagicBytes().

Specified by:

getPayload in interface PayloadAccessor<byte[]>

reset

public void reset()

Resets any dynamic data (e.g. values such as payloads or checksums) and must not(!) reset any configurations or settings required to produce the dynamic data (e.g. the TransmissionMetrics).

Specified by:

reset in interface Resetable

Specified by:

reset in interface Transmission

toSchema

public Schema toSchema()

Specified by:

toSchema in interface Schemable<DiagnosticOptions>

getEncoding

public Charset getEncoding()

Specified by:

getEncoding in interface EncodingAccessor<Charset>

toString

public String toString()

Overrides:

toString in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toSimpleTypeTable

public SimpleTypeTable toSimpleTypeTable()

Returns the ImmutableSimpleTypeTable representation of this Transmission. In case this Transmission has Transmission children, then the children are queried as well and contained in the resulting ImmutableSimpleTypeTable. The aliases of the according Transmission instances represent the resulting path to a Transmission's final simple type.

Specified by:

toSimpleTypeTable in interface Transmission

Returns:

The ImmutableSimpleTypeTable representing this Transmission and (if any) its children, with the according aliases forming the paths to the Transmission's values.