我有一个简单的Web API2项目,它使用swagger作为它的文档 .
给定一个简单的GET endpoints ,它使用路由参数和查询参数,例如:
[HttpGet]
[Route("api/v2/items/{itemid:int}")]
public IHttpActionResult Getv2(int itemId, [FromUri(Name ="")]DTOv1 request)
{
return Ok();
}
public class DTOv1
{
public DateTime? StartValue { get; set; }
}
这提供了以下文档:
但是,我希望能够指定POCO中的所有项目 . 如:
[HttpGet]
[Route("api/v3/items/{itemid:int}")]
public IHttpActionResult Getv3([FromUri(Name ="")]DTOv2 request)
{
return Ok();
}
public class DTOv2
{
public int ItemId { get; set; }
public DateTime? StartValue { get; set; }
}
这给出了以下不正确的文档:
此GET endpoints 的工作方式与第一个示例相同,但正如您所看到的那样,文档没有,并且尝试做一个示例将不起作用 . 是否可以配置swagger以便以与第一个示例相同的方式记录,理想情况是以基于约定的方式?
Swagger只是使用默认设置:
GlobalConfiguration.Configuration
.EnableSwagger(c =>
{
c.SingleApiVersion("v1", "TestSwagger");
c.PrettyPrint();
})
.EnableSwaggerUi(c =>
{
});
编辑:
感谢有关添加过滤器的响应,我编写了以下操作过滤器,该过滤器在我们的用例中用于操作参数:
private class OperationFilter : IOperationFilter
{
public void Apply(Operation operation, SchemaRegistry schemaRegistry, ApiDescription apiDescription)
{
if (apiDescription.HttpMethod.Method == "GET")
{
var pathParams = operation.parameters.Where(x => x.@in == "path");
var toRemoveItems = new List<Parameter>();
foreach(var pathParam in pathParams)
{
toRemoveItems.AddRange(operation
.parameters
.Where(x => x.@in != "path" && x.name.EndsWith(pathParam.name)));
}
foreach(var toRemove in toRemoveItems)
{
operation.parameters.Remove(toRemove);
}
}
}
}
1 回答
跟进我关于使用
IDocumentFilter
的评论的建议是一个起点:有关详情,请参阅我的提交:
https://github.com/heldersepu/SwashbuckleTest/commit/38a31e0ee700faf91cc38d005ae1c5f4bec3e1f3
以下是它在UI上的外观:
http://swashbuckletest.azurewebsites.net/swagger/ui/index?filter=RouteTest#/RouteTest/RouteTest_Get