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<>();
}

Обе аннотации появляются в ji-файле api-docs

Однако Дата публикации не отображается в пользовательском интерфейсе документации Swagger

Территории отображаются в пользовательском интерфейсе Swagger Docs

Есть ли причина, по которой java-объект не может быть аннотирован подобным образом?

Answer 1

К сожалению, Swagger не поддерживает добавление описания во вложенные поля. См. Последний раздел этой ссылки , чтобы получить некоторую справочную информацию об этом.