public class Base64 extends Type
Modifier and Type | Field and Description |
---|---|
static Base64 |
SINGLETON
The only instance of this class.
|
Modifier | Constructor and Description |
---|---|
protected |
Base64(String name,
int minimum,
int maximum)
Constructs a new
Base64 object (constructor for
subclasses). |
Modifier and Type | Method and Description |
---|---|
static byte[] |
fromStringForOptional(String string)
Converts the specified base64 string value to a
byte[] value. |
static byte[] |
fromStringForRequired(String string)
Converts the specified non-
null string base64 value to a
byte[] . |
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 string)
Determines if the specified
String value is considered
valid for this type (implementation method). |
static String |
toString(byte[] value)
Converts the specified
byte[] to a base64 string. |
String |
toString(Object value)
Generates a string representation of the specified value for this type.
|
checkValue, fromString, getName, getValueClass, isValidValue, toString
public static final Base64 SINGLETON
null
.protected Base64(String name, int minimum, int maximum)
Base64
object (constructor for
subclasses).name
- the name of this type, cannot be null
.minimum
- the minimum length that the byte[] should be.maximum
- the maximum length that the byte[] should be.public static byte[] fromStringForRequired(String string) throws IllegalArgumentException, TypeValueException
null
string base64 value to a
byte[]
.string
- the string to convert, cannot be null
.byte[]
value.IllegalArgumentException
- if string == null
.TypeValueException
- if the specified string does not represent a valid value for this
type.public static byte[] fromStringForOptional(String string) throws TypeValueException
byte[]
value.string
- the string to convert, can be null
.null
if
string == null
.TypeValueException
- if the specified string does not represent a valid value for this
type.public static String toString(byte[] value)
byte[]
to a base64 string.value
- the value to convert, can be null
.null
if and
only if value == null
.protected boolean isValidValueImpl(String string)
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
.
isValidValueImpl
in class Type
string
- 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
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 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
isValidValueImpl(String)
without getting an exception.null
.TypeValueException
- if string
is considered to be an invalid value for this
type.public final String toString(Object value) throws IllegalArgumentException, ClassCastException, TypeValueException
Type.getValueClass()
). Also, it may have to fall within a
certain range of valid values, depending on the type.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/.