ASP.NET Core 3.X 中间件转端点路由，转换过程中有哪些疑问与挑战？

ASP.NET Core 3.x 终端中间件转换为端点路由运行详解

随着ASP.NET Core 3.x的发布，许多开发者开始关注如何将传统的终端中间件转换为端点路由运行，端点路由是一种灵活的路由机制，它允许开发者根据请求的URL路径来映射到不同的处理程序，本文将详细介绍如何将ASP.NET Core 3.x中的终端中间件转换为端点路由,并探讨其运行原理。

终端中间件与端点路由的区别

终端中间件

终端中间件是ASP.NET Core中用于处理请求和响应的组件，它允许开发者对请求进行预处理、修改或添加响应头等操作，终端中间件的执行顺序是从左到右，一旦某个中间件返回非null值,后续的中间件将不再执行。

端点路由

端点路由是一种基于URL路径的路由机制，它允许开发者根据请求的URL路径来映射到不同的处理程序，端点路由通常与控制器和操作方法一起使用,通过路由模板来匹配URL。

将终端中间件转换为端点路由

创建路由配置

需要在Startup.cs文件中配置路由,这可以通过添加RouteEndpoint来实现。

public void ConfigureServices(IServiceCollection services)
{
    services.AddControllers();
    services.AddRouting();
}
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    app.UseRouting();
    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllerRoute(
            name: "default",
            pattern: "{controller=Home}/{action=Index}/{id?}");
    });
}

创建端点路由中间件

创建一个端点路由中间件,用于处理特定的请求。

public class EndpointRoutingMiddleware
{
    private readonly RequestDelegate _next;
    public EndpointRoutingMiddleware(RequestDelegate next)
    {
        _next = next;
    }
    public async Task InvokeAsync(HttpContext context)
    {
        if (context.Request.Path.StartsWithSegments("/api"))
        {
            // 处理API请求
            await _next(context);
        }
        else
        {
            // 处理非API请求
            context.Response.StatusCode = StatusCodes.Status404NotFound;
        }
    }
}

注册中间件

在Startup.cs文件中注册端点路由中间件。

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    app.UseRouting();
    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllerRoute(
            name: "default",
            pattern: "{controller=Home}/{action=Index}/{id?}");
        endpoints.MapMiddleware<EndpointRoutingMiddleware>(new EndpointRoutingMiddleware(app));
    });
}

运行原理

当请求到达应用程序时，首先会经过UseRouting中间件，它会调用UseEndpoints中间件，在UseEndpoints中间件中，会根据配置的路由模式来匹配请求的URL路径，并找到对应的处理程序，如果请求的URL以”/api”开头，则会调用EndpointRoutingMiddleware中间件来处理API请求；否则,返回404状态码。

通过将终端中间件转换为端点路由，开发者可以更灵活地处理请求，并根据不同的URL路径来映射到不同的处理程序，这种方法在构建大型、复杂的Web应用程序时非常有用。

FAQs

Q1：端点路由与终端中间件相比，有哪些优势？

A1： 端点路由相比终端中间件有以下优势：

• 端点路由更加灵活,可以根据URL路径直接映射到控制器和操作方法。
• 端点路由易于维护,可以通过修改路由配置来调整路由规则。
• 端点路由可以与控制器和操作方法解耦,提高代码的可读性和可维护性。

Q2：如何测试端点路由中间件的功能？

A2： 测试端点路由中间件的功能可以通过以下步骤进行：

• 使用测试框架（如xUnit、NUnit等）编写测试用例。
• 在测试用例中模拟HTTP请求,并设置请求的URL路径。
• 调用中间件处理请求,并验证响应结果是否符合预期。
• 如果需要，可以检查中间件的执行日志,以确保中间件按预期工作。