Class EmailAddressStringConverter

java.lang.Object

org.tquadrat.foundation.email.EmailAddressStringConverter

All Implemented Interfaces:

Serializable, StringConverter<InternetAddress>

@ClassVersion(sourceVersion="$Id: EmailAddressStringConverter.java 1110 2024-03-04 15:26:06Z tquadrat $")
@API(status=STABLE,
     since="0.4.2")
public final class EmailAddressStringConverter
extends Object
implements StringConverter<InternetAddress>

The implementation of StringConverter for an email address (implemented through InternetAddress).

The implementation of StringConverter.toString(Object) uses InternetAddress.toString() to get the String representation of the email address.

fromString(CharSequence) calls the constructor InternetAddress(String).

Author:

Thomas Thrien (thomas.thrien@tquadrat.org)

Version:

$Id: EmailAddressStringConverter.java 1110 2024-03-04 15:26:06Z tquadrat $

Since:

0.4.2

See Also:

• Serialized Form

UML Diagram

⁠

UML Diagram for "org.tquadrat.foundation.email.EmailAddressStringConverter"

⁠

Field Summary

Fields

Modifier and Type	Field	Description
static final EmailAddressStringConverter	INSTANCE	An instance of this class.
static final String	MSG_InvalidEmailAddress	The error message about an invalid email address: "\'%1$s\' is not a valid email address".

Fields inherited from interface StringConverter

METHOD_NAME_GetSubjectClass, METHOD_NAME_Provider

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
final InternetAddress	fromString(CharSequence source)
static final EmailAddressStringConverter	provider()	This method is used by the ServiceLoader to obtain the instance for this StringConverter implementation.

Methods inherited from class Object

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

Methods inherited from interface StringConverter

toString

Field Details

MSG_InvalidEmailAddress

public static final String MSG_InvalidEmailAddress

The error message about an invalid email address: "\'%1$s\' is not a valid email address".

See Also:

• Constant Field Values

INSTANCE

public static final EmailAddressStringConverter INSTANCE

An instance of this class.

Constructor Details

EmailAddressStringConverter

public EmailAddressStringConverter()

Creates a new instance of EmailAddressStringConverter.

Method Details

fromString

public final InternetAddress fromString(CharSequence source)
                                 throws IllegalArgumentException

Specified by:

fromString in interface StringConverter<InternetAddress>

Throws:

IllegalArgumentException

provider

public static final EmailAddressStringConverter provider()

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

Returns:

The instance for this StringConverter implementation.