我在 Spring Boot (2.1.2) 系统中重构了一些遗留代码并从java.util.Date
基于java.time
类 (jsr310) 迁移。系统需要 ISO8601 格式字符串中的日期,而有些是带有时间信息的完整时间戳(例如"2019-01-29T15:29:34+01:00"
),而其他只是带有偏移量的日期(例如"2019-01-29+01:00"
)。这是 DTO(作为 Kotlin 数据类):
data class Dto(
// ...
@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd'T'HH:mm:ssXXX")
@JsonProperty("processingTimestamp")
val processingTimestamp: OffsetDateTime,
// ...
@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-ddXXX")
@JsonProperty("orderDate")
val orderDate: OffsetDateTime,
// ...
)
虽然杰克逊完美反序列化processingTimestamp
,但它失败了orderDate
:
Caused by: java.time.DateTimeException: Unable to obtain OffsetDateTime from TemporalAccessor: {OffsetSeconds=32400},ISO resolved to 2018-10-23 of type java.time.format.Parsed
at java.time.OffsetDateTime.from(OffsetDateTime.java:370) ~[na:1.8.0_152]
at com.fasterxml.jackson.datatype.jsr310.deser.InstantDeserializer.deserialize(InstantDeserializer.java:207) ~[jackson-datatype-jsr310-2.9.8.jar:2.9.8]
这对我来说很有意义,因为OffsetDateTime
找不到构建瞬间所需的任何时间信息。如果我更改为val orderDate: LocalDate
Jackson 可以成功反序列化,但是偏移信息消失了(我需要Instant
稍后转换)。
问题
我目前的解决方法是OffsetDateTime
结合使用自定义反序列化器(见下文)。但我想知道,是否有更好的解决方案?
另外,我希望有一个更合适的数据类型,比如OffsetDate,但我在java.time
.
附言
我在问自己“2019-01-29+01:00”是否对 ISO8601 有效。但是,由于我发现它java.time.DateTimeFormatter.ISO_DATE
可以正确解析它并且我无法更改客户端发送数据的格式,所以我搁置了这个问题。
解决方法
data class Dto(
// ...
@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-ddXXX")
@JsonProperty("catchDate")
@JsonDeserialize(using = OffsetDateDeserializer::class)
val orderDate: OffsetDateTime,
// ...
)
class OffsetDateDeserializer(
private val formatter: DateTimeFormatter = DateTimeFormatter.ISO_DATE
) : JSR310DateTimeDeserializerBase<OffsetDateTime>(OffsetDateTime::class.java, formatter) {
override fun deserialize(parser: JsonParser, context: DeserializationContext): OffsetDateTime? {
if (parser.hasToken(JsonToken.VALUE_STRING)) {
val string = parser.text.trim()
if (string.isEmpty()) {
return null
}
val parsed: TemporalAccessor = formatter.parse(string)
val offset = if(parsed.isSupported(ChronoField.OFFSET_SECONDS)) ZoneOffset.from(parsed) else ZoneOffset.UTC
val localDate = LocalDate.from(parsed)
return OffsetDateTime.of(localDate.atStartOfDay(), offset)
}
throw context.wrongTokenException(parser, _valueClass, parser.currentToken, "date with offset must be contained in string")
}
override fun withDateFormat(otherFormatter: DateTimeFormatter?): JsonDeserializer<OffsetDateTime> = OffsetDateDeserializer(formatter)
}