ASP.NET核心Swashbuckle集操作ID

Question

如何在ASP.NET Core2.1项目中设置swaggeroperationid属性？根据这篇文章，我应该使用swaggerOperationAttribute，但我在swashbuckle.aspnetcore库中找不到它。还有IOPerationFilter

public interface IOperationFilter
{
    void Apply(Operation operation, OperationFilterContext context);
}

而且我找不到任何用于大摇大摆生成目的的实现。

Answer 1

还有另外两个选项，无需编写任何额外的代码或添加额外的依赖项，如swashbuckle.aspnetcore.annotations

选项1：基于约定-Swaggergen有一个设置CustomOperationIDs的选项。因此，您可以简单地将其设置为使用controllername_httpmethod，如下所示：

services.AddSwaggerGen(c =>
{
    c.CustomOperationIds(e => $"{e.ActionDescriptor.RouteValues["controller"]}_{e.HttpMethod}");
    c.SwaggerDoc("v1", new Info { Title = "Test API", Version = "v1" });
});

这将按照controllername_httpmethod约定向所有方法添加operationIds。

[HttpPost(Name="Post_Person")]
[ProducesResponseType(200)]
[ProducesResponseType(400)]
[ProducesResponseType(500)]
public async Task<ActionResult<Response>> PostAsync([FromBody]Request request)
{
    Response result = await _context.PostAsync(request);
    return Ok(result);
}