Добавление параметров запроса в Swagger UI

Question

Я пытаюсь интегрировать Swagger UI 2.6.1 в мой весенний загрузочный проект. На данный момент я получаю страницу, как показано на изображении в ссылке. Как мы видим, у пост-запроса нет примерных параметров запроса.

Мой вопрос заключается в том, как мне добавить этот пример запроса и где эти изменения должны быть сделаны в моем коде Java или в каком-либо файле свойств? Я хочу знать, где и что мне нужно, чтобы добавить параметры запроса, чтобы они отражались в моем представлении?

Answer 1

Если параметрами запроса являются Java 8 Необязательные параметры, тогда в выражениях Swagger они отображаются в пользовательском интерфейсе. Вы должны добавить ".genericModelSubstitutes( Optional.class)" к вашему созданию Docket-Bean:

public Docket sampleApi () {вернуть новый Docket(DocumentationType.SWAGGER_2) .useDefaultResponseMessages(false) .groupName("sample-api") .apiInfo(apiInfo()) .select() .paths(regex("/api.*")) .build() .genericModelSubstitutes(Необязательно.класс); // Добавь это }