swagger - Swagger ... 从 Mustache 访问查询参数属性

Question

我使用 Mustache 和 swagger-codegen 从定义生成模型实体，并从操作（路径部分）生成代码。每个操作指定一个参数列表和其他参数属性 - 数据类型、描述、默认值、必需、最大值、示例等。

除了“必需”属性之外，我无法弄清楚如何访问任何参数属性......除了在“模型”阶段......我如何在“api”阶段做到这一点？...我希望能够删除验证参数是否满足“必需”之外的条件的代码，例如最小/最大等。

Answer 1

您有一些访问参数属性的选项。

首先，我假设您使用的是 swagger-codegen 2.1.0-M2 或更高版本的快照。每个参数都有许多可用的属性，但它们目前还没有模型属性那么丰富。

要查看您可以访问的内容，请使用调试标志运行 codegen，这将打印出模板中提供给您的所有信息：

java -DdebugOperations -jar swagger-codegen-cli.jar \
      generate \
     -i http://petstore.swagger.io/v2/swagger.json \
     -l java \
     -o samples/client/petstore/java

其他调试标志是：

# print out the interpreted swagger spec
-DdebugSwagger

# print out model info
-DdebugModels

# print out supporting file data
-DdebugSupportingFiles