Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| JavaTM 2 Platform Standard Ed. 5.0
PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES

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

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| JavaTM 2 Platform Standard Ed. 5.0
PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.