javax.xml.datatype (Java Platform SE 8 )
Keywords: javax.xml.datatype package
Date: 2016-10-23

# Package javax.xml.datatype

XML/Java Type Mappings.

See: Description

- 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.

## Package javax.xml.datatype Description

XML/Java Type Mappings.

`javax.xml.datatype`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 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

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2016, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.