springdoc-openapi-generator模板定制

Question

我正在使用 SpringBoot 3.4.1、Java 21.0.5 和 openapi-generator-maven-plugin 版本 7.10.0。 我想自定义 Spring（服务器）生成器模板，为此，我按照官方文档安装 openapi-cli here。

因此，为了获取模板，我输入了以下命令：

openapi-generator-cli author template -g spring --library spring-boot -o mytemplates

上述命令将模板下载到mytemplates文件夹下。我有两个问题：

1. 在其中我只找到了

   *.mustache

   文件，没有

   *.class

   或

   *.java

   文件。正确吗？
2. 我可以在 Maven 构建配置中添加自定义选项并在

   .mustache

   文件中引用它吗？ *1

*1 示例

假设这是我的 openapi-generator-maven-plugin 配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.openapitools</groupId>
            <artifactId>openapi-generator-maven-plugin</artifactId>
            <version>7.10.0</version>
            <executions>
                <execution>
                    <goals>
                        <goal>generate</goal>
                    </goals>
                    <configuration>
                        <inputSpec>${project.basedir}/src/main/resources/api-docs.yaml</inputSpec>
                        <templateResourcePath>${project.basedir}/src/templates/mytemplates</templateResourcePath>
                        <output>${project.build.directory}/generated-sources</output>
                        <generatorName>spring</generatorName>
                        <apiPackage>resources</apiPackage>
                        <modelPackage>model</modelPackage>
                        <generateSupportingFiles>false</generateSupportingFiles>
                        <myCustomProperty>true</myCustomProperty> <!-- my property -->
                        <configOptions>
                            <!-- options -->
                        </configOptions>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

如果我在 Maven 构建配置中定义

<myCustomProperty>

（如上所述）并以这种方式在

*.mustache

文件中引用它：

{{#myCustomProperty}}
  .. do some if myProperty is true!
{{/myCustomProperty}}

会起作用吗？

Answer 1

是的，先生，会的。您的自定义属性将传递到模板，以便您可以通过 Mustache np

引用它

抱歉简短的回答，我得去某个地方，但如果你愿意的话，我会尽力记住回来填写一下，到那时其他人都没有

玩得开心