Module org.tquadrat.foundation.util

Package org.tquadrat.foundation.util.stringconverter

Class NumberStringConverter<T extends Number>

java.lang.Object

org.tquadrat.foundation.util.stringconverter.NumberStringConverter<T>

Type Parameters:

T - The type that is handled by this class.

All Implemented Interfaces:

Serializable, StringConverter<T>

Direct Known Subclasses:

BigDecimalStringConverter, BigIntegerStringConverter, ByteStringConverter, DoubleStringConverter, FloatStringConverter, IntegerStringConverter, LongStringConverter, ShortStringConverter

@ClassVersion(sourceVersion="$Id: NumberStringConverter.java 1080 2024-01-03 11:05:21Z tquadrat $")
@API(status=STABLE,
     since="0.0.6")
public abstract sealed class NumberStringConverter<T extends Number>
extends Object
implements StringConverter<T>
permits BigDecimalStringConverter, BigIntegerStringConverter, ByteStringConverter, DoubleStringConverter, FloatStringConverter, IntegerStringConverter, LongStringConverter, ShortStringConverter

The base class for implementations of StringConverter for types that extend Number.

Author:

Thomas Thrien (thomas.thrien@tquadrat.org)

Version:

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

Since:

0.0.6

See Also:

• Serialized Form

UML Diagram

⁠

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

⁠

Field Summary

Fields

Modifier and Type	Field	Description
private final Collection<Class<?>>	m_SubjectClasses	The subject classes for this converter.
static final String	MSG_InvalidNumberFormat	The error message for a String argument to fromString(CharSequence) that cannot be parsed to a proper number value: "\'%1$s\' cannot be parsed as a valid number".

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

METHOD_NAME_GetSubjectClass, METHOD_NAME_Provider

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	NumberStringConverter(Class<?>... subjectClasses)	Creates a new instance of NumberStringConverter.

Method Summary

Modifier and Type	Method	Description
final T	fromString(CharSequence source)
final Collection<Class<?>>	getSubjectClass()	Provides the subject class for this converter.
protected abstract T	parseNumber(String value)	Parses the given String to a number.

Methods inherited from class java.lang.Object

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

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

toString

Field Details

MSG_InvalidNumberFormat

public static final String MSG_InvalidNumberFormat

The error message for a String argument to fromString(CharSequence) that cannot be parsed to a proper number value: "\'%1$s\' cannot be parsed as a valid number".

See Also:

• Constant Field Values

m_SubjectClasses

private final Collection<Class<?>> m_SubjectClasses

The subject classes for this converter.

Constructor Details

NumberStringConverter

protected NumberStringConverter(Class<?>... subjectClasses)

Creates a new instance of NumberStringConverter.

Parameters:

subjectClasses - The subject classes.

Method Details

parseNumber

protected abstract T parseNumber(String value)
                          throws NumberFormatException

Parses the given String to a number. The String is not null, not empty, and it will not contain blanks only. Leading or trailing blanks have been cut off.

Parameters:

value - The String to parse.

Returns:

The number.

Throws:

NumberFormatException - The given value cannot be parsed to a number.

fromString

public final T fromString(CharSequence source)
                   throws IllegalArgumentException

Specified by:

fromString in interface StringConverter<T extends Number>

Throws:

IllegalArgumentException

getSubjectClass

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

Provides the subject class for this converter.

Returns:

The subject class.