昂首阔步的codegen关键字添加

Question

我必须维护一个使用Swagger进行api接口代码生成的项目。 看着model.mustache，我看到了：

{{#models}}                  
{{#model}}{{#description}}   
/**                          
 * {{description}}           
 **/{{/description}}         

以及其他一些关键字，例如enum，defaultValue，vars，package等。这些关键字来自何处？ 我一直在搜寻互联网，以寻找有关此事的详尽文档，但是我什么也找不到。 许多链接指向github上的swagger信息，返回404页。 最后，我想要做的是在我的实际.json文件中拥有一个属性，该属性会被swagger用来生成接口和模型以有条件地生成代码。 我看到有

{{#property}}{{/property}}
{{^property}}{{/property}}

if / else语句的符号，但不适用于我自己的.json的任何属性。 例如，在我的json中，我有一个id字段。 所以如果我想做一个人为的例子

{{#id}}System.out.println(“test test”);{{/id}}

无法使用，因为招摇无法识别id标签。 所以我的问题是，我可以添加这些标签吗？

Answer 1

有很多工具可以帮助您。 如果看到断开的链接，请向swagger-codegen项目提交问题。

从2.1.x-M1开始，swagger-codegen具有非常有用的“调试”模式，该模式可让您列出环境的所有可能值。 您可以按以下方式调用它：

java -DdebugModels -jar {path-to}/swagger-codegen-cli.jar generate {opts}

支持的调试标志是：

-DdebugModels: outputs the variables for each model discovered by codegen
-DdebugOperations: outputs the variables for each operation
-DdebugSupportingFiles: shows supporting file data (anything but models or operations)
-DdebugSwagger: shows the parsed swagger representation

我确实看到自述文件中缺少这些内容。 将确保它们被添加。