swagger 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}}

不起作用，因为swagger无法识别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

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