Swagger Codegen (с плагином maven) для OpenAPI 3.0

Я хочу использовать Swagger Codegen для файла YAML OpenAPI 3.0. И я вижу, что Swagger Codegen 3.0.0-rc0 доступен. Но когда я пытаюсь использовать это, я сталкиваюсь с проблемами. Ниже приведены подробности:

мой pom.xml файл с плагином swagger-codegen:

<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)

Чтобы это исправить я добавил swagger-codegen-generators зависимость в разделе плагинов maven файла pom:

<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 с этими конфигурациями.

Примечание: я посмотрел этот старый пост, который похож, но в то время 3.0.0-rc0 был недоступен

Источник

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.0.0</version>
</dependency>

Ссылка: https://github.com/OpenAPITools/openapi-generator

(пожалуйста, обратитесь к разделу вопросов и ответов о том, почему мы раздвоили кодекс Swagger)

Источник

Плагин v3 swagger codegen maven, выпущенный в апреле 2019 года, генерирует рабочие клиентские библиотеки Java из спецификации OpenAPI 3.0, я использую следующую конфигурацию плагина 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>

НТН

Источник
Другие вопросы по тегам