深入解析ASP.NET Core 中间件：如何构建高效的请求处理管道

devtools/2024/9/21 11:20:22/

使用ASP.NET Core 中间件实现请求处理管道

前言

ASP.NET Core 是一个跨平台的高性能框架，主要用于构建现代的基于云的、互联网连接的应用程序。在ASP.NET Core 中，Middleware（中间件）是一个核心概念。中间件是处理HTTP请求和响应的一个组件链。通过这些组件，你可以创建灵活、可扩展的应用程序架构。本文将详细介绍如何在ASP.NET Core 中实现和使用中间件，帮助你构建更高效的请求处理管道。

什么是中间件？

在ASP.NET Core中，中间件是一个处理HTTP请求和响应的逻辑块。每个中间件从请求管道中接收请求，对其进行处理后，决定是否将其传递给下一个中间件，或者直接返回响应。中间件通常用于记录日志、认证、授权、异常处理、静态文件服务等。

一个中间件的基本构成是一个接受 HttpContext 对象的委托方法。中间件可以对请求进行处理，并可以决定是否将请求传递给下一个中间件。

中间件的执行顺序

中间件的执行顺序非常重要，因为它直接影响到请求和响应的流动。中间件是按它们在请求管道中的注册顺序执行的。

假设有以下中间件链：

Middleware A -> Middleware B -> Middleware C

当一个请求到达时，执行顺序如下：

  1. 请求进入 Middleware A。
  2. Middleware A 将请求传递给 Middleware B。
  3. Middleware B 将请求传递给 Middleware C。
  4. Middleware C 处理完后，开始返回响应。
  5. Middleware B 处理响应，然后将响应返回给 Middleware A。
  6. 最终，Middleware A 将响应返回给客户端。
如何创建中间件

中间件可以通过以下几种方式创建：

  1. 使用内置中间件
  2. 创建自定义中间件类
  3. 使用 Use 方法创建匿名中间件
使用内置中间件

ASP.NET Core 提供了很多内置的中间件，如静态文件中间件、路由中间件、身份验证中间件等。我们可以直接在 Startup 类中的 Configure 方法中使用这些中间件。例如：

public void Configure(IApplicationBuilder app)
{// 使用静态文件中间件app.UseStaticFiles();// 使用路由中间件app.UseRouting();// 使用身份验证中间件app.UseAuthentication();// 使用终端中间件app.UseEndpoints(endpoints =>{endpoints.MapControllers();});
}
创建自定义中间件类

自定义中间件通常是创建一个实现了 Invoke 或 InvokeAsync 方法的类。这个方法接收 HttpContext 参数，并且可以在其中编写处理请求和响应的逻辑。

以下是一个自定义中间件的示例，该中间件在处理请求前后记录日志：

