2

我有一个使用 OpenaAPI v3 规范的 API 定义的 Maven 项目。

我使用 openapi-generator-maven-plugin 生成代码，一切正常。我还可以访问 swagger-ui 并查看和测试我的 API。

问题是我不想两次维护版本号。因此，我想在我的 api 规范中引用我的 maven pom 中的版本号，而不是复制它而冒着过时的风险。

我已经尝试过 Maven 资源过滤，这似乎有效。由于当我在规范中输入版本字段时，目标文件夹中的 yaml 文件得到了很好的替换${project.version}，但是当我打开 swagger-ui 时，它会按字面意思打印“$ {project.version}”而不是实际版本。

这是我的 pom 中的插件配置：

<build>
      <resources>
        <resource>
          <directory>src/main/resources</directory>
          <filtering>true</filtering>
        </resource>
      </resources>
      <plugins>
        <plugin>
          <groupId>org.openapitools</groupId>
          <artifactId>openapi-generator-maven-plugin</artifactId>
          <version>${openapi-generator-maven-plugin.version}</version>
          <executions>
            <execution>
              <goals>
                <goal>generate</goal>
              </goals>
              <configuration>
                <inputSpec>${project.build.resources[0].directory}/spec.yml</inputSpec>
                <ignoreFileOverride>${project.build.resources[0].directory}/.openapi-codegen-ignore</ignoreFileOverride>
                <language>spring</language>
                <library>spring-boot</library>
                <configOptions>
                  <!-- Use the newer java.time package instead of outdated java.util-->
                  <dateLibrary>java8</dateLibrary>
                </configOptions>
                <apiPackage>${default.package}.api</apiPackage>
                <modelPackage>${default.package}.model</modelPackage>
                <invokerPackage>${default.package}.invoker</invokerPackage>
                <generateApiTests>false</generateApiTests>
              </configuration>
            </execution>
          </executions>
       </plugin>
       ...
    </plugins>
</build>

这是我的 spec.yml：

openapi: 3.0.0
info:
  version: ${project.version}
...
4

1 回答 1

4

感谢@bcoughlan 的评论，我能够让 maven-resources-plugin 按需要工作。

现在它需要过滤 src/main/resources 文件夹中的 *yml 文件，并在该generates-sources阶段替换 ${project.version} 占位符。因为openapi-generator-maven-plugin是同阶段执行的，而且是后面定义的，所以会在资源过滤后执行，会在target文件夹下的api spec上操作，结果是${project.build.outputDirectory}/spec.yml

      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-resources-plugin</artifactId>
        <version>3.1.0</version>
        <configuration>
          <resources>
            <resource>
              <directory>src/main/resources</directory>
              <filtering>true</filtering>
            </resource>
          </resources>
        </configuration>
        <executions>
          <execution>
            <phase>generate-sources</phase>
            <goals>
              <goal>resources</goal>
            </goals>
          </execution>
        </executions>
      </plugin>
      <!-- Codegen plugin for api. Depends on maven-resources-plugin to have executed in the generate-sources phase! -->
      <plugin>
        <groupId>org.openapitools</groupId>
        <artifactId>openapi-generator-maven-plugin</artifactId>
        <version>${openapi-generator-maven-plugin.version}</version>
        <executions>
          <execution>
            <goals>
              <goal>generate</goal>
            </goals>
            <configuration>
                <inputSpec>${project.build.outputDirectory}/spec.yml</inputSpec>
                <ignoreFileOverride>${project.basedir}/.openapi-codegen-ignore</ignoreFileOverride>
              <language>spring</language>
              <library>spring-boot</library>
              <configOptions>
                <!-- Use the newer java.time package instead of outdated java.util-->
                <dateLibrary>java8</dateLibrary>
              </configOptions>
              <apiPackage>${default.package}.api</apiPackage>
              <modelPackage>${default.package}.model</modelPackage>
              <invokerPackage>${default.package}.invoker</invokerPackage>
              <generateApiTests>false</generateApiTests>
            </configuration>
          </execution>
        </executions>
      </plugin>

注意：openapi-generator-maven-plugin 与 swagger-codegen-maven-plugin 几乎相同。更多关于差异的信息可以在这里找到：https ://openapi-generator.tech/docs/fork-qna

注意 2：当使用spring-boot父 pom 时，您继承 resource.delmeter=@ 属性并且${project.version}符号不再起作用。所以用占位符替换@project.version@应该可以解决这个问题。

于 2019-09-09T14:49:35.623 回答