Package com.github.f4b6a3.uuid.codec.base

Class BaseNCodec

java.lang.Object

com.github.f4b6a3.uuid.codec.base.BaseNCodec

All Implemented Interfaces:

UuidCodec<String>

Direct Known Subclasses:

Base16Codec, Base32Codec, Base32CrockfordCodec, Base32HexCodec, Base36Codec, Base58BitcoinCodec, Base58Codec, Base58FlickrCodec, Base62Codec, Base64Codec, Base64UrlCodec

public abstract class BaseNCodec
extends Object
implements UuidCodec<String>

Abstract class that contains the basic functionality for base-n codecs of this package.

Field Summary

Fields

Modifier and Type	Field	Description
protected BaseN	base
protected Function<String,UUID>	decoder
protected Function<UUID,String>	encoder

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	BaseNCodec(BaseN base)
protected	BaseNCodec(BaseN base, BaseNEncoder encoder, BaseNDecoder decoder)

Method Summary

Modifier and Type	Method	Description
UUID	decode(String string)
String	encode(UUID uuid)
BaseN	getBase()
static BaseNCodec	newInstance(int radix)	Static factory that returns a new instance of BaseNCodec using the specified radix.
static BaseNCodec	newInstance(BaseN base)	Static factory that returns a new instance of BaseNCodec using the specified BaseN.
static BaseNCodec	newInstance(String alphabet)	Static factory that returns a new instance of BaseNCodec using the specified alphabet.

Methods inherited from class java.lang.Object

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

Field Detail

base

protected final BaseN base

encoder

protected final Function<UUID,String> encoder

decoder

protected final Function<String,UUID> decoder

Constructor Detail

BaseNCodec

protected BaseNCodec(BaseN base)

Parameters:

base - an object that represents the base-n encoding

BaseNCodec

protected BaseNCodec(BaseN base,
                     BaseNEncoder encoder,
                     BaseNDecoder decoder)

Parameters:

base - an object that represents the base-n encoding

encoder - a functional encoder

decoder - a functional decoder

Method Detail

newInstance

public static BaseNCodec newInstance(BaseN base)

Static factory that returns a new instance of BaseNCodec using the specified BaseN. This method can be used if none of the existing concrete codecs of this package class is desired. The BaseNCodec objects provided by this method encode UUIDs using remainder operation (modulus), a common approach to encode integers. If you need a BaseN that is not available in this package, use the static factories newInstance(String) or newInstance(int).

Parameters:

base - an object that represents the base-n encoding

Returns:

a BaseNCodec

newInstance

public static BaseNCodec newInstance(int radix)

Static factory that returns a new instance of BaseNCodec using the specified radix. This method can be used if none of the existing concrete codecs of this package class is desired. The BaseNCodec objects provided by this method encode UUIDs using remainder operator (modulus), a common approach to encode integers. The example below shows how to create a BaseNCodec for an hypothetical base-40 encoding that contains only letters. You only need to pass a number 40. The BaseNCodec instantiates a BaseN object internally. See BaseN.

 String radix = 40;
 BaseNCodec codec = BaseNCodec.newInstance(radix);
 

If radix is greater than 36, the alphabet generated is a subset of the character sequence "0-9A-Za-z-_". Otherwise it is a subset of "0-9a-z". In the example above the resulting alphabet is "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcd" (0-9A-Za-d).

Parameters:

radix - the radix to be used

Returns:

a BaseNCodec

newInstance

public static BaseNCodec newInstance(String alphabet)

Static factory that returns a new instance of BaseNCodec using the specified alphabet. This method can be used if none of the existing concrete codecs of this package class is desired. The BaseNCodec objects provided by this method encode UUIDs using remainder operator (modulus), a common approach to encode integers. The example below shows how to create a BaseNCodec for an hypothetical base-26 encoding that contains only letters. You only need to pass a string with 26 characters. The BaseNCodec instantiates a BaseN object internally. See BaseN.

 String alphabet = "abcdefghijklmnopqrstuvwxyz";
 BaseNCodec codec = BaseNCodec.newInstance(alphabet);
 

Alphabet strings similar to "a-f0-9" are expanded to "abcdef0123456789". The same example using the string "a-z" instead of "abcdefghijklmnopqrstuvwxyz":

 String alphabet = "a-z";
 BaseNCodec codec = BaseNCodec.newInstance(alphabet);
 

Parameters:

alphabet - the alphabet to be used

Returns:

a BaseNCodec

encode

public String encode(UUID uuid)

Specified by:

encode in interface UuidCodec<String>

decode

public UUID decode(String string)

Specified by:

decode in interface UuidCodec<String>

getBase

public BaseN getBase()