threeten-jaxb: XmlAdapters for ThreeTen

The new Date and Time API introduced in Java 8 (aka JSR-310) was a big step forward compared to what was available before in the JVM standard library. Sadly, Jakarta XML Binding (JAXB) does not speak the new types by default.

This library aims to address this issue by providing a collection of type adapters to enable use of the Java 8 Date and Time API types in JAXB bindings.

In serialization/deserialization logic the library follows the ISO 8601 standard formats wherever applicable.

Version 2 of this library conforms to the new Jakarta XML Binding. If you are still using the old “javax” JAXB, please refer to release 1.2.

Usage

To use this library, define a bindings.xml file with the desired mapping, for example:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<jaxb:bindings version="3.0"
               xmlns:jaxb="https://jakarta.ee/xml/ns/jaxb"
               xmlns:xjc="http://java.sun.com/xml/ns/jaxb/xjc"
               xmlns:xs="http://www.w3.org/2001/XMLSchema">

    <jaxb:globalBindings>
        <xjc:javaType name="java.time.LocalDate"
                      xmlType="xs:date"
                      adapter="io.github.threetenjaxb.core.LocalDateXmlAdapter"/>
    </jaxb:globalBindings>
</jaxb:bindings>

Then use this binding file with your code generation tool, e.g. Jakarta’s wsimport or CXF’s wsdl2java.