Docjar: A Java Source and Docuemnt Enginecom.*    java.*    javax.*    org.*    all    new    plug-in

Quick Search    Search Deep

javax.xml.bind
Class DatatypeConverter  view DatatypeConverter download DatatypeConverter.java

java.lang.Object
  extended byjavax.xml.bind.DatatypeConverter

public final class DatatypeConverter
extends java.lang.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 setDatatypeConverter(DatatypeConverterInterface) 55 as soon as possible.

Since:
JAXB1.0

Field Summary
private static DatatypeConverterInterface converter
           
 
Constructor Summary
DatatypeConverter()
           
 
Method Summary
static java.lang.String parseAnySimpleType(java.lang.String pLexicalXSDAnySimpleType)
          Returns the lexical representation of the input string, which is the unmodified input string.
static byte[] parseBase64Binary(java.lang.String pLexicalXSDBase64Binary)
          Parses the lexical representation of the given byte array, which is encoded in base 64.
static boolean parseBoolean(java.lang.String pLexicalXSDBoolean)
          Parses the lexical representation of the given boolean value and converts it into a primitive boolean value.
static byte parseByte(java.lang.String pLexicalXSDByte)
          Parses the lexical representation of the given 8 bit integer value and converts it into a primitive byte value.
static java.util.Calendar parseDate(java.lang.String pLexicalXSDDate)
          Parses the lexical representation of the given date value and converts it into an instance of java.util.Calendar.
static java.util.Calendar parseDateTime(java.lang.String pLexicalXSDDateTime)
          Parses the lexical representation of the given dateTime value and converts it into an instance of java.util.Calendar.
static java.math.BigDecimal parseDecimal(java.lang.String pLexicalXSDDecimal)
          Parses the lexical representation of the given decimal value (arbitrary precision) and converts it into an instance of java.math.BigDecimal.
static double parseDouble(java.lang.String pLexicalXSDDouble)
          Parses the lexical representation of the given 64 bit floating point value and converts it into a primitive double value.
static float parseFloat(java.lang.String pLexicalXSDFloat)
          Parses the lexical representation of the given 32 bit floating point value and converts it into a primitive float value.
static byte[] parseHexBinary(java.lang.String pLexicalXSDHexBinary)
          Parses the lexical representation of the given byte array, which is encoded in hex digits.
static int parseInt(java.lang.String pLexicalXSDInt)
          Parses the lexical representation of the given 32 bit integer value and converts it into a primitive int value.
static java.math.BigInteger parseInteger(java.lang.String pLexicalXSDInteger)
          Parses the lexical representation of the given integer value (arbitrary precision) and converts it into an instance of java.math.BigInteger.
static long parseLong(java.lang.String pLexicalXSDLong)
          Parses the lexical representation of the given 64 bit integer value and converts it into a primitive long value.
static javax.xml.namespace.QName parseQName(java.lang.String pLexicalXSDQName, javax.xml.namespace.NamespaceContext pNamespaceContext)
          Parses the lexical representation of the given qualified name and converts it into an instance of javax.xml.namespace.QName.
static short parseShort(java.lang.String pLexicalXSDShort)
          Parses the lexical representation of the given 16 bit integer value and converts it into a primitive short value.
static java.lang.String parseString(java.lang.String pLexicalXSDString)
          Parses the lexical representation and converts it into a String.
static java.util.Calendar parseTime(java.lang.String pLexicalXSDTime)
          Parses the lexical representation of the given time value and converts it into an instance of java.util.Calendar.
static long parseUnsignedInt(java.lang.String pLexicalXSDUnsignedInt)
          Parses the lexical representation of the given 32 bit unsignet integer value and converts it into a primitive long value.
static int parseUnsignedShort(java.lang.String pLexicalXSDUnsignedShort)
          Parses the lexical representation of the given 16 bit unsignet integer value and converts it into a primitive int value.
static java.lang.String printAnySimpleType(java.lang.String pValue)
          Returns a lexical representation of the given input string, which is the unmodified input string.
static java.lang.String printBase64Binary(byte[] pValue)
          Returns a lexical representation of the given byte array.
static java.lang.String printBoolean(boolean pValue)
          Returns a lexical representation of the given primitive boolean value.
static java.lang.String printByte(byte pValue)
          Returns a lexical representation of the given primitive 8 bit integer.
static java.lang.String printDate(java.util.Calendar pValue)
          Returns a lexical representation of the given date value.
