public final class JSR310Module
extends com.fasterxml.jackson.databind.module.SimpleModule
ObjectMapper mapper = new ObjectMapper();
mapper.findAndRegisterModules();
ObjectMapper mapper = new ObjectMapper();
mapper.registerModule(new JSR310Module());
SerializationFeature.WRITE_DATES_AS_TIMESTAMPS
feature is enabled, and
otherwise are serialized in standard ISO-8601
string representation. ISO-8601 specifies formats for representing offset dates and times, zoned dates and times,
local dates and times, periods, durations, zones, and more. All JSR-310 types have built-in translation to and from
ISO-8601 formats.SerializationFeature.WRITE_DATE_TIMESTAMPS_AS_NANOSECONDS
and
DeserializationFeature.READ_DATE_TIMESTAMPS_AS_NANOSECONDS
. For serialization,
timestamps are written as fractional numbers (decimals), where the number is seconds and the decimal is fractional
seconds, if WRITE_DATE_TIMESTAMPS_AS_NANOSECONDS is enabled (it is by default), with resolution as fine as
nanoseconds depending on the underlying JDK implementation. If WRITE_DATE_TIMESTAMPS_AS_NANOSECONDS is disabled,
timestamps are written as a whole number of milliseconds. At deserialization time, decimal numbers are always read as
fractional second timestamps with up-to-nanosecond resolution, since the meaning of the decimal is unambiguous. The
more ambiguous integer types are read as fractional seconds without a decimal point if
READ_DATE_TIMESTAMPS_AS_NANOSECONDS is enabled (it is by default), and otherwise they are read as milliseconds.Period
, which always results in an ISO-8601 format because Periods must be represented in years,
months, and/or days.Year
, which only contains a year and cannot be represented with a timestamp.YearMonth
, which only contains a year and a month and cannot be represented with a timestamp.MonthDay
, which only contains a month and a day and cannot be represented with a timestamp.ZoneId
and ZoneOffset
, which do not actually store dates and times but are supported with
this module nonetheless.LocalDate
, LocalTime
, LocalDateTime
, and OffsetTime
, which cannot portably be
converted to timestamps and are instead represented as arrays when WRITE_DATES_AS_TIMESTAMPS is enabled.Constructor and Description |
---|
JSR310Module() |
addAbstractTypeMapping, addDeserializer, addKeyDeserializer, addKeySerializer, addSerializer, addSerializer, addValueInstantiator, getModuleName, registerSubtypes, registerSubtypes, setAbstractTypes, setDeserializerModifier, setDeserializers, setKeyDeserializers, setKeySerializers, setMixInAnnotation, setNamingStrategy, setSerializerModifier, setSerializers, setupModule, setValueInstantiators, version
Copyright © 2014 FasterXML. All Rights Reserved.