Как создать документацию Swagger v3 в формате JSON или YAML? ⇐ JAVA

[Anonymous]

Я использую аннотации Swagger v3 для документирования маршрутов моего контроллера, например:

Код: Выделить всё

@OpenAPIDefinition(info =
@Info(title = "swagger-spring",
description = "testing swagger in a spring environment",
version = "0.1",
contact = @Contact(name = "Thilo Schwarz",
email = "osp (at) domain.codes",
url = "https://domain.codes")))
public class Controller {

@Operation(summary = "Says hello.")
@ApiResponses(value = {
@ApiResponse(responseCode = "200",
description = "Just returns 'hello'.",
content = @Content(mediaType = "text/plain",
examples = {@ExampleObject(value = "HELLO!") })) })
public String hello() {
return "HELLO!";
}
}

В моем pom я использую следующие настройки плагина:

Код: Выделить всё

            
io.openapitools.swagger
swagger-maven-plugin
2.1.6


codes.thischwa.swagger

${project.build.directory}/
openapi
JSON,YAML
true



generate-openapi
integration-test

generate





io.swagger.core.v3
swagger-jaxrs2
2.2.2


javax.ws.rs
javax.ws.rs-api
2.1


javax.servlet
javax.servlet-api
3.1.0

Если я вызываю mvn-интеграционный тест, я получаю следующую ошибку:

[ ОШИБКА] Не удалось выполнить цель io.openapitools.swagger:swagger-maven-plugin:2.1.6:generate (generate-openapi) в проекте swagger-spring: Выполнение генерировать-openapi цели io.openapitools.swagger:swagger-maven-plugin:2.1.6:сбой создания: Подтипы сканераСканер не настроен -> [Справка 1]

I думаю, я пропустил некоторые настройки конфигурации. Но какой? Я не смог найти никаких подсказок на веб-сайте разработчика.
Обновление:
Возможная обнаружена ошибка: https:/ /github.com/openapi-tools/swagger-maven-plugin/issues/96

Подробнее здесь: https://stackoverflow.com/questions/738 ... on-or-yaml