Module org.tquadrat.foundation.util

Package org.tquadrat.foundation.util.stringconverter

Class CharSequenceStringConverter

java.lang.Object

org.tquadrat.foundation.util.stringconverter.CharSequenceStringConverter

All Implemented Interfaces:

Serializable, StringConverter<CharSequence>

@ClassVersion(sourceVersion="$Id: CharSequenceStringConverter.java 1060 2023-09-24 19:21:40Z tquadrat $")
@API(status=STABLE,
     since="0.0.6")
public final class CharSequenceStringConverter
extends Object
implements StringConverter<CharSequence>

The implementation of StringConverter for CharSequence values.

Although a conversion from CharSequence to String is redundant (at best), this implementation exists for cases where a string converter is retrieved based on the data type; it can simplify the code when no special case must be considered for CharSequence.

Obviously, the method fromString() will not necessarily return an instance of the exact type that may have been used with toString(); it will return an instance of String, as that is the best matching implementation of CharSequence for this purpose.

Author:

Thomas Thrien (thomas.thrien@tquadrat.org)

Version:

$Id: CharSequenceStringConverter.java 1060 2023-09-24 19:21:40Z tquadrat $

Since:

0.1.0

See Also:

• Serialized Form

UML Diagram

⁠

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

⁠

Field Summary

Fields

Modifier and Type	Field	Description
static final CharSequenceStringConverter	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
CharSequenceStringConverter()	Creates a new instance of CharSequenceStringConverter.

Method Summary

Modifier and Type	Method	Description
final CharSequence	fromString(CharSequence source)
final Collection<Class<CharSequence>>	getSubjectClass()	Provides the subject class for this converter.
static final CharSequenceStringConverter	provider()	This method is used by the ServiceLoader to obtain the instance for this StringConverter implementation.
final String	toString(CharSequence 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 CharSequenceStringConverter INSTANCE

An instance of this class.

Constructor Details

CharSequenceStringConverter

public CharSequenceStringConverter()

Creates a new instance of CharSequenceStringConverter.

Method Details

fromString

public final CharSequence fromString(CharSequence source)
                              throws IllegalArgumentException

Specified by:

fromString in interface StringConverter<CharSequence>

Throws:

IllegalArgumentException

getSubjectClass

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

Provides the subject class for this converter.

Returns:

The subject class.

provider

public static final CharSequenceStringConverter provider()

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

Returns:

The instance for this StringConverter implementation.

toString

public final String toString(CharSequence source)

Specified by:

toString in interface StringConverter<CharSequence>