MongoDB从入门到实战之.NET Core使用MongoDB开发ToDoList系统-Swagger框架集成

using Microsoft.OpenApi.Models;
using Swashbuckle.AspNetCore.SwaggerGen;
using System.Reflection;

var builder = WebApplication.CreateBuilder(args);

// 添加Swagger服务
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen(options =>
{
    var xmlFilename = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml";
    // 确保XML注释文件与项目文件中的路径一致
    options.IncludeXmlComments(Path.Combine(AppContext.BaseDirectory, xmlFilename));

    options.SwaggerDoc("v1", new OpenApiInfo
    {
        Title = "ToDoList API",
        Version = "v1",
        Description = "一个简单的ToDoList API示例",
        Contact = new OpenApiContact() { Name = "开发者", Email = "developer@example.com" }
    });

    // 添加全局过滤器，过滤掉不需要显示的API
    options.DocumentFilter<IgnoreObsoleteActionFilter>();
});

var app = builder.Build();

// 启用中间件用于生成Swagger作为JSON endpoint
app.UseSwagger();
// 启用中间件用于提供swagger-ui (HTML, JS, CSS等)
app.UseSwaggerUI(options =>
{
    options.SwaggerEndpoint("/swagger/v1/swagger.json", "ToDoList API V1");
    options.RoutePrefix = string.Empty; // 设置为空，则可通过根路径访问Swagger UI
});

app.MapGet("/", () => "Hello World!");

app.Run();