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

Question

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

除了 'required' 属性之外，我不知道如何访问 any 参数属性 ... 'model' 阶段除外。 .. 我怎样才能在 'api' 阶段做到这一点？ ...我希望能够删除验证参数是否满足 'required'、min/max 等条件的代码

Answer 1

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

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

要查看您可以访问的内容，请运行带有调试标志的代码生成器，它将打印出模板中可用的所有信息：

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

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

Swagger ... query-parameter properties access from Mustache

swagger

swagger-2.0