Package org.refcodes.numerical

Class BaseConverterBuilderImpl

java.lang.Object

org.refcodes.numerical.BaseConverterBuilderImpl

All Implemented Interfaces:

org.refcodes.mixin.CharSetAccessor, org.refcodes.mixin.CharSetAccessor.CharSetBuilder<BaseConverterBuilder>, org.refcodes.mixin.CharSetAccessor.CharSetMutator, org.refcodes.mixin.CharSetAccessor.CharSetProperty, BaseConverterBuilder, NumberBaseAccessor, NumberBaseAccessor.NumberBaseBuilder<BaseConverterBuilder>, NumberBaseAccessor.NumberBaseMutator, NumberBaseAccessor.NumberBaseProperty

public class BaseConverterBuilderImpl
extends Object
implements BaseConverterBuilder

This is a hacky implementation of the BaseConverterBuilder interface breaking with an IllegalArgumentException in case the numbers to be converted are too large for the algorithm.

Nested Class Summary

Nested classes/interfaces inherited from interface org.refcodes.mixin.CharSetAccessor

org.refcodes.mixin.CharSetAccessor.CharSetBuilder<B extends org.refcodes.mixin.CharSetAccessor.CharSetBuilder<B>>, org.refcodes.mixin.CharSetAccessor.CharSetMutator, org.refcodes.mixin.CharSetAccessor.CharSetProperty

Nested classes/interfaces inherited from interface org.refcodes.numerical.NumberBaseAccessor

NumberBaseAccessor.NumberBaseBuilder<B extends NumberBaseAccessor.NumberBaseBuilder<B>>, NumberBaseAccessor.NumberBaseMutator, NumberBaseAccessor.NumberBaseProperty

Constructor Summary

Constructors

Constructor	Description
BaseConverterBuilderImpl()	Instantiates a new base converter builder impl.

Method Summary

Modifier and Type	Method	Description
char[]	getCharSet()
long	getNumber()	Retrieves the number from the number property.
int	getNumberBase()	Retrieves the value from the number base property.
String	getNumberBaseValue()	Retrieves the number base value from the number base value property.
byte[]	getNumberData()	Retrieves the number from the number property.
void	setCharSet(char[] aCharSet)
void	setNumber(long aNumber)	Sets the number for the number property.
void	setNumberBase(int aNumberBase)	Sets the value for the number base property.
void	setNumberBaseValue(String aNumberBaseValue)	Sets the number base value for the number base value property.
void	setNumberData(byte[] aNumberData)	Sets the number for the number property.
long	toNumber(String aNumberBaseValue)	Retrieves the number calculated from the provided number base value.
String	toNumberBaseValue(byte[] aNumberData)	Retrieves the number base value calculated from the number.
String	toNumberBaseValue(long aNumber)	Retrieves the number base value calculated from the number.
byte[]	toNumberData(String aNumberBaseValue)	Retrieves the number calculated from the provided number base value.
protected static String	toVerboseString(byte[] aBytes)	TODO: This helper is required to help making the code break when it reaches its bad implementations.
BaseConverterBuilder	withCharSet(char[] aCharSet)

Methods inherited from interface org.refcodes.numerical.BaseConverterBuilder

build, withNumber, withNumberBase, withNumberBaseValue, withNumberData

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BaseConverterBuilderImpl

public BaseConverterBuilderImpl()

Instantiates a new base converter builder impl.

Method Detail

getCharSet

public char[] getCharSet()

Specified by:

getCharSet in interface org.refcodes.mixin.CharSetAccessor

setCharSet

public void setCharSet(char[] aCharSet)

Specified by:

setCharSet in interface org.refcodes.mixin.CharSetAccessor.CharSetMutator

withCharSet

public BaseConverterBuilder withCharSet(char[] aCharSet)

Specified by:

withCharSet in interface org.refcodes.mixin.CharSetAccessor.CharSetBuilder<BaseConverterBuilder>

setNumberBase

public void setNumberBase(int aNumberBase)

Sets the value for the number base property.

Specified by:

setNumberBase in interface NumberBaseAccessor.NumberBaseMutator

Parameters:

aNumberBase - The value to be stored by the number base property.

getNumberBase

