如何在Netcore3.1 Web应用程序中使用区域配置swagger？

如何解决如何在Netcore3.1 Web应用程序中使用区域配置swagger？

我在我的mvc Web应用程序（不是webapi）中编写Web服务端点（作为一个区域：“ api”）。有人可以告诉我如何用区域配置摇摇欲坠吗？

services.AddSwaggerGen();

app.UseSwagger();
app.UseSwaggerUI(c =>
{
    c.SwaggerEndpoint("api/swagger/v1/swagger.json","MY API V1");
    c.RoutePrefix = "api";
});

解决方法

首先，您可以编写一个扩展类来获取AreaName，如下所示：

  public static class ApiDescriptionExtension
    {
        public static List<string> GetAreaName(this ApiDescription description)
        {
            string areaName = description.ActionDescriptor.RouteValues["Area"];
            List<string> areaList = new List<string>();
            areaList.Add(areaName);
            if (!string.IsNullOrEmpty(areaName))
            {
                description.RelativePath = $"{description.RelativePath}";
            }
            return areaList;
        }
    }

然后在您的StartUp（添加代码：c.TagActionsBy(apiDesc => apiDesc.GetAreaName());）中

  services.AddSwaggerGen(c =>
        {
            c.SwaggerDoc("v1",new OpenApiInfo
            {
               //...
            });

            c.SwaggerDoc("v2",new OpenApiInfo
            {
               //...
            });
            c.TagActionsBy(apiDesc => apiDesc.GetAreaName());

        });

记住要配置您的区域路由：

  app.UseEndpoints(endpoints =>
        {
            endpoints.MapControllers();
            endpoints.MapControllerRoute(
            name: "Area",pattern: "{area:exists}/{controller=Home}/{action=Index}/{id?}"
            );
        });

在您的ApiController中的Area中：

示例：

[Area("Area")]
[Produces("application/json")]
[Route("v1/Area/api/[controller]")]
[ApiController]
public class TodoController : ControllerBase
{        
    [HttpGet]
    public ActionResult<List<TodoItem>> GetAll()
    {
        return Ok();
    }

测试结果：