ApiModelProperty不能用摇摇欲坠的对象的注释

Question

swagger版本1.5.20

 public class SomeDto extends TemporallyScopedEntityDto {

    @ApiModelProperty(value="This DOES NOT display in swagger ui docs")
    private ZonedDateTimeDto publishDate;

    @ApiModelProperty(value="This DOES display in swagger ui docs")
    private List<CodeTypeDto> territories = new ArrayList<>();
}

两个注释都出现在api-docs json文件中

但是发布日期未出现在招摇的文档用户界面中

领土确实出现在了庄重的文档界面中

是否存在无法像这样注释Java对象的原因

Answer 1

不幸的是，Swagger并不真正支持在嵌套字段中添加描述。 请参阅本link的最后一部分，以获取有关其的一些背景信息。