Eclipse Microprofile を使用する前に、io.openapitools.swagger:swagger-maven-plugin
. このプラグインは、io.swagger.core.v3:swagger-annotations
maven の依存関係に依存しています。
ただし、Eclipse Microprofile には別の依存関係があり、openapitools プラグインには十分ではないようです。そのため、生成された open-api ファイルには、注釈内で提供される説明やその他のデータが含まれていません。
マイクロプロファイルの依存関係を使用してオープン API 定義ファイルを生成する方法を知っていますか?
以下は、openapitools swagger プラグインの構成です。
<plugin>
<groupId>io.openapitools.swagger</groupId>
<artifactId>swagger-maven-plugin</artifactId>
<version>2.1.0</version>
<executions>
<execution>
<id>default</id>
<phase>verify</phase>
<goals>
<goal>generate</goal>
</goals>
<inherited>true</inherited>
<configuration>
<useResourcePackagesChildren>true</useResourcePackagesChildren>
<outputDirectory>${project.build.directory}/open-api/</outputDirectory>
<outputFormats>JSON,YAML</outputFormats>
<prettyPrint>false</prettyPrint>
<resourcePackages>
<resourcePackage>...</resourcePackage>
</resourcePackages>
<outputFilename>...</outputFilename>
</configuration>
</execution>
</executions>