使用ZoneId和jackson-datatype-jsr310时，Swagger UI显示嵌套的模型对象

Question

我正在用spring、springfox、jackson开发一个REST API，我的model类包含一个ZoneID属性：

@JsonProperty
private ZoneId timeZone;

我在依赖项中包含了jackson-datatype-jsr310版本2.9.0.pr4，因此它的序列化和反序列化很好。但是我的swagger-ui现在显示了很多模型对象，比如zoneID、zoneoffset、zoneoffsettransition等等，这非常混乱，因为zone ID是序列化为简单字符串的。生成的API规范中的情况相同。我如何防止大摇大摆地公开这些（未使用的）模型对象？

Answer 1

您可以尝试@apimodelproperty将数据类型设置为字符串:

@JsonProperty
@ApiModelProperty(dataType = "string")
private ZoneId timeZone;

如果数据类型被忽略，则可以使用docket:

@Bean
public Docket configureDocket() {
    return new Docket(DocumentationType.SWAGGER_2)
            .directModelSubstitute(ZoneId .class, String.class);
}