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
。
有什么想法如何减少到只有一个端点,但考虑到标签?
1条答案
按热度按时间6kkfgxo01#
zuege标记也必须添加到根级别,并带有说明,例如:
这将创建一个主zuege标签组