javax.xml.datatype

XML/Java Type Mappings.

javax.xml.datatypeAPI 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 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

Factory that creates new javax.xml.datatype Objects that map XML to/from Java Objects.

DatatypeFactory.newInstance() is used to create a new DatatypeFactory. The following implementation resolution mechanisms are used in the following order:

1. If the system property specified by DatatypeFactory.DATATYPEFACTORY_PROPERTY , "javax.xml.datatype.DatatypeFactory", exists, a class with the name of the property's value is instantiated. Any Exception thrown during the instantiation process is wrapped as a DatatypeConfigurationException .
2. If the file ${JAVA_HOME}/lib/jaxp.properties exists, it is loaded in a java.util.Properties Object. The Properties Object is then queried for the property as documented in the prior step and processed as documented in the prior step.
3. The services resolution mechanism is used, e.g.

Immutable representation of a time span as defined in the W3C XML Schema 1.0 specification.

A Duration object represents a period of Gregorian time, which consists of six fields (years, months, days, hours, minutes, and seconds) plus a sign (+/-) field.

The first five fields have non-negative (>=0) integers or null (which represents that the field is not set), and the seconds field has a non-negative decimal or null. A negative sign indicates a negative duration.

This class provides a number of methods that make it easy to use for the duration datatype of XML Schema 1.0 with the errata.

Order relationship

Duration objects only have partial order, where two values A and B maybe either:

1. A<B (A is shorter than B)
2. A>B (A is longer than B)
3. A==B (A and B are of the same duration)
4. A<>B (Comparison between A and B is indeterminate)

For example, 30 days cannot be meaningfully compared to one month. The Duration.compare(Duration duration) method implements this relationship.

See the Duration.isLongerThan(Duration) method for details about the order relationship among Duration objects.

Operations over Duration

This class provides a set of basic arithmetic operations, such as addition, subtraction and multiplication. Because durations don't have total order, an operation could fail for some combinations of operations.

Implements pluggable Datatypes.

This class is duplicated for each JAXP subpackage so keep it in sync.

Representation for W3C XML Schema 1.0 date/time datatypes. Specifically, these date/time datatypes are DatatypeConstants.DATETIME , DatatypeConstants.TIME , DatatypeConstants.DATE , DatatypeConstants.GYEARMONTH , DatatypeConstants.GMONTHDAY , DatatypeConstants.GYEAR , DatatypeConstants.GMONTH , and DatatypeConstants.GDAY defined in the XML Namespace "http://www.w3.org/2001/XMLSchema". These datatypes are normatively defined in W3C XML Schema 1.0 Part 2, Section 3.2.7-14.

The table below defines the mapping between XML Schema 1.0 date/time datatype fields and this class' fields.