swagger - SwaggerUI 未在 POST 正文参数中显示用于收集的模型架构

Question

我在 2014 年 6 月下载了 SwaggerUI，因为我刚刚下载了 dist 文件夹，所以很难找到它的版本。

在这几个月里，我一直在使用 Swagger 来记录我正在使用 Jersey 构建的 REST API，我发现 UI 没有在数据类型列中显示模型和模型架构，用于在我的情况下是集合的主体参数列表，它只显示单词“array”。

似乎这个问题在较新的版本中得到了解决，但是我对代码进行了几次定制，下载新版本对我来说不是一个选项。

我想知道我应该修改代码的哪一部分以使其工作。

Answer 1

我发现我的 swagger.js 版本中需要更新的部分是：

SwaggerOperation = (function() {
...
for (_i = 0, _len = _ref1.length; _i < _len; _i++) {
parameter = _ref1[_i];
parameter.name = parameter.name || parameter.type || parameter.dataType;
type = parameter.type || parameter.dataType;

// ++++ Add this:
if(type === 'array') {
type = 'array[' + parameter.items.$ref + ']';
}
// ++++

if (type.toLowerCase() === 'boolean') {
parameter.allowableValues = {};
parameter.allowableValues.values = ["true", "false"];
}
...

之后参数视图如下所示：

我在 SwaggerUI github 项目问题跟踪器中发布了同样的发现：https ://github.com/wordnik/swagger-ui/issues/400