Class URLStringConverter

java.lang.Object

org.tquadrat.foundation.util.stringconverter.URLStringConverter

All Implemented Interfaces:

Serializable, StringConverter<URL>

Direct Known Subclasses:

EncodedURLStringConverter

@ClassVersion(sourceVersion="$Id: URLStringConverter.java 1157 2025-12-31 14:05:44Z tquadrat $")
@API(status=STABLE,
     since="0.0.6")
public sealed class URLStringConverter
extends Object
implements StringConverter<URL>
permits EncodedURLStringConverter

An implementation of StringConverter for URL values.

The method fromString(CharSequence) will use the constructor URI(String) and then URI.toURL() to create a URL instance from the given value. It requires that the URL is absolute.

Generally, when dealing with relative URLs, URIs should be used instead.

Author:

Thomas Thrien (thomas.thrien@tquadrat.org)

Version:

$Id: URLStringConverter.java 1157 2025-12-31 14:05:44Z tquadrat $

Since:

0.0.6

See Also:

• Serialized Form

UML Diagram

⁠

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

⁠

Field Summary

Fields

Modifier and Type	Field	Description
static final URLStringConverter	INSTANCE	An instance of this class.
static final String	MSG_InvalidURL	The error message for an invalid URL: "\'%1$s\' cannot be parsed as a valid URL".

Fields inherited from interface StringConverter

METHOD_NAME_GetSubjectClass, METHOD_NAME_Provider

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
URL	fromString(CharSequence source)
final Collection<Class<?>>	getSubjectClass()	Provides the subject class for this converter.
static final URLStringConverter	provider()	This method is used by the ServiceLoader to obtain the instance for this StringConverter implementation.
String	toString(URL source)

Methods inherited from class Object

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

Field Details

MSG_InvalidURL

public static final String MSG_InvalidURL

The error message for an invalid URL: "\'%1$s\' cannot be parsed as a valid URL".

See Also:

• Constant Field Values

INSTANCE

public static final URLStringConverter INSTANCE

An instance of this class.

Constructor Details

URLStringConverter

public URLStringConverter()

Creates a new instance of URLStringConverter.

Method Details

fromString

public URL fromString(CharSequence source)
               throws IllegalArgumentException

Specified by:

fromString in interface StringConverter<URL>

Throws:

IllegalArgumentException

getSubjectClass

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

Provides the subject class for this converter.

Returns:

The subject class.

provider

public static final URLStringConverter 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 String toString(URL source)

Specified by:

toString in interface StringConverter<URL>