cjq / jackson-datatype-jdk8 Goto Github PK

Project for Jackson module (jar) that adds supports for JDK datatypes included in version 8 which can not be directly supported by core databind due to baseline being JDK 6, excluding following:

• New Date types are supported by JSR-310 module
• Support for parameter names is via Parameter Names module

As of Jackson 2.5, this module is stable and considered production ready.

To use module on Maven-based projects, use following dependency:

<dependency>
  <groupId>com.fasterxml.jackson.datatype</groupId>
  <artifactId>jackson-datatype-jdk8</artifactId>
  <version>2.6.1</version>
</dependency>    

(or whatever version is most up-to-date at the moment)

Like all standard Jackson modules (libraries that implement Module interface), registration is done as follows:

ObjectMapper mapper = new ObjectMapper();
mapper.registerModule(new Jdk8Module());

after which functionality is available for all normal Jackson operations: you can read JSON into supported JDK8 types, as well as write values of such types as JSON, so that for example:

// TODO: real example
Optional<String> str = ...;
String json = mapper.writeValueAsString(str);

See Wiki for more information (javadocs, downloads).