ASP. NET Core 6.0最小API/Swagger标签

Question

有什么方法可以更改给定的超文本传输协议方法的标签，用最小的api编写？

builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

...

app.MapGet("/todo", () => "Hello world");

这样我就可以在留档中对方法进行逻辑分组，类似于它们在控制器中时的方法。

我尝试了（来自@Modar Na的提示）招摇过市的操作，不幸的是，它没有帮助。

app.MapGet("/todo", [SwaggerOperation(Tags = new[] { "ToDo" })]() => "Hello world");
app.MapPost("/todo", [SwaggerOperation(Tags = new[] { "ToDo" })]() => "Hello world");

app.MapGet("/projects", [SwaggerOperation(Tags = new[] { "Projects" })]() => "Hello world");
app.MapPost("/projects", [SwaggerOperation(Tags = new[] { "Projects" })]() => "Hello world");

作为一种解决方法，我在配置swagger生成器时使用了TagActionsBy方法。

builder.Services.AddSwaggerGen(c =>
{
    c.TagActionsBy(d =>
    {
        return new List<string>() { d.ActionDescriptor.DisplayName! };
    });
});

查看我的博客帖子。




Answer 1

我认为默认情况下，共享同一路线的所有操作都将分组

但要明确定义组，您需要使用swagger标记，该标记可以像这样使用：

app.MapGet("/todo", [SwaggerOperation(Tags = new[] { "MyTag" })]() => "Hello world");

控制器进近链接

Answer 2

怎么样：

app.MapGet("/todo", () => "Hello world").WithTags("ToDo");