## Package javax.xml.datatype

XML/Java Type Mappings.

See:
Description

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

Copyright © 1999-2007 The Apache Software Foundation. All Rights Reserved.