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/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.