Module java.xml

# Package javax.xml.datatype

Defines XML/Java Type Mappings.

This API provides XML/Java type mappings.

The following XML standards apply:

- W3C XML Schema 1.0 Part 2, Section 3.2.7-14
- XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration
- XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration

W3C XML Schema/Java Type Mappings
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 and XPath/Java Type Mappings
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

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

Class Summary
Class | Description
--- | ---
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.

Exception Summary
Exception | Description
--- | ---
DatatypeConfigurationException | Indicates a serious configuration error.