Создать OpenAPI 3.0 JSON/YAML из источников Spring Application во время компиляции с плагином Maven ⇐ JAVA

[Anonymous]

Я хочу генерировать определение OpenAPI 3.0 во время компиляции, используя плагин Maven, из существующих источников приложений Spring (примечание: не загрузки). < /p>
Я настроил io.swagger .V3.OAS.Annotations в классах контроллеров, таких как SO:

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

package com.acme.rest;

import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.tags.Tag;

@Tag(name = "Dummy Controller", description = "Dummy controller.")
@RestController
@RequestMapping("/api/v1/dummy")
public class DummyController {

@Operation(summary = "dummy(). Does litrally nothing.")
@RequestMapping(value = "/", method = RequestMethod.GET)
public String doStuff() {
return "dummy";
}
}
< /code>
и попробовал Swagger-maven-plugin < /p>

io.swagger.core.v3
swagger-maven-plugin
2.2.0

${project.build.directory}/swagger-def
com.acme
true



compile

resolve

Однако я ничего не получаю, кроме версии openapi .

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

mvn clean compile

, производит:

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

{
"openapi" : "3.0.1"
}
< /code>

Я немного выкопал реализацию, и кажется, что нет io.swager.v3.oas.integration.api.openapireader < /code> и/или io.swagger.v3.oas.integration.api.openapiscanner 

реализация, чтобы фактически поднять соответствующие аннотации и проанализировать их. Я делаю этот вывод из того факта, что, если я добавлю пользовательскую реализацию их, как предложено в документах, которые я могу сгенерировать источники.

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

com.acme.util.SwaggerOpenApiScanner
com.acme.util.SwaggerOpenApiReader

Я просто не понимаю, почему плагин с Swagger не разрабатывает аннотации Swagger, несмотря на то, что они оба из той же группы io.swagger.core.v3 ? Можете ли вы порекомендовать альтернативный плагин для выполнения этой работы?


Подробнее здесь: https://stackoverflow.com/questions/727 ... ile-time-w