开源软件名称（OpenSource Name）：openapi-tools/swagger-maven-plugin开源软件地址(OpenSource Url)：https://github.com/openapi-tools/swagger-maven-plugin开源编程语言(OpenSource Language)：Java 100.0%开源软件介绍(OpenSource Introduction)：Swagger Maven PluginThis plugin is intended to use the Swagger Core library to generate OpenAPI documentation from a JAX-RS based REST service with as little change as possible. This allows for @SwaggerDefinition, @ReaderListener and ModelConverters to work the same way as with the core Swagger library. StatusThe plugin is considered production ready. The version 2.x.x of the plugin is supporting generation of OpenAPI version 3 specifications using Swagger 2.x. To generate OpenAPI version 2 specifications using Swagger 1.x use the latest 1.x.x version of the plugin.
UsageTo have Swagger generate the OpenAPI specifications as part of the build add in the plugin to the POM. <build>
<plugins>
...
<plugin>
<groupId>io.openapitools.swagger</groupId>
<artifactId>swagger-maven-plugin</artifactId>
<configuration>
<resourcePackages>
<resourcePackage>io.openapitools.swagger.example</resourcePackage>
<resourcePackage>io.openapitools.swagger.example.alternate</resourcePackage>
</resourcePackages>
<outputDirectory>${basedir}/target/</outputDirectory>
<outputFilename>swagger</outputFilename>
<outputFormats>JSON,YAML</outputFormats>
<prettyPrint>true</prettyPrint>
</configuration>
<executions>
<execution>
<goals>
<goal>generate</goal>
</goals>
</execution>
</executions>
</plugin>
...
</plugins>
</build>This will run the generation in the prepare-package lifecycle stage of the Maven build. Specifying Packages with JAX-RS EndpointsThe packages containing JAX-RS endpoints must be configured using the resourcePackages element. See the minimal configuration above. Properties of Swagger modelMost general properties of the Swagger model is configurable using the swaggerConfig element. Note this may also be configured through the @OpenAPIDefinition annotation - see Customizing your auto-generated Swagger Definitions. <plugin>
<groupId>io.openapitools.swagger</groupId>
<artifactId>swagger-maven-plugin</artifactId>
<configuration>
<swaggerConfig>
<servers>
<server>
<url>https://services.exmple.it/base/path</url>
<description>Endpoint URL</description>
</server>
</servers>
<info>
<title>Title</title>
<version>1.0.0</version>
<termsOfService>Terms</termsOfService>
<contact>
<email>e@mail.com</email>
<name>My Name</name>
<url>https://google.com</url>
</contact>
<license>
<url>https://license</url>
<name>MIT</name>
</license>
<extensions>
<x-custom-field-1>my-custom-field-1</x-custom-field-1>
<x-custom-field-2>my-custom-field-2</x-custom-field-2>
</extensions>
</info>
<descriptionFile>src/test/resources/descriptions.md</descriptionFile>
</swaggerConfig>DeployingThe generated OpenAPI specifications may be installed and deployed as Maven artifact. To enable this add the configuration parameter attachSwaggerArtifact. <plugin>
<groupId>io.openapitools.swagger</groupId>
<artifactId>swagger-maven-plugin</artifactId>
<configuration>
<attachSwaggerArtifact>true</attachSwaggerArtifact>AcknowledgementThanks to Yukai Kong for his work on Swagger Maven plugin. This plugin is heavily inspired by that. 
|
2023-10-27
2022-08-15
2022-08-17
2022-09-23
2022-08-13
六六分期app的软件客服如何联系？不知道吗？加qq群【895510560】即可！标题：六六分期
今天小编告诉大家如何处理win10系统火狐flash插件总是崩溃的问题，可能很多用户都不知
今天小编告诉大家如何对win10系统删除桌面回收站图标进行设置，可能很多用户都不知道
今天小编告诉大家如何对win10系统电脑设置节能降温的设置方法，想必大家都遇到过需要
我们在使用xp系统的过程中,经常需要对xp系统无线网络安装向导设置进行设置，可能很多
今天小编告诉大家如何处理win7系统玩cf老是与主机连接不稳定的问题，可能很多用户都不
电脑对日常生活的重要性小编就不多说了，可是一旦碰到win7系统设置cf烟雾头的问题，很
我们在日常使用电脑的时候，有的小伙伴们可能在打开应用的时候会遇见提示应用程序无法
今天小编告诉大家如何对win7系统打开vcf文件进行设置，可能很多用户都不知道怎么对win
今天小编告诉大家如何对win10系统s4开启USB调试模式进行设置，可能很多用户都不知道怎
请发表评论