4

我有一个使用 ASP.NET MVC 5、Swashbuckle 和 AutoRest 的项目。当我使用 Autorest 为我的 API 生成客户端时,我的参数正在从一个转换IEnumerable<long>IEnumerable<long?>

控制器方法

[HttpPost]
public IHttpActionResult Foo([FromBody] IEnumerable<long> ids)
{
    // do work
}

生成的 AutoRest 签名

Task<HttpOperationResponse<IList<ResponseModel>> FoWithMessageAsync(IList<long?> ids, ...)

我试过的

  • 使用获取方法。导致“多”类型,这是 AutoRest 中的已知错误 AutoRest中的已知错误。
  • 消除 [FromBody] 属性
  • 将 IEnumerable 包装在自定义模型中

这是一个奇怪的错误,但我已经使用 Swagger 和 Autorest 有一段时间了,所以我只能假设它要么是一个不起眼的错误/配置(可能),要么我错过了一些愚蠢的东西(可能)。提前感谢您的帮助。

更新

这是 Swashbuckle 生成的 Swagger Spec

{
    "swagger": "2.0",
    "info": {
        "version": "v1",
        "title": "FooBar",
    },
    "host": "localhost:5000",
    "schemes": [
        "http"
    ],
    "paths": {
        "/api/v1/Foo": {
            "post": {
                "operationId": "foo",
                "consumes": [
                    "application/json",
                    "text/json"
                ],
                "produces": [
                    "application/json",
                    "text/json"
                ],
                "parameters": [
                    {
                        "name": "ids",
                        "in": "body",
                        "description": "",
                        "required": true,
                        "schema": {
                            "type": "array",
                            "items": {
                                "format": "int64",
                                "type": "integer"
                            }
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "type": "array",
                            "items": {
                                "$ref": "#/definitions/Foo"
                            }
                        }
                    },
                    "404": {
                        "description": "NotFound"
                    },
                    "500": {
                        "description": "InternalServerError"
                    }
                },
                "deprecated": false
            }
        }
    }
}
4

1 回答 1

0

我可以告诉您如何在Swagger文件中解决您的问题并使用最新版本的 AutoRest ( https://github.com/Azure/autorest ),但我不知道 Swashbuckle 是否可以生成以下内容:

"200": {
    "description": "OK",
    "schema": {
        "type": "array",
        "items": {
          "x-nullable": false,
          "type": "integer",
          "format": "int64"
        }
    }
},

请注意,为了简单起见,我已经拼出了一个内联模式而不是引用"$ref": "#/definitions/Foo"。重要的是设置"x-nullable": false,它会覆盖默认的可空行为(预计服务器响应最差)。在您的情况下,必须将属性添加到引用的 schema .../Foo

这个功能只有几天的历史,所以一定要拉最新的 AutoRest。

于 2016-11-16T06:01:28.797 回答