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

Author Jeff Suttor
See W3C XML Schema 1.0 Part 2, Section 3.2.7-14
See XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration
See XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration
Since 1.5

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` `Object`s that map XML to/from Java `Object`s.
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.