Module org.tquadrat.foundation.base

Package org.tquadrat.foundation.lang

Class GenericStringConverter<T>

java.lang.Object

org.tquadrat.foundation.lang.GenericStringConverter<T>

Type Parameters:

T - The Object type for the conversion.

All Implemented Interfaces:

Serializable, StringConverter<T>

@ClassVersion(sourceVersion="$Id: GenericStringConverter.java 1078 2023-10-19 14:39:47Z tquadrat $")
@API(status=STABLE,
     since="0.0.6")
public class GenericStringConverter<T>
extends Object
implements StringConverter<T>

This implementation of StringConverter allows to create an instance of StringConverter for an arbitrary type on the fly.

Author:

Thomas Thrien (thomas.thrien@tquadrat.org)

Version:

$Id: GenericStringConverter.java 1078 2023-10-19 14:39:47Z tquadrat $

Since:

0.0.6

See Also:

• Serialized Form

UML Diagram

⁠

UML Diagram for "org.tquadrat.foundation.lang.GenericStringConverter"

⁠

Field Summary

Fields

Modifier and Type	Field	Description
private final Function<CharSequence,T>	m_Parser	The parser.
private final Stringer<T>	m_Stringer	The stringer.

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

METHOD_NAME_GetSubjectClass, METHOD_NAME_Provider

Constructor Summary

Constructors

Constructor	Description
GenericStringConverter(Function<? extends CharSequence,T> parser)	Creates a new GenericStringConverter instance that uses Stringer.DEFAULT_STRINGER to convert an object of type T to a String.
GenericStringConverter(Function<? extends CharSequence,T> parser, Stringer<T> stringer)	Creates a new GenericStringConverter instance.

Method Summary

Modifier and Type	Method	Description
final T	fromString(CharSequence source)	Converts the given String to an object instance.
final String	toString(T source)	Converts the given object instance to a String.

Methods inherited from class java.lang.Object

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

Field Details

m_Parser

private final Function<CharSequence,T> m_Parser

The parser.

m_Stringer

private final Stringer<T> m_Stringer

The stringer.

Constructor Details

GenericStringConverter

public GenericStringConverter(Function<? extends CharSequence,T> parser,
 Stringer<T> stringer)

Creates a new GenericStringConverter instance.

Parameters:

parser - The function that translates a String to an object of type T.

stringer - The function that converts an object of type T to a String.

GenericStringConverter

public GenericStringConverter(Function<? extends CharSequence,T> parser)

Creates a new GenericStringConverter instance that uses Stringer.DEFAULT_STRINGER to convert an object of type T to a String.

Parameters:

parser - The function that translates a String to an object of type T.

Method Details

fromString

public final T fromString(CharSequence source)
                   throws IllegalArgumentException

Converts the given String to an object instance.

Specified by:

fromString in interface StringConverter<T>

Parameters:

source - The String representation for the object instance; can be null.

Returns:

The resulting object instance; will be null if source was already null.

Throws:

IllegalArgumentException - The format of the given String is invalid and cannot be parsed into the object instance.

toString

public final String toString(T source)

Converts the given object instance to a String.

Specified by:

toString in interface StringConverter<T>

Parameters:

source - The object to convert; can be null.

Returns:

The resulting String; will be null if source was already null.