public int getNumberBase()

Retrieves the value from the number base property.

Specified by:

getNumberBase in interface NumberBaseAccessor

Returns:

The name stored by the number base property.

toNumberBaseValue

public String toNumberBaseValue(long aNumber)

Retrieves the number base value calculated from the number. This method is to be side effect free in terms of the number (and the encoded result) is not part of the state for this instance (from the point of view of this method). For avoiding thread race conditions / side effects regarding the decoded data (and the encoded result), use this method instead of the combination of BaseConverterBuilder.withNumberData(byte[]) with BaseConverterBuilder.getNumberBaseValue()

Specified by:

toNumberBaseValue in interface BaseConverterBuilder

Parameters:

aNumber - The number to be encoded.

Returns:

The number base value calculated from the number.

getNumber

public long getNumber()

Retrieves the number from the number property.

Specified by:

getNumber in interface BaseConverterBuilder

Returns:

The number stored by the number property.

toNumber

public long toNumber(String aNumberBaseValue)
              throws IllegalArgumentException

Retrieves the number calculated from the provided number base value. This method is to be side effect free in terms of the number base value (and the decoded result) is not part of the state for this instance (from the point of view of this method). For avoiding thread race conditions / side effects regarding the encoded text (and the decoded result), use this method instead of the combination of BaseConverterBuilder.withNumberBaseValue(String) with BaseConverterBuilder.getNumberData().

Specified by:

toNumber in interface BaseConverterBuilder

Parameters:

aNumberBaseValue - The number base value to be decoded.

Returns:

The number decoded from the number base value.

Throws:

IllegalArgumentException - the illegal argument exception

setNumber

public void setNumber(long aNumber)

Sets the number for the number property.

Specified by:

setNumber in interface BaseConverterBuilder

Parameters:

aNumber - The number to be stored by the number property.

getNumberBaseValue

public String getNumberBaseValue()

Retrieves the number base value from the number base value property.

Specified by:

getNumberBaseValue in interface BaseConverterBuilder

Returns:

The number base value stored by the number base value property.

setNumberBaseValue

public void setNumberBaseValue(String aNumberBaseValue)

Sets the number base value for the number base value property.

Specified by:

setNumberBaseValue in interface BaseConverterBuilder

Parameters:

aNumberBaseValue - The number base value to be stored by the number base value property.

getNumberData

public byte[] getNumberData()

Retrieves the number from the number property.

Specified by:

getNumberData in interface BaseConverterBuilder

Returns:

The number stored by the number property.

setNumberData

public void setNumberData(byte[] aNumberData)

Sets the number for the number property.

Specified by:

setNumberData in interface BaseConverterBuilder

Parameters:

aNumberData - The number to be stored by the number property.

toNumberBaseValue

public String toNumberBaseValue(byte[] aNumberData)

Retrieves the number base value calculated from the number. This method is to be side effect free in terms of the number (and the encoded result) is not part of the state for this instance (from the point of view of this method). For avoiding thread race conditions / side effects regarding the decoded data (and the encoded result), use this method instead of the combination of BaseConverterBuilder.withNumberData(byte[]) with BaseConverterBuilder.getNumberBaseValue()

Specified by:

toNumberBaseValue in interface BaseConverterBuilder

Parameters:

aNumberData - The number to be encoded.

Returns:

The number base value calculated from the number.

toNumberData

public byte[] toNumberData(String aNumberBaseValue)

Retrieves the number calculated from the provided number base value. This method is to be side effect free in terms of the number base value (and the decoded result) is not part of the state for this instance (from the point of view of this method). For avoiding thread race conditions / side effects regarding the encoded text (and the decoded result), use this method instead of the combination of BaseConverterBuilder.withNumberBaseValue(String) with BaseConverterBuilder.getNumberData().

Specified by:

toNumberData in interface BaseConverterBuilder

Parameters:

aNumberBaseValue - The number base value to be decoded.

Returns:

The number decoded from the number base value.

toVerboseString

protected static String toVerboseString(byte[] aBytes)

TODO: This helper is required to help making the code break when it reaches its bad implementations. Bad bad hack! Remove when code is fixed.

Parameters:

aBytes - the bytes

Returns:

the string