无法从 OpenAPI 客户端中的字符串反序列化类型为“java.time.OffsetDateTime”的值
Cannot deserialize value of type `java.time.OffsetDateTime` from String in openapi client
我有一个 spring 引导应用程序，其中包含一个通过 gradle 插件生成的 java 客户端：
openApiGenerate {
generatorName = "java"
inputSpec = specsYml
outputDir = "$buildDir/generated".toString()
apiPackage = "com.customapi.api"
invokerPackage = "com.customapi.invoker"
modelPackage = "com.customapi.model"
configOptions = [
dateLibrary: "java8",
library : "resttemplate"
]
}
我选择 "java8" 作为 dateLibrary 因为这似乎是 java 1.8.
项目的首选
使用生成的客户端，我正在执行 returns 一个包含时间戳的对象的请求。
我收到以下错误：
java.lang.IllegalStateException: Failed to execute CommandLineRunner
...
Caused by: org.springframework.web.client.RestClientException: Error while extracting response for type [class com.customapi.model.Info] and content type [application/json];
...
Caused by: org.springframework.http.converter.HttpMessageNotReadableException: JSON parse error: Cannot deserialize value of type `java.time.OffsetDateTime` from String "2020-07-21T12:12:23.000+0200": ...
...
...
Caused by: com.fasterxml.jackson.databind.exc.InvalidFormatException: Cannot deserialize value of type `java.time.OffsetDateTime` from String "2020-07-21T12:12:23.000+0200": Failed to deserialize java.time.OffsetDateTime: (java.time.format.DateTimeParseException) Text '2020-07-21T12:12:23.000+0200' could not be parsed at index 23
at [Source: (ByteArrayInputStream); line: 1, column: 84] (through reference chain: com.customapi.model.Info["buildTimestamp"])
at com.fasterxml.jackson.databind.exc.InvalidFormatException.from(InvalidFormatException.java:67) ~[jackson-databind-2.10.3.jar:2.10.3]
at com.fasterxml.jackson.databind.DeserializationContext.weirdStringException(DeserializationContext.java:1679) ~[jackson-databind-2.10.3.jar:2.10.3]
at com.fasterxml.jackson.databind.DeserializationContext.handleWeirdStringValue(DeserializationContext.java:935) ~[jackson-databind-2.10.3.jar:2.10.3]
at com.fasterxml.jackson.datatype.jsr310.deser.JSR310DeserializerBase._handleDateTimeException(JSR310DeserializerBase.java:86) ~[jackson-datatype-jsr310-2.10.3.jar:2.10.3]
at com.fasterxml.jackson.datatype.jsr310.deser.InstantDeserializer.deserialize(InstantDeserializer.java:218) ~[jackson-datatype-jsr310-2.10.3.jar:2.10.3]
at com.fasterxml.jackson.datatype.jsr310.deser.InstantDeserializer.deserialize(InstantDeserializer.java:50) ~[jackson-datatype-jsr310-2.10.3.jar:2.10.3]
at com.fasterxml.jackson.databind.deser.impl.MethodProperty.deserializeAndSet(MethodProperty.java:129) ~[jackson-databind-2.10.3.jar:2.10.3]
at com.fasterxml.jackson.databind.deser.BeanDeserializer.deserializeFromObject(BeanDeserializer.java:369) ~[jackson-databind-2.10.3.jar:2.10.3]
at com.fasterxml.jackson.databind.deser.BeanDeserializer.deserialize(BeanDeserializer.java:159) ~[jackson-databind-2.10.3.jar:2.10.3]
at com.fasterxml.jackson.databind.ObjectMapper._readMapAndClose(ObjectMapper.java:4218) ~[jackson-databind-2.10.3.jar:2.10.3]
at com.fasterxml.jackson.databind.ObjectMapper.readValue(ObjectMapper.java:3267) ~[jackson-databind-2.10.3.jar:2.10.3]
at org.springframework.http.converter.json.AbstractJackson2HttpMessageConverter.readJavaType(AbstractJackson2HttpMessageConverter.java:269) ~[spring-web-5.2.7.RELEASE.jar:5.2.7.RELEASE]
... 17 common frames omitted
Caused by: java.time.format.DateTimeParseException: Text '2020-07-21T12:12:23.000+0200' could not be parsed at index 23
at java.time.format.DateTimeFormatter.parseResolved0(DateTimeFormatter.java:1949) ~[na:1.8.0_151]
at java.time.format.DateTimeFormatter.parse(DateTimeFormatter.java:1777) ~[na:1.8.0_151]
at com.fasterxml.jackson.datatype.jsr310.deser.InstantDeserializer.deserialize(InstantDeserializer.java:212) ~[jackson-datatype-jsr310-2.10.3.jar:2.10.3]
... 24 common frames omitted
问题Infoclass的相关部分：
...
@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", date = "2020-07-26T14:09:54.137+02:00[Europe/Berlin]")
public class Info {
...
public static final String JASON_PROPERTY_BUILD_TIMESTAMP = "buildTimestamp";
private OffsetDateTime buildTimestamp;
...
public Info buildTimestamp(OffsetDateTime buildTimestamp) {
this.buildTimestamp = buildTimestamp;
return this;
}
public void setBuildTimestamp(OffsetDateTime buildTimestamp) {
this.buildTimestamp = buildTimestamp;
}
...
}
两个 setter 方法都接受 OffsetDateTime 对象并且没有注释，因此转换必须发生在别处。输入字符串再次为“2020-07-21T12:12:23.000+0200”。
相关依赖项是
ext {
swagger_annotations_version = "1.5.22"
jackson_version = "2.10.3"
jackson_databind_version = "2.10.3"
jackson_databind_nullable_version = "0.2.1"
}
dependencies {
compile "io.swagger:swagger-annotations:$swagger_annotations_version"
compile "com.fasterxml.jackson.core:jackson-core:$jackson_version"
compile "com.fasterxml.jackson.core:jackson-annotations:$jackson_version"
compile "com.fasterxml.jackson.core:jackson-databind:$jackson_databind_version"
compile "com.fasterxml.jackson.jaxrs:jackson-jaxrs-json-provider:$jackson_version"
compile "org.openapitools:jackson-databind-nullable:$jackson_databind_nullable_version"
compile "com.fasterxml.jackson.datatype:jackson-datatype-jsr310:$jackson_version"
}
jackson 和 java8 似乎有很多问题，而且该站点上的大多数解决方案似乎都添加了注释。但我怀疑修改生成的代码是正确的解决方案。我在生成客户端时是否忽略了一个重要参数？服务器是否提供了错误的格式？我该如何调查？
更新：
当我将 dateLibrary 切换到 legacy 时它起作用了，所以我认为我收到了正确的数据。
(jaxrs) 服务器生成器 https://github.com/swagger-api/swagger-codegen/issues/3648#issuecomment-244056314 中存在错误，导致服务器发送格式错误（没有冒号）date-time。我的解决方案是为可以处理错误格式的客户端使用旧版 dateLibrary。
根据我对问题的评论，我意识到您不需要 Jackson 注释。您只需要调整 setter。这是一个基本演示：
假设以下 class：
import java.time.OffsetDateTime;
//import com.fasterxml.jackson.annotation.JsonSetter;
import java.time.format.DateTimeFormatter;
public class MyOdt {
private OffsetDateTime odt;
public OffsetDateTime getOdt() {
return odt;
}
//@JsonSetter("odt")
public void setOdt(String odtString) {
final String pattern = "yyyy-MM-dd'T'HH:mm:ss.SSSxx";
DateTimeFormatter dtfB = DateTimeFormatter.ofPattern(pattern);
this.odt = OffsetDateTime.parse(odtString, dtfB);
}
}
class 将从这样的 JSON 片段创建：
String jsonTest = "{ \"odt\" : \"2020-07-21T12:12:23.000+0200\" }";
对象映射器：
ObjectMapper objectMapper = new ObjectMapper()
.registerModule(new JavaTimeModule())
.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);
MyOdt odtTest = objectMapper.readValue(jsonTest, MyOdt.class);
作为参考，这里是问题中的原始评论：
An observation: That is not a valid string to be parsed by OffsetDateTime.parse() because the default datetime format expects the offset to have a colon in it: +02:00. So, this works: OffsetDateTime.parse("2020-07-21T12:12:23.000+02:00")
我从 dateLibrary 切换到 java8-localdatetime
得到了帮助
另见 here。
我有一个 spring 引导应用程序，其中包含一个通过 gradle 插件生成的 java 客户端：
openApiGenerate {
generatorName = "java"
inputSpec = specsYml
outputDir = "$buildDir/generated".toString()
apiPackage = "com.customapi.api"
invokerPackage = "com.customapi.invoker"
modelPackage = "com.customapi.model"
configOptions = [
dateLibrary: "java8",
library : "resttemplate"
]
}
我选择 "java8" 作为 dateLibrary 因为这似乎是 java 1.8.
使用生成的客户端，我正在执行 returns 一个包含时间戳的对象的请求。 我收到以下错误：
java.lang.IllegalStateException: Failed to execute CommandLineRunner
...
Caused by: org.springframework.web.client.RestClientException: Error while extracting response for type [class com.customapi.model.Info] and content type [application/json];
...
Caused by: org.springframework.http.converter.HttpMessageNotReadableException: JSON parse error: Cannot deserialize value of type `java.time.OffsetDateTime` from String "2020-07-21T12:12:23.000+0200": ...
...
...
Caused by: com.fasterxml.jackson.databind.exc.InvalidFormatException: Cannot deserialize value of type `java.time.OffsetDateTime` from String "2020-07-21T12:12:23.000+0200": Failed to deserialize java.time.OffsetDateTime: (java.time.format.DateTimeParseException) Text '2020-07-21T12:12:23.000+0200' could not be parsed at index 23
at [Source: (ByteArrayInputStream); line: 1, column: 84] (through reference chain: com.customapi.model.Info["buildTimestamp"])
at com.fasterxml.jackson.databind.exc.InvalidFormatException.from(InvalidFormatException.java:67) ~[jackson-databind-2.10.3.jar:2.10.3]
at com.fasterxml.jackson.databind.DeserializationContext.weirdStringException(DeserializationContext.java:1679) ~[jackson-databind-2.10.3.jar:2.10.3]
at com.fasterxml.jackson.databind.DeserializationContext.handleWeirdStringValue(DeserializationContext.java:935) ~[jackson-databind-2.10.3.jar:2.10.3]
at com.fasterxml.jackson.datatype.jsr310.deser.JSR310DeserializerBase._handleDateTimeException(JSR310DeserializerBase.java:86) ~[jackson-datatype-jsr310-2.10.3.jar:2.10.3]
at com.fasterxml.jackson.datatype.jsr310.deser.InstantDeserializer.deserialize(InstantDeserializer.java:218) ~[jackson-datatype-jsr310-2.10.3.jar:2.10.3]
at com.fasterxml.jackson.datatype.jsr310.deser.InstantDeserializer.deserialize(InstantDeserializer.java:50) ~[jackson-datatype-jsr310-2.10.3.jar:2.10.3]
at com.fasterxml.jackson.databind.deser.impl.MethodProperty.deserializeAndSet(MethodProperty.java:129) ~[jackson-databind-2.10.3.jar:2.10.3]
at com.fasterxml.jackson.databind.deser.BeanDeserializer.deserializeFromObject(BeanDeserializer.java:369) ~[jackson-databind-2.10.3.jar:2.10.3]
at com.fasterxml.jackson.databind.deser.BeanDeserializer.deserialize(BeanDeserializer.java:159) ~[jackson-databind-2.10.3.jar:2.10.3]
at com.fasterxml.jackson.databind.ObjectMapper._readMapAndClose(ObjectMapper.java:4218) ~[jackson-databind-2.10.3.jar:2.10.3]
at com.fasterxml.jackson.databind.ObjectMapper.readValue(ObjectMapper.java:3267) ~[jackson-databind-2.10.3.jar:2.10.3]
at org.springframework.http.converter.json.AbstractJackson2HttpMessageConverter.readJavaType(AbstractJackson2HttpMessageConverter.java:269) ~[spring-web-5.2.7.RELEASE.jar:5.2.7.RELEASE]
... 17 common frames omitted
Caused by: java.time.format.DateTimeParseException: Text '2020-07-21T12:12:23.000+0200' could not be parsed at index 23
at java.time.format.DateTimeFormatter.parseResolved0(DateTimeFormatter.java:1949) ~[na:1.8.0_151]
at java.time.format.DateTimeFormatter.parse(DateTimeFormatter.java:1777) ~[na:1.8.0_151]
at com.fasterxml.jackson.datatype.jsr310.deser.InstantDeserializer.deserialize(InstantDeserializer.java:212) ~[jackson-datatype-jsr310-2.10.3.jar:2.10.3]
... 24 common frames omitted
问题Infoclass的相关部分：
...
@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", date = "2020-07-26T14:09:54.137+02:00[Europe/Berlin]")
public class Info {
...
public static final String JASON_PROPERTY_BUILD_TIMESTAMP = "buildTimestamp";
private OffsetDateTime buildTimestamp;
...
public Info buildTimestamp(OffsetDateTime buildTimestamp) {
this.buildTimestamp = buildTimestamp;
return this;
}
public void setBuildTimestamp(OffsetDateTime buildTimestamp) {
this.buildTimestamp = buildTimestamp;
}
...
}
两个 setter 方法都接受 OffsetDateTime 对象并且没有注释，因此转换必须发生在别处。输入字符串再次为“2020-07-21T12:12:23.000+0200”。
相关依赖项是
ext {
swagger_annotations_version = "1.5.22"
jackson_version = "2.10.3"
jackson_databind_version = "2.10.3"
jackson_databind_nullable_version = "0.2.1"
}
dependencies {
compile "io.swagger:swagger-annotations:$swagger_annotations_version"
compile "com.fasterxml.jackson.core:jackson-core:$jackson_version"
compile "com.fasterxml.jackson.core:jackson-annotations:$jackson_version"
compile "com.fasterxml.jackson.core:jackson-databind:$jackson_databind_version"
compile "com.fasterxml.jackson.jaxrs:jackson-jaxrs-json-provider:$jackson_version"
compile "org.openapitools:jackson-databind-nullable:$jackson_databind_nullable_version"
compile "com.fasterxml.jackson.datatype:jackson-datatype-jsr310:$jackson_version"
}
jackson 和 java8 似乎有很多问题，而且该站点上的大多数解决方案似乎都添加了注释。但我怀疑修改生成的代码是正确的解决方案。我在生成客户端时是否忽略了一个重要参数？服务器是否提供了错误的格式？我该如何调查？
更新：
当我将 dateLibrary 切换到 legacy 时它起作用了，所以我认为我收到了正确的数据。
(jaxrs) 服务器生成器 https://github.com/swagger-api/swagger-codegen/issues/3648#issuecomment-244056314 中存在错误，导致服务器发送格式错误（没有冒号）date-time。我的解决方案是为可以处理错误格式的客户端使用旧版 dateLibrary。
根据我对问题的评论，我意识到您不需要 Jackson 注释。您只需要调整 setter。这是一个基本演示：
假设以下 class：
import java.time.OffsetDateTime;
//import com.fasterxml.jackson.annotation.JsonSetter;
import java.time.format.DateTimeFormatter;
public class MyOdt {
private OffsetDateTime odt;
public OffsetDateTime getOdt() {
return odt;
}
//@JsonSetter("odt")
public void setOdt(String odtString) {
final String pattern = "yyyy-MM-dd'T'HH:mm:ss.SSSxx";
DateTimeFormatter dtfB = DateTimeFormatter.ofPattern(pattern);
this.odt = OffsetDateTime.parse(odtString, dtfB);
}
}
class 将从这样的 JSON 片段创建：
String jsonTest = "{ \"odt\" : \"2020-07-21T12:12:23.000+0200\" }";
对象映射器：
ObjectMapper objectMapper = new ObjectMapper()
.registerModule(new JavaTimeModule())
.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);
MyOdt odtTest = objectMapper.readValue(jsonTest, MyOdt.class);
作为参考，这里是问题中的原始评论：
An observation: That is not a valid string to be parsed by
OffsetDateTime.parse()because the default datetime format expects the offset to have a colon in it:+02:00. So, this works:OffsetDateTime.parse("2020-07-21T12:12:23.000+02:00")
我从 dateLibrary 切换到 java8-localdatetime
另见 here。