c# - 如何在 Swagger 3 中按区域分隔 Controller ？

Question

我在集成 api 中实现 Swagger，在这种情况下，有必要按区域分隔这些服务以解决项目组织问题，但我遇到以下问题，一些 Controller 在不同区域具有通用名称，当 swagger 生成文档，即使按区域分隔，如果它具有相同的 Controller 名称，我想知道是否有任何方法可以按区域分隔 Controller ？下面是两个集成:Mercado Livre 和 Skyhub，它们都在不同的区域，但如果他们注意到它们加入的类别，因为它们具有相同的 Controller 名称。

! https://tribofoxcombr-my.sharepoint.com/personal/leonardo_silva_tribofox_com_br/_layouts/15/onedrive.aspx?id=%2Fpersonal%2Fleonardo_silva_tribofox_com_br%2FDocuments%2FCompartilhado%2FCapturar%2EPNG&parent=%2Fpersonal%2Fleonardo_silva_tribofox_com_br%2FDocuments%2FCompartilhado&slrid=3e37b79e-f020-7000-b380-a8a0e7785d97

谢谢。

Answer 1

您可以使用:

    [ApiExplorerSettings(GroupName = "Group")] 
    public class SomethingController : Controller
    {

并在声明中

services.AddSwaggerGen(options =>
{
    options.SwaggerDoc(version,
        new Info
        {
            Title = name,
            Version = version
        }
    );

    options.DocInclusionPredicate((_, api) => !string.IsNullOrWhiteSpace(api.GroupName));

    options.TagActionsBy(api => api.GroupName);
});