Module org.tquadrat.foundation.util

Package org.tquadrat.foundation.util.stringconverter

Class ByteArrayStringConverter

java.lang.Object

org.tquadrat.foundation.util.stringconverter.ByteArrayStringConverter

All Implemented Interfaces:

Serializable, StringConverter<byte[]>

@ClassVersion(sourceVersion="$Id: ByteArrayStringConverter.java 1045 2023-02-07 23:09:17Z tquadrat $")
@API(status=STABLE,
     since="0.1.0")
public final class ByteArrayStringConverter
extends Object
implements StringConverter<byte[]>

The implementation of StringConverter for byte arrays.

The output from toString(byte[]) will be in BASE64 format, encoded to ASCII.

Correspondingly, fromString(CharSequence) expects an ASCII encoded BASE64 stream.

Both methods are using the BASE64 basic encoding scheme.

Author:

Thomas Thrien (thomas.thrien@tquadrat.org)

Version:

$Id: ByteArrayStringConverter.java 1045 2023-02-07 23:09:17Z tquadrat $

Since:

0.1.0

See Also:

• Base64
• Base64.getEncoder()
• Base64.getDecoder()
• Serialized Form

UML Diagram

⁠

UML Diagram for "org.tquadrat.foundation.util.stringconverter.ByteArrayStringConverter"

⁠

Field Summary

Fields

Modifier and Type	Field	Description
static final ByteArrayStringConverter	INSTANCE	An instance of this class.

Fields inherited from interface org.tquadrat.foundation.lang.StringConverter

METHOD_NAME_GetSubjectClass, METHOD_NAME_Provider

Constructor Summary

Constructors

Constructor	Description
ByteArrayStringConverter()	Creates a new instance of ByteArrayStringConverter.

Method Summary

Modifier and Type	Method	Description
final byte[]	fromString(CharSequence source)
final Collection<Class<?>>	getSubjectClass()	Provides the subject class for this converter.
static final ByteArrayStringConverter	provider()	This method is used by the ServiceLoader to obtain the instance for this StringConverter implementation.
final String	toString(byte[] source)

Methods inherited from class java.lang.Object

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

Field Details

INSTANCE

public static final ByteArrayStringConverter INSTANCE

An instance of this class.

Constructor Details

ByteArrayStringConverter

public ByteArrayStringConverter()

Creates a new instance of ByteArrayStringConverter.

Method Details

fromString

public final byte[] fromString(CharSequence source)
                        throws IllegalArgumentException

Specified by:

fromString in interface StringConverter<byte[]>

Throws:

IllegalArgumentException

provider

public static final ByteArrayStringConverter provider()

This method is used by the ServiceLoader to obtain the instance for this StringConverter implementation.

Returns:

The instance for this StringConverter implementation.

getSubjectClass

public final Collection<Class<?>> getSubjectClass()

Provides the subject class for this converter.

Returns:

The subject class.

toString

public final String toString(byte[] source)

Specified by:

toString in interface StringConverter<byte[]>