时间戳

首页 > 解决方案 > 如何将带有偏移量（“2019-01-29+01:00”）的日期反序列化为“java.time”相关类？

kotlin - 如何将带有偏移量（“2019-01-29+01:00”）的日期反序列化为“java.time”相关类？

问题描述

我在 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: LocalDateJackson 可以成功反序列化，但是偏移信息消失了（我需要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)
}

标签： kotlinjava-8jacksonjsr310java-time

解决方案

正如@JodaStephen 在评论中解释的那样，OffsetDate没有包含在java.time最少的类中。所以，OffsetDateTime是最好的选择。

他还建议使用DateTimeFormatterBuilder和parseDefaulting创建一个DateTimeFormatter实例，直接OffsetDateTime从格式化程序解析结果（TemporalAccessor）创建。AFAIK，我仍然需要创建一个自定义反序列化器来使用格式化程序。这是代码，它解决了我的问题：

class OffsetDateDeserializer: JsonDeserializer<OffsetDateTime>() {

    private val formatter = DateTimeFormatterBuilder()
            .append(DateTimeFormatter.ISO_DATE)
            .parseDefaulting(ChronoField.HOUR_OF_DAY, 0)
            .parseDefaulting(ChronoField.MINUTE_OF_HOUR, 0)
            .parseDefaulting(ChronoField.SECOND_OF_MINUTE, 0)
            .parseDefaulting(ChronoField.MILLI_OF_SECOND, 0)
            .parseDefaulting(ChronoField.OFFSET_SECONDS, 0)
            .toFormatter()


    override fun deserialize(parser: JsonParser, context: DeserializationContext): OffsetDateTime? {
        if (parser.hasToken(JsonToken.VALUE_STRING)) {
            val string = parser.text.trim()
            if (string.isEmpty()) {
                return null
            }
            try {
                return OffsetDateTime.from(formatter.parse(string))
            } catch (e: DateTimeException){
                throw context.wrongTokenException(parser, OffsetDateTime::class.java, parser.currentToken, "error while parsing date: ${e.message}")
            }
        }
        throw context.wrongTokenException(parser, OffsetDateTime::class.java, parser.currentToken, "date with offset must be contained in string")
    }
}

推荐阅读