咨询OpenAPI Generator中Mustache逻辑的获取途径与使用方法

获取完整的Mustache变量/逻辑定义 #

• 查看核心源码类：OpenAPI Generator将OpenAPI规范转换为Java/Kotlin对象（如CodegenOperation、CodegenParameter），所有Mustache模板可用的变量都是这些对象的字段。直接去项目的modules/openapi-generator/src/main/java/org/openapitools/codegen目录下找对应类，比如CodegenOperation类包含httpMethod、operationId、requestBody等字段，Operations则是顶层的操作集合。
• 启用debug模式生成代码：运行生成命令时添加--debug参数，生成目录会多出debug文件夹，里面的JSON文件会列出当前模板可用的所有变量结构，比如debug/operations.json会展示每个操作的httpMethod、requestBody等详细字段。

requestBody的使用示例 #

在模板中可通过条件判断渲染请求体相关逻辑，示例如下：

{{#operation}}
  {{#requestBody}}
    // 渲染带请求体的方法
    public ResponseEntity {{operationId}}({{requestBody.dataType}} {{requestBody.paramName}}) {
        // 处理请求体逻辑
    }
  {{/requestBody}}
  {{^requestBody}}
    // 渲染无请求体的方法
    public ResponseEntity {{operationId}}() {
        // 无请求体逻辑
    }
  {{/requestBody}}
{{/operation}}

常用的requestBody子字段包括dataType（请求体类型）、paramName（参数名）、required（是否必填）等。

实现区块依赖httpMethod的功能 #

利用Mustache的条件判断语法，针对不同HTTP方法渲染专属区块：

{{#operations}}
  {{#httpMethod == 'POST'}}
    // POST请求专属代码块
    @PostMapping("{{path}}")
    public ResponseEntity post{{operationId}}({{>requestBody}}) {
        // POST逻辑
    }
  {{/httpMethod == 'POST'}}

  {{#httpMethod == 'GET'}}
    // GET请求专属代码块
    @GetMapping("{{path}}")
    public ResponseEntity get{{operationId}}({{#parameters}}{{dataType}} {{paramName}}, {{/parameters}}) {
        // GET逻辑
    }
  {{/httpMethod == 'GET'}}
{{/operations}}

也可以拆分到部分模板文件中，比如创建_post.mustache、_get.mustache，再通过条件引入：

{{#operations}}
  {{#httpMethod == 'POST'}}
    {{>_post}}
  {{/httpMethod == 'POST'}}
  {{#httpMethod == 'GET'}}
    {{>_get}}
  {{/httpMethod == 'GET'}}
{{/operations}}

内容的提问来源于stack exchange，提问作者Erik Tellier