javax.xml.datatype (Java Platform SE 7 b138)

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.

Exception Summary
Exception	Description
DatatypeConfigurationException	Indicates a serious configuration error.

Package javax.xml.datatype Description

XML/Java Type Mappings.

javax.xml.datatypeAPI provides XML/Java type mappings.

The following XML standards apply:

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, 2011, Oracle and/or its affiliates. All rights reserved.
DRAFT ea-b138