Swagger：结构错误应该具有必需的属性'paths'缺失属性：路径 - 将公共组件提取到外部 swagger 文件

Question

我有几个yaml文件，其中许多组件是相同的。例如，我有 10 个 Language.java 文件，其中包含不同包中的类，因此我无法在代码中编写通用转换器，并且在项目中有一些复制粘贴代码。有可能以某种方式做到这一点吗？

此外，我正在使用Java 8和Maven从swagger文件生成java代码：

<plugins>
<plugin>
<groupId>org.openapitools</groupId>
<artifactId>openapi-generator-maven-plugin</artifactId>
<version>${openapi-generator.version}</version>
<executions>
<execution>
<id>commons</id>
<goals>
<goal>generate</goal>
</goals>
<configuration>
<inputSpec>${project.basedir}/src/main/resources/common.yaml</inputSpec>
<generatorName>spring</generatorName>
<apiPackage>mypackage.api</apiPackage>
<modelPackage>mypackage.model</modelPackage>
<configOptions>
<dateLibrary>java8</dateLibrary>
<interfaceOnly>true</interfaceOnly>
</configOptions>
</configuration>
</execution>
<execution>
<id>forms</id>
<goals>
<goal>generate</goal>
</goals>
<configuration>
<inputSpec>${project.basedir}/src/main/resources/a.yaml</inputSpec>
<generatorName>spring</generatorName>
<apiPackage>mypackage.a.api</apiPackage>
<modelPackage>mypackage.a.model</modelPackage>
<configOptions>
<dateLibrary>java8</dateLibrary>
<interfaceOnly>true</interfaceOnly>
</configOptions>
</configuration>
</execution>
PLENTY OF OTHER YAML FILES AND PACKAGES GENERATING THE SAME COMMON CLASSES like Languages

招摇：

openapi: "3.0.0"
info:
version: 1.0.0
title: Swagger Commons
components:
schemas:
Languages:
type: array
items:
type: string

但这并不能在大摇大摆的 io 中验证为路径

结构错误应具有必需的属性"路径" 缺少属性：路径

Answer 1

正如消息所说，您的 swagger 文件应该具有path属性。