swagger-codegen-maven-plugin with springdoc-openapi-ui

Question

我想在使用swagger-codegen-maven-plugin生成的服务中使用springdoc-openapi-ui，但是生成的API使用了错误的包，它使用的是io.swagger.annotations而不是io.swagger.v3.oas.annotations。

我能为此做些什么呢？

import io.swagger.annotations.*;
import ...
@javax.annotation.Generated(value = "io.swagger.codegen.v3.generators.java.SpringCodegen", date = "2019-10-07T13:17:04.413+02:00[Europe/Madrid]")
@Api(value = "randomPet", description = "the randomPet API")
public interface RandomPetApi {
...
}

<plugin>
                    <groupId>io.swagger.codegen.v3</groupId>
                    <artifactId>swagger-codegen-maven-plugin</artifactId>
                    <version>3.0.11</version>
                    <executions>
                        <execution>
                            <id>generate-swagger-spring-boot</id>
                            <phase>none</phase>
                            <goals>
                                <goal>generate</goal>
                            </goals>
                            <configuration>
                                <inputSpec>${swagger-codegen.api.spec}</inputSpec>
                                <language>spring</language>
                                <apiPackage>${project.groupId}.web.api</apiPackage>
                                <modelPackage>${project.groupId}.web.api.model</modelPackage>
                                <generateApiDocumentation>false</generateApiDocumentation>
                                <generateModelTests>false</generateModelTests>
                                <generateModelDocumentation>false</generateModelDocumentation>
                                <additionalProperties>
                                    <java8>true</java8>
                                    <additionalProperty>jackson=true</additionalProperty>
                                </additionalProperties>
                                <library>jersey2</library>
                                <addCompileSourceRoot>true</addCompileSourceRoot>
                                <generateApiTests>false</generateApiTests>
                                <generateModelTests>false</generateModelTests>
                                <configOptions>
                                    <sourceFolder>.</sourceFolder>
                                    <useBeanValidation>true</useBeanValidation>
                                    <performBeanValidation>true</performBeanValidation>
                                    <dateLibrary>java8</dateLibrary>
                                    <delegatePattern>true</delegatePattern>
                                </configOptions>
                            </configuration>
                        </execution>
                    </executions>
</plugin>

Answer 1

我遇到了同样的问题，导致我阅读文档：https://openapi-generator.tech/docs/plugins

通过在我的build.gradle中添加以下行解决了这个问题：

    implementation group: 'io.swagger.parser.v3', name: 'swagger-parser', version: '2.0.20'

希望它能帮助一些人..。

Answer 2

你应该测试一个新版本的swagger-codegen-maven-plugin。我也遇到了同样的问题，3.0.27版本为我解决了这个问题。