Question

我想将Swagger Codegen用于OpenAPI 3.0 YAML文件。我看到Swagger Codegen 3.0.0-rc0可用。但是当我尝试使用它时，我遇到了问题。以下是详细信息：

我的带有swagger-codegen插件的pom.xml文件：

<plugin>
  <groupId>io.swagger</groupId>
  <artifactId>swagger-codegen-maven-plugin</artifactId>
  <version>3.0.0-rc0</version>
  <executions>
    <execution>
      <goals>
        <goal>generate</goal>
      </goals>
      <configuration>
        <inputSpec>${basedir}/src/main/resources/mySpec.yaml</inputSpec>
        <output>target/generated-sources</output>
        <language>spring</language>
        <generateApis>false</generateApis>
        <modelPackage>com.kj.model</modelPackage>
        <apiPackage>com.kj</apiPackage>
        <configOptions>
          <sourceFolder>swagger</sourceFolder>
          <library>spring-mvc</library>
          <interfaceOnly>true</interfaceOnly>
          <useBeanValidation>true</useBeanValidation>
          <dateLibrary>java8</dateLibrary>
          <java8>true</java8>
        </configOptions>
      </configuration>
    </execution>
  </executions>
</plugin>

使用上面的插件，当我运行maven构建时，我得到了这个ServiceConfigurationError，这里是堆栈跟踪：

Exception in thread "main" java.util.ServiceConfigurationError: io.swagger.codegen.CodegenConfig: Provider io.swagger.codegen.languages.java.JavaClientCodegen not found
    at java.util.ServiceLoader.fail(ServiceLoader.java:239)
    at java.util.ServiceLoader.access$300(ServiceLoader.java:185)
    at java.util.ServiceLoader$LazyIterator.nextService(ServiceLoader.java:372)
    at java.util.ServiceLoader$LazyIterator.next(ServiceLoader.java:404)
    at java.util.ServiceLoader$1.next(ServiceLoader.java:480)
    at io.swagger.codegen.CodegenConfigLoader.forName(CodegenConfigLoader.java:19)
    at io.swagger.codegen.config.CodegenConfigurator.toClientOptInput(CodegenConfigurator.java:392)
    at io.swagger.codegen.plugin.CodeGenMojo.execute(CodeGenMojo.java:512)
    at org.apache.maven.plugin.DefaultBuildPluginManager.executeMojo(DefaultBuildPluginManager.java:134)

为了解决这个问题，我在pom文件的maven插件部分添加了swagger-codegen-generators依赖关系：

<dependencies> <dependency> <groupId>io.swagger</groupId> <artifactId>swagger-codegen-generators</artifactId> <version>1.0.0-SNAPSHOT</version> </dependency> </dependencies>

因此，前面提到的这个问题得到了解决，但现在我看到了这个NPE

java.lang.NullPointerException at io.swagger.codegen.languages.SpringCodegen.preprocessOpenAPI(SpringCodegen.java:429) at io.swagger.codegen.DefaultGenerator.configureGeneratorProperties(DefaultGenerator.java:199) at io.swagger.codegen.DefaultGenerator.generate(DefaultGenerator.java:716) at io.swagger.codegen.plugin.CodeGenMojo.execute(CodeGenMojo.java:534) at org.apache.maven.plugin.DefaultBuildPluginManager.executeMojo(DefaultBuildPluginManager.java:134) at org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java:208) at org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java:154) at org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java:146) at org.apache.maven.lifecycle.internal.LifecycleModuleBuilder.buildProject(LifecycleModuleBuilder.java:117)

正如您已经注意到我使用的是<language>spring</language>和<library>spring-mvc</library>。如果codegen使用这些配置为3.0.0-rc0工作，请告诉我。

注意：我查看过的post旧版view screenshot for the above 2 items here，但当时3.0.0-rc0不可用。

Answer 1

要将Swagger Codegen与Maven插件一起用于OpenAPI 3.0.0规范，您可以考虑使用OpenAPI Generator（这是Swagger Codegen的社区驱动版本）。

<dependency>
    <groupId>org.openapitools</groupId>
    <artifactId>openapi-generator-maven-plugin</artifactId>
    <version>3.3.4</version>
</dependency>

参考：https://github.com/OpenAPITools/openapi-generator#12---artifacts-on-maven-central

（请参阅Q&A我们为什么分叉Swagger Codegen）

Answer 2

2019年4月发布的v3 swagger codegen maven插件根据OpenAPI 3.0规范生成有效的Java客户端库，我正在使用此Maven pom.xml插件配置：

<plugin>
    <groupId>io.swagger.codegen.v3</groupId>
    <artifactId>swagger-codegen-maven-plugin</artifactId>
    <version>3.0.8</version>
    <executions>
    ..

所有其他配置和configOptions条目与版本2.4.5相同。我必须将旧的注释依赖项替换为以下内容，以便客户端代码得以编译：

    <dependency>
        <groupId>io.swagger.core.v3</groupId>
        <artifactId>swagger-annotations</artifactId>
        <version>2.0.8</version>
    </dependency>

HTH

用于OpenAPI 3.0的Swagger Codegen（带有maven插件）

2 个答案: