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

Question

摇摇欲坠的版本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文件中

但是，发布日期未出现在swagger文档UI中

区域确实出现在招摇的文档用户界面中

有没有原因不能像这样注释Java对象？

Answer 1

不幸的是，Swagger并不真正支持向嵌套字段添加描述。 请参阅此链接的最后一节以获取有关它的一些背景信息。