Use ISO-8601 dates in JAX-RS responses

Question

I\'m building RESTful web services using Java EE 7 on GlassFish 4. When serializing POJOs containing java.util.Date objects, the timezone information is not inc

Answer 1

This is caused by a bug in MOXy, which is the default JSON (de)serializer for JAX-RS in GlassFish.

The workaround is to switch JSON providers to Jackson.

The first step is to add these dependencies to the build:

    org.glassfish.jersey.media
    jersey-media-json-jackson
    2.8
    provided




    org.codehaus.jackson
    jackson-mapper-asl
    1.9.13
    jar

Next step, add JacksonFeature as a provider, which will replace MOXy as the JSON serializer:

@ApplicationPath("/api/1")
public class ApplicationConfig extends Application {

    @Override
    public Set> getClasses() {
        Set> resources = new java.util.HashSet<>();
        addRestResourceClasses(resources);

        // Add Jackson feature.
        resources.add(org.glassfish.jersey.jackson.JacksonFeature.class);

        return resources;
    }

    private void addRestResourceClasses(Set> resources) {
        // JAX-RS resource classes added here - maintained by NetBeans.
    }
}

The default behaviour of Jackson is to represent java.util.Date in its milliseconds since the epoch form. To change that to ISO-8601:

import java.text.SimpleDateFormat;
import java.util.TimeZone;
import javax.ws.rs.Produces;
import javax.ws.rs.ext.ContextResolver;
import javax.ws.rs.ext.Provider;
import org.codehaus.jackson.map.ObjectMapper;
import org.codehaus.jackson.map.SerializationConfig;

@Provider
@Produces("application/json")
public class JacksonConfigurator implements ContextResolver {

    public JacksonConfigurator() {
        SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSSZ");
        dateFormat.setTimeZone(TimeZone.getTimeZone("UTC"));
        mapper.setDateFormat(dateFormat);
        mapper.configure(SerializationConfig.Feature.WRITE_DATES_AS_TIMESTAMPS, false);
    }

    @Override
    public ObjectMapper getContext(Class clazz) {
        return mapper;
    }

    private final ObjectMapper mapper = new ObjectMapper();
}