.NET 6 中使用多个文件的最小 API

Question

在 .NET 6 中，可以创建最少的 API：

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/products/{id}", (int id) => { return Results.Ok(); })
app.MapGet("/users/{id}", (int id) => { return Results.Ok(); })

app.Run();

将端点分组到多个文件中而不是全部放在程序文件中的方法是什么？

ProductEndpoints.cs:

app.MapGet("/products/{id}", (int id) => { return Results.Ok(); })

UserEndpoints.cs

app.MapGet("/users/{id}", (int id) => { return Results.Ok(); })

Answer 1

每个项目只允许有一个包含顶级语句的文件。但没有人禁止将端点移动到另一个类的某些静态方法：

public static class ProductEndpointsExt
{
    public static void MapProductEndpoints(this WebApplication app)
    {
        app.MapGet("/products/{id}", (int id) => { return Results.Ok(); });
    }
}

并在Program文件中：

app.MapProductEndpoints();

Answer 2

我们也可以使用部分 Program.cs 文件

示例：“Program.Users.cs”

partial class Program
{
    /// <summary>
    /// Map all users routes
    /// </summary>
    /// <param name="app"></param>
    private static void AddUsers(WebApplication app)
    {
        app.MapGet("/users", () => "All users");
        app.MapGet("/user/{id?}", (int? id) => $"A users {id}");
        ///post, patch, delete...
    }
}

在“Program.cs”中

...
var app = builder.Build();

// Configure the HTTP request pipeline.
if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}
//add...
AddUsers(app);
...

Answer 3

我所做的是创建每个需要定义端点的类都必须实现的接口 IEndPoint，以及一个扩展方法来查找所有实现来调用接口映射方法。您只需在 Program.cs 或 Startup 中调用该扩展方法即可注册所有端点。

// IEndpoint.cs
public interface IEndPoint
{
    void MapEndpoint(WebApplication app);
}

// FeatureA.cs
public class FeatureA: IEndPoint
{
    public void MapEndpoint(WebApplication app)
    {
        app.MapGet("api/FeatureA/{id}", async (int id) => $"Fetching {id} data");
    }
}

// WebApplicationExtension.cs
public static class WebApplicationExtensions
{
    public static void MapEndpoint(this WebApplication app)
    {
        var assemblies = AppDomain.CurrentDomain.GetAssemblies();
            
        var classes = assemblies.Distinct().SelectMany(x => x.GetTypes())
            .Where(x => typeof(IEndPoint).IsAssignableFrom(x) && !x.IsInterface && !x.IsAbstract);

        foreach (var classe in classes)
        {
            var instance = Activator.CreateInstance(classe) as IEndPoint;
            instance?.MapEndpoint(app);
        }
    }
}

// Program.cs
...
app.MapEndpoint();
...