java openapi生成器复制swagger-ui中的端点

uajslkp6  于 2023-02-18  发布在  Java
关注(0)|答案(1)|浏览(156)

openapi-generator-maven插件(版本6.3.0)在Spring-Boot 3应用程序中配置如下:

<plugin>
                <groupId>org.openapitools</groupId>
                <artifactId>openapi-generator-maven-plugin</artifactId>
                <version>${openapi-maven-plugin.version}</version>
                <executions>
                    <execution>
                        <goals>
                            <goal>generate</goal>
                        </goals>
                        <configuration>
                            <inputSpec>${project.basedir}/src/main/resources/openApi.yaml</inputSpec>
                            <generatorName>spring</generatorName>
                            <apiPackage>com.company.api.v1</apiPackage>
                            <modelPackage>com.company.model.v1</modelPackage>
                            <supportingFilesToGenerate>ApiUtil.java</supportingFilesToGenerate>
                            <configOptions>
                                <delegatePattern>true</delegatePattern>
                                <useSpringBoot3>true</useSpringBoot3>
                            </configOptions>
                        </configuration>
                    </execution>
                </executions>
            </plugin>

并且在Swagger/OpenAPI Yaml文件中仅配置了一个端点:

paths:
  /table:
    get:
      summary: get all trains
      operationId: trainsList
      tags:
        - zuege

这里的问题是在 Swagger UI;端点被复制:

当我删除yaml中的标记时,只有第一个端点可见,但实际上这是一个丑陋的端点,带有生成的描述。当我用<useTags>true</useTags>cf. config)配置它时,两个端点仍然存在,但名称都是zuege
有什么想法如何减少到只有一个端点,但考虑到标签?

6kkfgxo0

6kkfgxo01#

zuege标记也必须添加到根级别,并带有说明,例如:

tags:
  - name: zuege
    description: "Zuege details"

这将创建一个主zuege标签组

相关问题