javax.xml.datatype (Java SE 14 & JDK 14)
Description: declaration: module: java.xml, package: javax.xml.datatype
Keywords: javax.xml.datatype package

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.