Package javax.xml.datatype

Defines XML/Java Type Mappings.

This API provides XML/Java type mappings.

The following XML standards apply:

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
Since:
1.5
See Also:
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
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.