如何使用swagger 3.x从源注释生成OAS yaml文件?

如何使用swagger 3.x从源注释生成OAS yaml文件?,swagger,openapi,swagger-codegen,swagger-3.0,swagger-codegen-maven-plugin,Swagger,Openapi,Swagger Codegen,Swagger 3.0,Swagger Codegen Maven Plugin,我花了数小时研究如何使用Java中的swagger codegen生成OAS spec yaml文件,我放弃了。我想以代码注释的形式提供Java源代码中的所有API规范数据。通过maven将其公开会很好 我应该使用AFAIK,但我无法让它扫描源代码以生成OAS yaml或JSON文件 如果您能给我一段pom.xml代码,并提供有效的codegen插件配置,我将不胜感激 也许我应该回到前面的夸夸其谈,因为这个用例是在2.x中直接处理的。现在我对3.x方法感到失望。斯威格Codegen从OpenAP

我花了数小时研究如何使用Java中的swagger codegen生成OAS spec yaml文件,我放弃了。我想以代码注释的形式提供Java源代码中的所有API规范数据。通过maven将其公开会很好

我应该使用AFAIK,但我无法让它扫描源代码以生成OAS yaml或JSON文件

如果您能给我一段pom.xml代码,并提供有效的codegen插件配置,我将不胜感激


也许我应该回到前面的夸夸其谈,因为这个用例是在2.x中直接处理的。现在我对3.x方法感到失望。

斯威格Codegen从OpenAPI文件生成代码。相反,要从Java代码注释生成OpenAPI文件,您需要它的Maven插件

将以下依赖项添加到您的
pom.xml


io.swagger.core.v3
斯威格-jaxrs2
2.0.9
javax.ws.rs
javax.ws.rs-api
2.1
javax.servlet
javax.servlet-api
3.1.0
然后在构建中使用它;配置示例:


io.swagger.core.v3
大摇大摆的maven插件
2.0.9
openapi
${project.build.directory}/generatedtest
${project.basedir}/src/main/resources/configurationFile.yaml
编译
决定

如何在基于Gradle的项目中使用此功能?