javax.xml.bind
public final class DatatypeConverter extends Object
This is a helper class for customized datatypes. It provides a set of static methods which may be useful in custom methods for parsing and printing values.
The JAXB provider is responsible to initialize the
DatatypeConverter
class by invoking
{@link #setDatatypeConverter(DatatypeConverterInterface)} as soon
as possible.
Since: JAXB1.0
Method Summary | |
---|---|
static String | parseAnySimpleType(String pLexicalXSDAnySimpleType) Returns the lexical representation of the input string, which is the unmodified input string. |
static byte[] | parseBase64Binary(String pLexicalXSDBase64Binary) Parses the lexical representation of the given byte array, which is encoded in base 64. |
static boolean | parseBoolean(String pLexicalXSDBoolean) Parses the lexical representation of the given boolean value
and converts it into a primitive |
static byte | parseByte(String pLexicalXSDByte) Parses the lexical representation of the given 8 bit integer value
and converts it into a primitive |
static Calendar | parseDate(String pLexicalXSDDate) Parses the lexical representation of the given date value and converts it into an instance of {@link java.util.Calendar}. |
static Calendar | parseDateTime(String pLexicalXSDDateTime) Parses the lexical representation of the given dateTime value and converts it into an instance of {@link java.util.Calendar}. |
static BigDecimal | parseDecimal(String pLexicalXSDDecimal) Parses the lexical representation of the given decimal value (arbitrary precision) and converts it into an instance of {@link java.math.BigDecimal}. |
static double | parseDouble(String pLexicalXSDDouble) Parses the lexical representation of the given 64 bit floating
point value and converts it into a primitive |
static float | parseFloat(String pLexicalXSDFloat) Parses the lexical representation of the given 32 bit floating
point value and converts it into a primitive |
static byte[] | parseHexBinary(String pLexicalXSDHexBinary) Parses the lexical representation of the given byte array, which is encoded in hex digits. |
static int | parseInt(String pLexicalXSDInt) Parses the lexical representation of the given 32 bit integer value
and converts it into a primitive |
static BigInteger | parseInteger(String pLexicalXSDInteger) Parses the lexical representation of the given integer value (arbitrary precision) and converts it into an instance of {@link java.math.BigInteger}. |
static long | parseLong(String pLexicalXSDLong) Parses the lexical representation of the given 64 bit integer value
and converts it into a primitive |
static QName | parseQName(String pLexicalXSDQName, NamespaceContext pNamespaceContext) Parses the lexical representation of the given qualified name and converts it into an instance of {@link javax.xml.namespace.QName}. |
static short | parseShort(String pLexicalXSDShort) Parses the lexical representation of the given 16 bit integer value
and converts it into a primitive |
static String | parseString(String pLexicalXSDString) Parses the lexical representation and converts it into a String. |
static Calendar | parseTime(String pLexicalXSDTime) Parses the lexical representation of the given time value and converts it into an instance of {@link java.util.Calendar}. |
static long | parseUnsignedInt(String pLexicalXSDUnsignedInt) Parses the lexical representation of the given 32 bit
unsignet integer value and converts it into a primitive |
static int | parseUnsignedShort(String pLexicalXSDUnsignedShort) Parses the lexical representation of the given 16 bit
unsignet integer value and converts it into a primitive |
static String | printAnySimpleType(String pValue) Returns a lexical representation of the given input string, which is the unmodified input string. |
static String | printBase64Binary(byte[] pValue) Returns a lexical representation of the given byte array. |
static String | printBoolean(boolean pValue) Returns a lexical representation of the given primitive boolean value. |
static String | printByte(byte pValue) Returns a lexical representation of the given primitive 8 bit integer. |
static String | printDate(Calendar pValue) Returns a lexical representation of the given date value. |
static String | printDateTime(Calendar pValue) Returns a lexical representation of the given dateTime value. |
static String | printDecimal(BigDecimal pValue) Returns a lexical representation of the given instance of {@link BigDecimal}, which is a decimal number in arbitrary precision. |
static String | printDouble(double pValue) Returns a lexical representation of the given primitive 64 bit floating point number. |
static String | printFloat(float pValue) Returns a lexical representation of the given primitive 32 bit floating point number. |
static String | printHexBinary(byte[] pValue) Returns a lexical representation of the given byte array. |
static String | printInt(int pValue) Returns a lexical representation of the given primitive 32 bit integer. |
static String | printInteger(BigInteger pValue) Returns a lexical representation of the given instance of {@link BigInteger}, which is an integer in arbitrary precision. |
static String | printLong(long pValue) Returns a lexical representation of the given primitive 64 bit integer. |
static String | printQName(QName pValue, NamespaceContext pNamespaceContext) Returns a lexical representation of the given qualified name, which is a combination of namespace URI and local name. |
static String | printShort(short pValue) Returns a lexical representation of the given primitive 16 bit integer. |
static String | printString(String pValue) Returns a lexical representation of the given input string, which is the unmodified input string. |
static String | printTime(Calendar pValue) Returns a lexical representation of the given time value. |
static String | printUnsignedInt(long pValue) Returns a lexical representation of the given primitive, unsigned 32 bit integer. |
static String | printUnsignedShort(int pValue) Returns a lexical representation of the given primitive, unsigned 16 bit integer. |
static void | setDatatypeConverter(DatatypeConverterInterface pConverter) This method must be invoked by the JAXB provider to set the actual instance, which is invoked by the static methods. |
Returns the lexical representation of the input string, which is the unmodified input string.
Parameters: pLexicalXSDAnySimpleType An input string in lexical representation.
Returns: The unmodified input string.
See Also: ParseConversionEvent
Parses the lexical representation of the given byte array, which is encoded in base 64.
Parameters: pLexicalXSDBase64Binary The input string being parsed, a base 64 encoded array of bytes.
Returns: The decoded byte array.
See Also: ParseConversionEvent
Parses the lexical representation of the given boolean value
and converts it into a primitive boolean
value.
Parameters: pLexicalXSDBoolean The input string being parsed.
Returns: The input string converted into a primitive boolean
.
See Also: ParseConversionEvent
Parses the lexical representation of the given 8 bit integer value
and converts it into a primitive byte
value.
Parameters: pLexicalXSDByte The input string being parsed.
Returns: The input string converted into a primitive byte
.
See Also: ParseConversionEvent
Parses the lexical representation of the given date value and converts it into an instance of {@link java.util.Calendar}. Valid lexical representations of a date value include
YYYY-MM-DD YYYY-MM-DDZ YYYY-MM-DD-01:00The former examples are all specified in UTC time. The last example uses a negatice offset of one hour to UTC.
Parameters: pLexicalXSDDate The input string being parsed.
Returns: The input string converted into an instance of {@link java.util.Calendar}.
See Also: ParseConversionEvent
Parses the lexical representation of the given dateTime value and converts it into an instance of {@link java.util.Calendar}. Valid lexical representations of a dateTime value include
YYYY-MM-DDThh:mm:ss YYYY-MM-DDThh:mm:ss.sss YYYY-MM-DDThh:mm:ssZ YYYY-MM-DDThh:mm:ss-01:00The former examples are all specified in UTC time. The last example uses a negatice offset of one hour to UTC.
Parameters: pLexicalXSDDateTime The input string being parsed.
Returns: The input string converted into an instance of {@link java.util.Calendar}.
See Also: ParseConversionEvent
Parses the lexical representation of the given decimal value (arbitrary precision) and converts it into an instance of {@link java.math.BigDecimal}.
Parameters: pLexicalXSDDecimal The input string being parsed.
Returns: The input string converted into an instance of {@link java.math.BigDecimal}.
See Also: ParseConversionEvent
Parses the lexical representation of the given 64 bit floating
point value and converts it into a primitive double
value.
Parameters: pLexicalXSDDouble The input string being parsed.
Returns: The input string converted into a primitive double
.
See Also: ParseConversionEvent
Parses the lexical representation of the given 32 bit floating
point value and converts it into a primitive float
value.
Parameters: pLexicalXSDFloat The input string being parsed.
Returns: The input string converted into a primitive float
.
See Also: ParseConversionEvent
Parses the lexical representation of the given byte array, which is encoded in hex digits.
Parameters: pLexicalXSDHexBinary The input string being parsed, an array of bytes encoded in hex digits.
Returns: The decoded byte array.
See Also: ParseConversionEvent
Parses the lexical representation of the given 32 bit integer value
and converts it into a primitive int
value.
Parameters: pLexicalXSDInt The input string being parsed.
Returns: The input string converted into a primitive int
.
See Also: ParseConversionEvent
Parses the lexical representation of the given integer value (arbitrary precision) and converts it into an instance of {@link java.math.BigInteger}.
Parameters: pLexicalXSDInteger The input string being parsed.
Returns: The input string converted into an instance of {@link BigInteger}.
See Also: ParseConversionEvent
Parses the lexical representation of the given 64 bit integer value
and converts it into a primitive long
value.
Parameters: pLexicalXSDLong The input string being parsed.
Returns: The input string converted into a primitive long
.
See Also: ParseConversionEvent
Parses the lexical representation of the given qualified name and converts it into an instance of {@link javax.xml.namespace.QName}. The {@link javax.xml.namespace.QName} consists of a namespace URI and a local name.
Parameters: pLexicalXSDQName The input string being parsed, an optional namespace prefix, followed by the local name, if any. If a prefix is present, they are separated by a colon. pNamespaceContext The namespace context is used to query mappings between prefixes and namespace URI's.
Returns: The input string converted into an instance of {@link javax.xml.namespace.QName}.
See Also: ParseConversionEvent
Parses the lexical representation of the given 16 bit integer value
and converts it into a primitive short
value.
Parameters: pLexicalXSDShort The input string being parsed.
Returns: The input string converted into a primitive short
.
See Also: ParseConversionEvent
Parses the lexical representation and converts it into a String.
Parameters: pLexicalXSDString The input string being parsed.
Returns: The unmodified input string.
See Also: ParseConversionEvent
Parses the lexical representation of the given time value and converts it into an instance of {@link java.util.Calendar}. Valid lexical representations of a time value include
hh:mm:ss hh:mm:ss.sss hh:mm:ssZ hh:mm:ss-01:00The former examples are all specified in UTC time. The last example uses a negatice offset of one hour to UTC.
Parameters: pLexicalXSDTime The input string being parsed.
Returns: The input string converted into an instance of {@link java.util.Calendar}.
See Also: ParseConversionEvent
Parses the lexical representation of the given 32 bit
unsignet integer value and converts it into a primitive long
value.
Parameters: pLexicalXSDUnsignedInt The input string being parsed.
Returns: The input string converted into a primitive long
.
See Also: ParseConversionEvent
Parses the lexical representation of the given 16 bit
unsignet integer value and converts it into a primitive int
value.
Parameters: pLexicalXSDUnsignedShort The input string being parsed.
Returns: The input string conve
rted into a primitive int
.
See Also: ParseConversionEvent
Returns a lexical representation of the given input string, which is the unmodified input string.
Parameters: pValue The input string.
Returns: The unmodified input string.
See Also: PrintConversionEvent
Returns a lexical representation of the given byte array. The lexical representation is obtained by application of the base 64 encoding.
Parameters: pValue The byte array being converted.
Returns: The converted byte array.
See Also: PrintConversionEvent
Returns a lexical representation of the given primitive boolean value.
Parameters: pValue The boolean
value being converted.
Returns: A lexical representation of the input value.
See Also: PrintConversionEvent
Returns a lexical representation of the given primitive 8 bit integer.
Parameters: pValue The byte
value being converted.
Returns: A lexical representation of the input value.
See Also: PrintConversionEvent
Returns a lexical representation of the given date value. Valid lexical representations include:
YYYY-MM-DD YYYY-MM-DDZ YYYY-MM-DD-01:00The former examples are all specified in UTC time. The last example uses a negatice offset of one hour to UTC.
Parameters: pValue The date value being converted
Returns: A lexical representation of the input value.
See Also: PrintConversionEvent
Returns a lexical representation of the given dateTime value. Valid lexical representations include:
YYYY-MM-DDThh:mm:ss YYYY-MM-DDThh:mm:ss.sss YYYY-MM-DDThh:mm:ssZ YYYY-MM-DDThh:mm:ss-01:00The former examples are all specified in UTC time. The last example uses a negatice offset of one hour to UTC.
Parameters: pValue The dateTime value being converted
Returns: A lexical representation of the input value.
See Also: PrintConversionEvent
Returns a lexical representation of the given instance of {@link BigDecimal}, which is a decimal number in arbitrary precision.
Parameters: pValue The decimal value being converted.
Returns: A lexical representation of the input value.
See Also: PrintConversionEvent
Returns a lexical representation of the given primitive 64 bit floating point number.
Parameters: pValue The double
value being converted.
Returns: A lexical representation of the input value.
See Also: PrintConversionEvent
Returns a lexical representation of the given primitive 32 bit floating point number.
Parameters: pValue The float
value being converted.
Returns: A lexical representation of the input value.
See Also: PrintConversionEvent
Returns a lexical representation of the given byte array. The lexical representation is obtained by encoding any byte as two hex digits.
Parameters: pValue The byte array being converted.
Returns: The converted byte array.
See Also: PrintConversionEvent
Returns a lexical representation of the given primitive 32 bit integer.
Parameters: pValue The int
value being converted.
Returns: A lexical representation of the input value.
See Also: PrintConversionEvent
Returns a lexical representation of the given instance of {@link BigInteger}, which is an integer in arbitrary precision.
Parameters: pValue The integer value being converted.
Returns: A lexical representation of the input value.
See Also: PrintConversionEvent
Returns a lexical representation of the given primitive 64 bit integer.
Parameters: pValue The long
value being converted.
Returns: A lexical representation of the input value.
See Also: PrintConversionEvent
Returns a lexical representation of the given qualified name, which is a combination of namespace URI and local name. The lexical representation is an optional prefix, which is currently mapped to namespace URI of the qualified name, followed by a colon and the local name. If the namespace URI is the current default namespace URI, then the prefix and the colon may be omitted.
Parameters: pValue The qualified name being converted. pNamespaceContext A mapping of prefixes to namespace URI's which may be used to determine a valid prefix.
Returns: A lexical representation of the qualified name.
See Also: PrintConversionEvent
Returns a lexical representation of the given primitive 16 bit integer.
Parameters: pValue The short
value being converted.
Returns: A lexical representation of the input value.
See Also: PrintConversionEvent
Returns a lexical representation of the given input string, which is the unmodified input string.
Parameters: pValue The input string.
Returns: The unmodified input string.
See Also: PrintConversionEvent
Returns a lexical representation of the given time value. Valid lexical representations include:
hh:mm:ss hh:mm:ss.sss hh:mm:ssZ hh:mm:ss-01:00The former examples are all specified in UTC time. The last example uses a negatice offset of one hour to UTC.
Parameters: pValue The time value being converted
Returns: A lexical representation of the input value.
See Also: PrintConversionEvent
Returns a lexical representation of the given primitive, unsigned 32 bit integer.
Parameters: pValue The long
value being converted.
Returns: A lexical representation of the input value.
See Also: PrintConversionEvent
Returns a lexical representation of the given primitive, unsigned 16 bit integer.
Parameters: pValue The short
value being converted.
Returns: A lexical representation of the input value.
See Also: PrintConversionEvent
This method must be invoked by the JAXB provider to set the actual instance, which is invoked by the static methods. Subsequent invocations of the method are ignored: First come, first wins.
Throws: IllegalArgumentException The parameter was null.