static java.lang.String printDateTime(java.util.Calendar pValue)
          Returns a lexical representation of the given dateTime value.
static java.lang.String printDecimal(java.math.BigDecimal pValue)
          Returns a lexical representation of the given instance of java.math.BigDecimal, which is a decimal number in arbitrary precision.
static java.lang.String printDouble(double pValue)
          Returns a lexical representation of the given primitive 64 bit floating point number.
static java.lang.String printFloat(float pValue)
          Returns a lexical representation of the given primitive 32 bit floating point number.
static java.lang.String printHexBinary(byte[] pValue)
          Returns a lexical representation of the given byte array.
static java.lang.String printInt(int pValue)
          Returns a lexical representation of the given primitive 32 bit integer.
static java.lang.String printInteger(java.math.BigInteger pValue)
          Returns a lexical representation of the given instance of java.math.BigInteger, which is an integer in arbitrary precision.
static java.lang.String printLong(long pValue)
          Returns a lexical representation of the given primitive 64 bit integer.
static java.lang.String printQName(javax.xml.namespace.QName pValue, javax.xml.namespace.NamespaceContext pNamespaceContext)
          Returns a lexical representation of the given qualified name, which is a combination of namespace URI and local name.
static java.lang.String printShort(short pValue)
          Returns a lexical representation of the given primitive 16 bit integer.
static java.lang.String printString(java.lang.String pValue)
          Returns a lexical representation of the given input string, which is the unmodified input string.
static java.lang.String printTime(java.util.Calendar pValue)
          Returns a lexical representation of the given time value.
static java.lang.String printUnsignedInt(long pValue)
          Returns a lexical representation of the given primitive, unsigned 32 bit integer.
static java.lang.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.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

converter

private static DatatypeConverterInterface converter
Constructor Detail

DatatypeConverter

public DatatypeConverter()
Method Detail

setDatatypeConverter

public 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. Subsequent invocations of the method are ignored: First come, first wins.


parseString

public static java.lang.String parseString(java.lang.String pLexicalXSDString)

Parses the lexical representation and converts it into a String.


parseInteger

public static java.math.BigInteger parseInteger(java.lang.String pLexicalXSDInteger)

Parses the lexical representation of the given integer value (arbitrary precision) and converts it into an instance of java.math.BigInteger.


parseInt

public static int parseInt(java.lang.String pLexicalXSDInt)

Parses the lexical representation of the given 32 bit integer value and converts it into a primitive int value.


parseLong

public static long parseLong(java.lang.String pLexicalXSDLong)

Parses the lexical representation of the given 64 bit integer value and converts it into a primitive long value.


parseShort

public static short parseShort(java.lang.String pLexicalXSDShort)

Parses the lexical representation of the given 16 bit integer value and converts it into a primitive short value.


parseDecimal

public static java.math.BigDecimal parseDecimal(java.lang.String pLexicalXSDDecimal)

Parses the lexical representation of the given decimal value (arbitrary precision) and converts it into an instance of java.math.BigDecimal.


parseFloat

public static float parseFloat(java.lang.String pLexicalXSDFloat)

Parses the lexical representation of the given 32 bit floating point value and converts it into a primitive float value.


parseDouble

public static double parseDouble(java.lang.String pLexicalXSDDouble)

Parses the lexical representation of the given 64 bit floating point value and converts it into a primitive double value.


parseBoolean

public static boolean parseBoolean(java.lang.String pLexicalXSDBoolean)

Parses the lexical representation of the given boolean value and converts it into a primitive boolean value.


parseByte

public static byte parseByte(java.lang.String pLexicalXSDByte)

Parses the lexical representation of the given 8 bit integer value and converts it into a primitive byte value.


parseQName

public static javax.xml.namespace.QName parseQName(java.lang.String pLexicalXSDQName,
                                                   javax.xml.namespace.NamespaceContext pNamespaceContext)

Parses the lexical representation of the given qualified name and converts it into an instance of javax.xml.namespace.QName. The javax.xml.namespace.QName consists of a namespace URI and a local name.


parseDateTime

public static java.util.Calendar parseDateTime(java.lang.String pLexicalXSDDateTime)

Parses the lexical representation of the given dateTime value and converts it into an instance of 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:00
 
The former examples are all specified in UTC time. The last example uses a negatice offset of one hour to UTC.


parseBase64Binary

public static byte[] parseBase64Binary(java.lang.String pLexicalXSDBase64Binary)

Parses the lexical representation of the given byte array, which is encoded in base 64.


parseHexBinary