public class LoggingMiddleware
{private readonly RequestDelegate _next;public LoggingMiddleware(RequestDelegate next){_next = next;}public async Task InvokeAsync(HttpContext context){// 处理请求前的逻辑Console.WriteLine($"Request: {context.Request.Method} {context.Request.Path}");// 将请求传递给下一个中间件await _next(context);// 处理请求后的逻辑Console.WriteLine($"Response: {context.Response.StatusCode}");}
}

这个 LoggingMiddleware 中间件可以通过在 Startup 类的 Configure 方法中注册使用：

public void Configure(IApplicationBuilder app)
{app.UseMiddleware<LoggingMiddleware>();app.UseRouting();app.UseEndpoints(endpoints =>{endpoints.MapControllers();});
}
使用 Use 方法创建匿名中间件

有时你可能只需要在特定场景下编写一个简单的中间件，此时可以使用 Use 方法创建匿名中间件。例如：

public void Configure(IApplicationBuilder app)
{app.Use(async (context, next) =>{Console.WriteLine("Before Request");await next.Invoke();Console.WriteLine("After Request");});app.UseRouting();app.UseEndpoints(endpoints =>{endpoints.MapControllers();});
}

在这个例子中，匿名中间件记录了请求前后的日志信息。

使用中间件处理错误

在生产环境中，处理未处理的异常至关重要。ASP.NET Core 提供了一个内置的异常处理中间件，你可以通过 UseExceptionHandler 方法使用它：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{if (env.IsDevelopment()){app.UseDeveloperExceptionPage();}else{// 使用全局异常处理app.UseExceptionHandler("/Home/Error");app.UseHsts();}app.UseRouting();app.UseEndpoints(endpoints =>{endpoints.MapControllers();});
}

UseExceptionHandler 中间件会捕获应用程序中的异常，并将用户重定向到指定的错误处理页面。

中间件的注册顺序

中间件的注册顺序非常重要，因为它决定了请求处理的顺序。通常情况下，中间件应该按照以下顺序注册：

  1. 静态文件中间件
  2. 路由中间件
  3. 身份验证中间件
  4. 自定义业务逻辑中间件
  5. 终端中间件

一个常见的注册顺序如下：

public void Configure(IApplicationBuilder app)
{app.UseStaticFiles();app.UseRouting();app.UseAuthentication();app.UseAuthorization();app.UseMiddleware<CustomMiddleware>();app.UseEndpoints(endpoints =>{endpoints.MapControllers();});
}
在中间件中访问服务

中间件通常需要访问依赖注入的服务。ASP.NET Core 允许你在中间件的构造函数中注入这些服务，也可以在 Invoke 方法中获取 HttpContext.RequestServices 提供的服务。例如：

public class CustomMiddleware
{private readonly RequestDelegate _next;private readonly ILogger<CustomMiddleware> _logger;public CustomMiddleware(RequestDelegate next, ILogger<CustomMiddleware> logger){_next = next;_logger = logger;}public async Task InvokeAsync(HttpContext context){_logger.LogInformation("Handling request: " + context.Request.Path);await _next(context);_logger.LogInformation("Finished handling request.");}
}
使用终端中间件

终端中间件（Terminal Middleware）是处理请求的最后一个中间件，通常用来直接生成响应而不将请求传递给下一个中间件。UseEndpoints 是一个常见的终端中间件，它可以处理终结请求，如处理MVC控制器路由或Razor页面请求。

public void Configure(IApplicationBuilder app)
{app.UseRouting();app.UseEndpoints(endpoints =>{endpoints.MapGet("/", async context =>{await context.Response.WriteAsync("Hello World!");});});
}

在这个例子中，MapGet 方法定义了一个终端中间件来处理 GET 请求，并返回“Hello World!”的响应。

编写可测试的中间件

编写中间件时，确保它们是可测试的非常重要。要实现这一点，你需要将中间件的逻辑封装在独立的类中，并确保依赖项通过构造函数注入。例如：

public class RequestLoggingMiddleware
{private readonly RequestDelegate _next;private readonly ILogger<RequestLoggingMiddleware> _logger;public RequestLoggingMiddleware(RequestDelegate next, ILogger<RequestLoggingMiddleware> logger){_next = next;_logger = logger;}public async Task InvokeAsync(HttpContext context){_logger.LogInformation($"Request {context.Request.Method} {context.Request.Path} at {DateTime.Now}");await _next(context);}
}

通过这种方式，你可以轻松地为中间件编写单元测试。

结论

中间件是ASP.NET Core应用程序中的核心组件，它们允许开发者通过构建请求处理管道来创建高度可扩展、可维护的应用程序架构。通过本文，你应该对如何创建和使用中间件有了更深入的理解。无论是使用内置中间件还是编写自定义中间件，都能帮助你更好地管理和控制应用程序的请求处理逻辑。

希望这篇文章能帮助你掌握中间件的使用技巧，并能在实际项目中灵活应用这些知识。如果你有任何疑问或想要进一步讨论，欢迎在评论区留言。


http://www.ppmy.cn/devtools/100783.html

相关文章

基于单片机的智能奶茶机（论文+源码+图纸）

基于单片机的智能奶茶机（论文+源码+图纸）

1总体架构设计 本课题为基于单片机的智能奶茶机设计&#xff0c;其系统架构上设计如图2.1所示&#xff0c;整个系统包括了DS18B20温度传感器、继电器模块、LCD液晶、蜂鸣器、按键、STC89C52单片机等器件&#xff0c;在功能上用户可以通过按键键控制选择甜度和添加物以及设置温…
阅读更多...
Java学习_21_多线程JUC

Java学习_21_多线程JUC

文章目录 前言多线程并发与并行多线程的实现方式Thread类Runnable接口Callable接口和Future接口 Thread类的相关方法线程对象线程优先级守护线程出让线程/礼让线程插入线程/插队线程 线程的相关问题生命周期安全问题Lock锁死锁等待唤醒机制&#xff08;生产者和消费者&#xff…
阅读更多...
React项目-less、antd配置

React项目-less、antd配置

一、创建Reract项目 1、创建React项目 npx create-react-app react-test 2、运行eject Cesium静态资源需要webpack配置&#xff0c;执行npm run eject可以生成webpack配置&#xff0c;运行前先查看当前git版本是否有提交&#xff0c;如果未提交&#xff0c;需要先本地提交gi…
阅读更多...
JAVA-常见八股文（4）-内部类和匿名内部类

JAVA-常见八股文（4）-内部类和匿名内部类

【参考文献】 Java 中的内部类与匿名内部类详解_内部类和匿名内部类-CSDN博客 内部类以及匿名内部类详解_匿名内部类的作用-CSDN博客 1.内部类 将一个类 A 定义在另一个类 B 里面&#xff0c;里面的那个类 A 就称为内部类&#xff0c;B 则称为外部类。 特点&#xff1a; 内…
阅读更多...
VIM的简单用法

VIM的简单用法

vim三种模式的切换 Set nu&#xff1a;显示行号 Set nonu&#xff1a;不显示行号 Set mousea显示鼠标光标 Set cursorline:显示行线 为什么这些设定默认不能永久存在&#xff1a; 进程结束后&#xff0c;所占的内存空间会被系统回收&#xff0c;资源被释放&#xff0c;这些资源…
阅读更多...
5步掌握Python Django+Vue二手房项目，实现房价预测与知识图谱系统

5步掌握Python Django+Vue二手房项目，实现房价预测与知识图谱系统

&#x1f34a;作者&#xff1a;计算机毕设匠心工作室 &#x1f34a;简介&#xff1a;毕业后就一直专业从事计算机软件程序开发&#xff0c;至今也有8年工作经验。擅长Java、Python、微信小程序、安卓、大数据、PHP、.NET|C#、Golang等。 擅长&#xff1a;按照需求定制化开发项目…
阅读更多...
虚幻5|制作玩家血量，体力（还未编辑，只用于引用）

虚幻5|制作玩家血量，体力（还未编辑，只用于引用）

未编写&#xff0c;仅引用 优化后&#xff1a; 把增加生命&#xff0c;减少生命&#xff0c;也可以用在体力里&#xff0c;更改如下 限制浮点&#xff0c;如果血量或体力按10来扣&#xff0c;如果你的血量降低到5&#xff0c;那么就会以5的数值来扣&#xff0c;而不会扣成-5…
阅读更多...
Node.js-发票真伪查验-发票查重-发票验真接口

Node.js-发票真伪查验-发票查重-发票验真接口

发票真伪查验、发票真伪查重、发票验真接口是现代化企业财务管理中不可或缺的工具&#xff0c;主要用于验证发票的真实性和规避发票风险。发票查验接口查验的票据类型一般是指增值税发票管理系统开具的票据&#xff0c;还有一种票据查验接口查验的是财政类票据&#xff0c;包含…
阅读更多...
最新文章

Copyright @ 2022~2023