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

【问题标题】：Swagger ... query-parameter properties access from MustacheSwagger ... 从 Mustache 访问查询参数属性
【发布时间】：2015-04-24 04:47:31
【问题描述】：

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

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

【问题讨论】：

标签： swagger swagger-2.0

【解决方案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

【讨论】：

我正在运行 codegen 2.1.1-M1。我可以从“debugOperations”中看到，在我的案例中列出的唯一有趣的属性是“必需”属性。但不是价值约束。我在模型阶段访问和使用这些值约束没有问题，只需要知道我是否可以在操作阶段访问它们，但看起来不行。有没有其他人要求这个？ ...我的用例是，在为操作生成代码时，我希望能够使用这些值约束来验证客户端的“出站”参数。