Since: API Level 8
package

javax.xml.datatype

XML/Java Type Mappings.

The javax.xml.datatype API provides XML/Java type mappings.

The following XML standards apply:


W3C XML Schema Data Type Java Data Type
xs:date XMLGregorianCalendar
xs:dateTime XMLGregorianCalendar
xs:duration Duration
xs:gDay XMLGregorianCalendar
xs:gMonth XMLGregorianCalendar
xs:gMonthDay XMLGregorianCalendar
xs:gYear XMLGregorianCalendar
xs:gYearMonth XMLGregorianCalendar
xs:time XMLGregorianCalendar

XQuery 1.0 and XPath 2.0 Data Model Java Data Type
xdt:dayTimeDuration Duration
xdt:yearMonthDuration Duration

W3C XML Schema data types that have a "natural" mapping to Java types are defined by JSR 31: Java™ Architecture for XML Binding (JAXB) Specification, Binding XML Schema to Java Representations. JAXB defined mappings for XML Schema built-in data types include:

  • xs:anySimpleType
  • xs:base64Binary
  • xs:boolean
  • xs:byte
  • xs:decimal
  • xs:double
  • xs:float
  • xs:hexBinary
  • xs:int
  • xs:integer
  • xs:long
  • xs:QName
  • xs:short
  • xs:string
  • xs:unsignedByte
  • xs:unsignedInt
  • xs:unsignedShort


Classes

DatatypeConstants

Utility class to contain basic Datatype values as constants. 

DatatypeConstants.Field Type-safe enum class that represents six fields of the Duration class. 
DatatypeFactory

Factory that creates new javax.xml.datatype Objects that map XML to/from Java Objects. 

Duration

Immutable representation of a time span as defined in the W3C XML Schema 1.0 specification. 

XMLGregorianCalendar

Representation for W3C XML Schema 1.0 date/time datatypes. 

Exceptions

DatatypeConfigurationException

Indicates a serious configuration error.