Module org.tquadrat.foundation.util

Package org.tquadrat.foundation.util.stringconverter

Class ListStringConverter<E>

java.lang.Object

org.tquadrat.foundation.util.stringconverter.ListStringConverter<E>

Type Parameters:

E - The element type of the list to convert to a String.

All Implemented Interfaces:

Serializable, StringConverter<List<E>>

@ClassVersion(sourceVersion="$Id: ListStringConverter.java 1080 2024-01-03 11:05:21Z tquadrat $")
@API(status=STABLE,
     since="0.3.0")
public class ListStringConverter<E>
extends Object
implements StringConverter<List<E>>

An implementation of StringConverter for arbitrary instances of List implementations.

The output of toString(List) is quite different from that of a toString() method from one of the List implementations, and not really meant for human readers.

Author:

Thomas Thrien (thomas.thrien@tquadrat.org)

Version:

$Id: ListStringConverter.java 1080 2024-01-03 11:05:21Z tquadrat $

Since:

0.3.0

See Also:

• Serialized Form

UML Diagram

⁠

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

⁠

Field Summary

Fields

Modifier and Type	Field	Description
private final StringConverter<E>	m_ElementStringConverter	The instance of StringConverter that is used for the elements of the list.
private final Supplier<List<E>>	m_Factory	The factory for the list that is used by fromString(CharSequence).
private static final Pattern	m_Pattern	The pattern that is used to identify an entry.
static final String	PATTERN	The pattern that is used to identify an entry: "\\{\\{(.*?)\\}\\}".

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

METHOD_NAME_GetSubjectClass, METHOD_NAME_Provider

Constructor Summary

Constructors

Constructor	Description
ListStringConverter(StringConverter<E> converter, Supplier<List<E>> factory)	Creates a new instance of ListStringConverter.

Method Summary

Modifier and Type	Method	Description
final List<E>	fromString(CharSequence source)
final String	toString(List<E> source)

Methods inherited from class java.lang.Object

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

Field Details

PATTERN

public static final String PATTERN

The pattern that is used to identify an entry: "\\{\\{(.*?)\\}\\}".

See Also:

• Constant Field Values

m_ElementStringConverter

private final StringConverter<E> m_ElementStringConverter

The instance of StringConverter that is used for the elements of the list.

m_Factory

private final Supplier<List<E>> m_Factory

The factory for the list that is used by fromString(CharSequence).

m_Pattern

private static final Pattern m_Pattern

The pattern that is used to identify an entry.

Constructor Details

ListStringConverter

public ListStringConverter(StringConverter<E> converter,
 Supplier<List<E>> factory)

Creates a new instance of ListStringConverter.

Parameters:

converter - The instance of StringConverter that is used for the elements of the list.

factory - The factory for the list that is used by fromString(CharSequence).

Method Details

fromString

public final List<E> fromString(CharSequence source)
                         throws IllegalArgumentException

Specified by:

fromString in interface StringConverter<E>

Throws:

IllegalArgumentException

toString

public final String toString(List<E> source)

Specified by:

toString in interface StringConverter<E>