public final class URL extends Type
Modifier and Type | Field and Description |
---|---|
static URL |
SINGLETON
The only instance of this class.
|
Modifier and Type | Method and Description |
---|---|
static String |
fromStringForOptional(String string)
Converts the specified string value to a
String
value. |
static String |
fromStringForRequired(String string)
Converts the specified non-
null string value to a
String . |
protected Object |
fromStringImpl(String string)
Converts from a
String to an instance of the value class
for this type (implementation method). |
String |
getDescription()
Retrieves the description of this type.
|
protected boolean |
isValidValueImpl(String value)
Determines if the specified
String value is considered
valid for this type (implementation method). |
String |
toString(Object value)
Generates a string representation of the specified value for this type.
|
checkValue, fromString, getName, getValueClass, isValidValue, toString
public static final URL SINGLETON
null
.public static String fromStringForRequired(String string) throws TypeValueException, IllegalArgumentException
null
string value to a
String
. This is in fact a no-op, the method will just
return the input value. This method exists to be in line with the
interfaces of the other standard type classes.string
- the string to convert, cannot be null
.String
.TypeValueException
- if the specified string does not represent a valid value for this
type.IllegalArgumentException
- if string == null
.public static String fromStringForOptional(String string) throws TypeValueException
String
value.string
- the string to convert, can be null
.String
, can be null
.TypeValueException
- if the specified string does not represent a valid value for this
type.protected boolean isValidValueImpl(String value)
Type
String
value is considered
valid for this type (implementation method).
This method is called from Type.isValidValue(String)
. When
called from that method, it is guaranteed that the argument is not
null
.
Type
returns
true
.isValidValueImpl
in class Type
value
- the String
value that should be checked for validity,
never null
.true
if and only if the specified String
value is valid, false
otherwise.protected Object fromStringImpl(String string) throws TypeValueException
Type
String
to an instance of the value class
for this type (implementation method).
This method is not required to check the validity of the specified
value (since Type.isValidValueImpl(String)
should have been called
before) but if it does, then it may throw a TypeValueException
.
fromStringImpl
in class Type
string
- the string to convert to an instance of the value class, guaranteed
to be not null
and guaranteed to have been passed to
Type.isValidValueImpl(String)
without getting an exception.null
.TypeValueException
- if string
is considered to be an invalid value for this
type.public String toString(Object value) throws IllegalArgumentException, ClassCastException, TypeValueException
Type
Type.getValueClass()
). Also, it may have to fall within a
certain range of valid values, depending on the type.
The default implementation of this method in class Type
does
the following:
value == null
then it throws an
IllegalArgumentException
;
getValueClass().isInstance(value) == false
then
it throws a ClassCastException
;
value.
Object.toString()
.
toString
in class Type
value
- the value, cannot be null
.null
.IllegalArgumentException
- if value == null
.ClassCastException
- if getValueClass().isInstance(value) == false
.TypeValueException
- if the specified value is not in the allowed range.public String getDescription()
Type
getDescription
in class Type
null
.See http://www.xins.org/.