public static byte[] parseHexBinary(java.lang.String pLexicalXSDHexBinary)

Parses the lexical representation of the given byte array, which is encoded in hex digits.


parseUnsignedInt

public static long parseUnsignedInt(java.lang.String pLexicalXSDUnsignedInt)

Parses the lexical representation of the given 32 bit unsignet integer value and converts it into a primitive long value.


parseUnsignedShort

public static int parseUnsignedShort(java.lang.String pLexicalXSDUnsignedShort)

Parses the lexical representation of the given 16 bit unsignet integer value and converts it into a primitive int value.


parseTime

public static java.util.Calendar parseTime(java.lang.String pLexicalXSDTime)

Parses the lexical representation of the given time value and converts it into an instance of 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:00
 
The former examples are all specified in UTC time. The last example uses a negatice offset of one hour to UTC.


parseDate

public static java.util.Calendar parseDate(java.lang.String pLexicalXSDDate)

Parses the lexical representation of the given date value and converts it into an instance of java.util.Calendar. Valid lexical representations of a date value include

   YYYY-MM-DD
   YYYY-MM-DDZ
   YYYY-MM-DD-01:00
 
The former examples are all specified in UTC time. The last example uses a negatice offset of one hour to UTC.


parseAnySimpleType

public static java.lang.String parseAnySimpleType(java.lang.String pLexicalXSDAnySimpleType)

Returns the lexical representation of the input string, which is the unmodified input string.


printString

public static java.lang.String printString(java.lang.String pValue)

Returns a lexical representation of the given input string, which is the unmodified input string.


printInteger

public static java.lang.String printInteger(java.math.BigInteger pValue)

Returns a lexical representation of the given instance of java.math.BigInteger, which is an integer in arbitrary precision.


printInt

public static java.lang.String printInt(int pValue)

Returns a lexical representation of the given primitive 32 bit integer.


printLong

public static java.lang.String printLong(long pValue)

Returns a lexical representation of the given primitive 64 bit integer.


printShort

public static java.lang.String printShort(short pValue)

Returns a lexical representation of the given primitive 16 bit integer.


printDecimal

public static java.lang.String printDecimal(java.math.BigDecimal pValue)

Returns a lexical representation of the given instance of java.math.BigDecimal, which is a decimal number in arbitrary precision.


printFloat

public static java.lang.String printFloat(float pValue)

Returns a lexical representation of the given primitive 32 bit floating point number.


printDouble

public static java.lang.String printDouble(double pValue)

Returns a lexical representation of the given primitive 64 bit floating point number.


printBoolean

public static java.lang.String printBoolean(boolean pValue)

Returns a lexical representation of the given primitive boolean value.


printByte

public static java.lang.String printByte(byte pValue)

Returns a lexical representation of the given primitive 8 bit integer.


printQName

public static java.lang.String printQName(javax.xml.namespace.QName pValue,
                                          javax.xml.namespace.NamespaceContext pNamespaceContext)

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.


printDateTime

public static java.lang.String printDateTime(java.util.Calendar pValue)

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:00
 
The former examples are all specified in UTC time. The last example uses a negatice offset of one hour to UTC.


printBase64Binary

public static java.lang.String printBase64Binary(byte[] pValue)

Returns a lexical representation of the given byte array. The lexical representation is obtained by application of the base 64 encoding.


printHexBinary

public static java.lang.String printHexBinary(byte[] pValue)

Returns a lexical representation of the given byte array. The lexical representation is obtained by encoding any byte as two hex digits.


printUnsignedInt

public static java.lang.String printUnsignedInt(long pValue)

Returns a lexical representation of the given primitive, unsigned 32 bit integer.


printUnsignedShort

public static java.lang.String printUnsignedShort(int pValue)

Returns a lexical representation of the given primitive, unsigned 16 bit integer.


printTime

public static java.lang.String printTime(java.util.Calendar pValue)

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:00
 
The former examples are all specified in UTC time. The last example uses a negatice offset of one hour to UTC.


printDate

public static java.lang.String printDate(java.util.Calendar pValue)

Returns a lexical representation of the given date value. Valid lexical representations include:

   YYYY-MM-DD
   YYYY-MM-DDZ
   YYYY-MM-DD-01:00
 
The former examples are all specified in UTC time. The last example uses a negatice offset of one hour to UTC.


printAnySimpleType

public static java.lang.String printAnySimpleType(java.lang.String pValue)

Returns a lexical representation of the given input string, which is the unmodified input string.