Swagger UI不显示嵌入的json属性模型

Question

我正在使用swagger工具来记录我基于Jersey的REST API（我正在使用的swaggerui是在2014年6月下载的，我不知道这个问题是否在以后的版本中得到了解决，但由于我对其代码进行了大量定制，所以我没有选择下载最新版本，而无需再次投入大量时间进行定制）。

到目前为止，我所有的传输对象都有一级深度属性（没有嵌入的POJO）。但现在，我添加了一些返回更复杂对象（两级深度）的rest路径，我发现当有嵌入式对象时，SwaggerUI并没有扩展JSON模型模式。

以下是《狂妄博士》的重要部分：

...
{
    "path": "/user/combo",
    "operations": [{
        "method": "POST",
        "summary": "Inserts a combo (user, address)",
        "notes": "Will insert a new user and a address definition in a single step",
        "type": "UserAndAddressWithIdSwaggerDto",
        "nickname": "insertCombo",
        "consumes": ["application/json"],
        "parameters": [{
            "name": "body",
            "description": "New user and address combo",
            "required": true,
            "type": "UserAndAddressWithIdSwaggerDto",
            "paramType": "body",
            "allowMultiple": false
        }],
        "responseMessages": [{
            "code": 200,
            "message": "OK",
            "responseModel": "UserAndAddressWithIdSwaggerDto"
        }]
    }]
}
...
"models": {
    "UserAndAddressWithIdSwaggerDto": {
        "id": "UserAndAddressWithIdSwaggerDto",
        "description": "",
        "required": ["user",
        "address"],
        "properties": {
            "user": {
                "$ref": "UserDto",
                "description": "User"
            },
            "address": {
                "$ref": "AddressDto",
                "description": "Address"
            }
        }
    },

    "UserDto": {
    "id": "UserDto",
    "properties": {
        "userId": {
            "type": "integer",
            "format": "int64"
        },
        "name": {
            "type": "string"
        },...
    },

    "AddressDto": {
    "id": "AddressDto",
    "properties": {
        "addressId": {
            "type": "integer",
            "format": "int64"
        },
        "street": {
            "type": "string"
        },...
    }

}
...

嵌入的对象是User和Address，它们的模型被正确创建，如json响应所示。

但打开SwaggerUI时，我只能看到：

{
  "user": "UserDto",
  "address": "AddressDto"
}

但是我应该看到这样的东西：

{
  "user": {
    "userId": "integer",
    "name": "string",...
  },
  "address": {
    "addressId": "integer",
    "street": "string",...
  }
}

扩展内部属性的代码可能有问题，javascript控制台没有显示任何错误，所以我认为这是一个错误。

Answer 1

我找到了解决方案，有一行代码需要修改才能正常工作：

大摇大摆地。js文件有一个getSampleValue函数，其中有一个条件检查未定义：

SwaggerModelProperty.prototype.getSampleValue = function(modelsToIgnore) {
  var result;
  if ((this.refModel != null) && (modelsToIgnore[this.refModel.name] === 'undefined'))
...

我将相等性检查更新为（删除引号）：

modelsToIgnore[this.refModel.name] === undefined

之后，SwaggerUI可以显示嵌入的模型。