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

• 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

Since:

1.5

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 Objects that map XML to/from Java Objects.
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.