ASP.NET Core 中间件 - ASP.NET Core 基础教程 - 简单教程,简单编程

本文涉及的产品
服务治理 MSE Sentinel/OpenSergo,Agent数量 不受限
Serverless 应用引擎免费试用套餐包,4320000 CU,有效期3个月
MSE Nacos/ZooKeeper 企业版试用,1600元额度,限量50份
简介: 原文:ASP.NET Core 中间件 - ASP.NET Core 基础教程 - 简单教程,简单编程 ASP.NET Core 中间件 上一章节中,我们我们有讲到 Startup 类中的 Configure() 方法用于定义请求管道中的中间件 ASP.NET Core 中的中间件控制我们的应用程序如何响应 HTTP 请求,它还可以控制我们的应用程序在发生错误时的显示的内容,它是我们认证和授权用户执行特定操作的关键部分 中间件 那么,什么是中间件呢? 中间件是一种装配到应用程序管道以处理请求和响应的组件。

原文:ASP.NET Core 中间件 - ASP.NET Core 基础教程 - 简单教程,简单编程

ASP.NET Core 中间件

上一章节中,我们我们有讲到 Startup 类中的 Configure() 方法用于定义请求管道中的中间件

ASP.NET Core 中的中间件控制我们的应用程序如何响应 HTTP 请求,它还可以控制我们的应用程序在发生错误时的显示的内容,它是我们认证和授权用户执行特定操作的关键部分

中间件

那么,什么是中间件呢?

中间件是一种装配到应用程序管道以处理请求和响应的组件。

每个组件:

  1. 可以选择是否将请求传递到管道中的下一个组件。
  2. 可在调用管道中的下一个组件前后执行工作。

请求委托用于生成请求管道。请求委托处理每个 HTTP 请求。

可以使用 RunMapUse 扩展方法来配置请求委托。

可将一个单独的请求委托并行指定为匿名方法 ( 称为并行中间件 ) ,或在可重用的类中对其进行定义

这些可重用的类和并行匿名方法即为中间件或中间件组件

请求管道中的每个中间件组件负责调用管道中的下一个组件,或在适当情况下使链发生短路

中间件处理流程

ASP.NET Core 请求管道包含一系列相继调用的请求委托,如下图所示(执行过程遵循黑色箭头)

每个委托均可在下一个委托前后执行操作。

此外,委托还可以决定不将请求传递给下一个委托,这就是对请求管道进行短路。

通常需要短路,因为这样可以避免不必要的工作。

例如,静态文件中间件可以返回静态文件请求并使管道的其余部分短路。

需要尽早在管道中调用异常处理委托,以便它们可以捕获在管道的后期阶段所发生的异常

我们假设想要记录每个请求的信息,而且想要验证每个请求是否被授权,然后才发送到相应的控制器中去处理

  1. 在这种情况下,安装到应用程序中的第一件中间件可能就是日志记录组件

  2. 记录器可以看到关于传入请求的所有信息,但可能只是记录一些信息, 然后将这个请求传递给下一个中间件

  3. 中间件是这个处理流水线中存在的一系列组件

  4. 安装到应用程序中的下一个中间件是授权组件

  5. 授权组件可能会在 HTTP 标头中寻找特定的 Cookie 信息或访问令牌

  6. 如果授权组件发现令牌有效,则继续传递请求给下一个中间件路由器。如果无效,则可以授权组件本身可能会用HTTP 错误代码或重定向代码来响应请求以将用户引导到到登录页面

  7. 路由器中间件查看 URL 并确定下一步动作

  8. 路由器中间件在应用程序中查找响应的内容,如果路由器没有找到任何响应,则路由器本身可能会返回 404 Not Found 错误

范例

上面的讲解很枯燥,其实真正理解起来很简单,就是流水化的作业

每个新项目默认都会使用 context.Response.WriteAsync 中间件,也就是在 app.Run() 方法中注册的中间件

public void Configure(IApplicationBuilder app, IHostingEnvironment env) { if (env.IsDevelopment()) { app.UseDeveloperExceptionPage(); } app.Run(async (context) => { await context.Response.WriteAsync("Hello World!"); }); } 

app.Run() 方法允许我们传入另一个方法,我们可以用它来处理每一个单独的响应。Run() 方法不经常见,它是调用中间件的终端

app.Run() 方法中注册的中间件永远不会有机会调用另一个中间件,它只会接收请求,然后必须产生某种响应

app.Run() 方法中注册的中间件还可以访问 Response,例如使用 Response 对象返回一个字符串,就前几章节中我们做的那样

如果在 app.Run() 方法之后注册另一个中间件,那么注册的那个中间件永远不会被调用,因为 Run() 方法是注册中间件的 终端,在它之后,永远不会调用下一个中间件

添加另一个中间件

添加另一个中间件的方法很简单,让我们继续以下步骤来添加另一个中间件:

  1. 要添加另一个中间件,右键单击项目并选择 添加 -> 添加 NuGet 包

    如果你使用的是 Windows 系统,则是选择 管理 NuGet 程序包

  2. 在弹出的 添加包管理器中 输入 Microsoft.AspNetCore.Diagnostics

    这个包是一个可以用于异常处理,异常显示页面和诊断信息的 ASP.NET Core 中间件,它包含了我们可以使用的许多不同的中间件

  3. 选中 Microsoft.AspNetCore.Diagnostics 并点击右下脚的 添加包 按钮

    如果你使用的是 Windows 系统,则是选中 Microsoft.AspNetCore.Diagnostics,然后点击右边的 安装 按钮

    如果安装失败,可能是因为你的项目中已经默认安装了该 NuGet 包

    我苹果电脑默认已经安装,所以安装失败,但 Windows 上却安装成功

  4. 然后我们修改 Startup 类中的 Configure() 方法添加中间件 app.UseWelcomePage

    public void Configure(IApplicationBuilder app, IHostingEnvironment env)
    {
        if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }
    
        app.UseWelcomePage();
    
        app.Run(async (context) =>
        {
            var msg = Configuration["message"];
            await context.Response.WriteAsync(msg);
        });
    }
    
  5. 运行 HelloWorld 项目,刷新浏览器,可以看到显示如下

目录
相关文章
|
20天前
|
开发框架 .NET C#
ASP.NET Core Blazor 路由配置和导航
大家好,我是码农刚子。本文系统介绍Blazor单页应用的路由机制,涵盖基础配置、路由参数、编程式导航及高级功能。通过@page指令定义路由,支持参数约束、可选参数与通配符捕获,结合NavigationManager实现页面跳转与参数传递,并演示用户管理、产品展示等典型场景,全面掌握Blazor路由从入门到实战的完整方案。
146 6
|
11月前
|
开发框架 .NET 开发者
简化 ASP.NET Core 依赖注入(DI)注册-Scrutor
Scrutor 是一个简化 ASP.NET Core 应用程序中依赖注入(DI)注册过程的开源库,支持自动扫描和注册服务。通过简单的配置,开发者可以轻松地从指定程序集中筛选、注册服务,并设置其生命周期,同时支持服务装饰等高级功能。适用于大型项目,提高代码的可维护性和简洁性。仓库地址:<https://github.com/khellang/Scrutor>
269 5
|
11月前
|
开发框架 算法 中间件
ASP.NET Core 中的速率限制中间件
在ASP.NET Core中,速率限制中间件用于控制客户端请求速率,防止服务器过载并提高安全性。通过`AddRateLimiter`注册服务,并配置不同策略如固定窗口、滑动窗口、令牌桶和并发限制。这些策略可在全局、控制器或动作级别应用,支持自定义响应处理。使用中间件`UseRateLimiter`启用限流功能,并可通过属性禁用特定控制器或动作的限流。这有助于有效保护API免受滥用和过载。 欢迎关注我的公众号:Net分享 (239字符)
232 1
|
11月前
|
开发框架 缓存 .NET
GraphQL 与 ASP.NET Core 集成:从入门到精通
本文详细介绍了如何在ASP.NET Core中集成GraphQL,包括安装必要的NuGet包、创建GraphQL Schema、配置GraphQL服务等步骤。同时,文章还探讨了常见问题及其解决方法,如处理复杂查询、错误处理、性能优化和实现认证授权等,旨在帮助开发者构建灵活且高效的API。
289 3
|
消息中间件 存储 负载均衡
消息中间件的选择:RabbitMQ是一个明智的选择
消息中间件的选择:RabbitMQ是一个明智的选择
259 0
|
消息中间件 存储 中间件
【消息中间件】详解三大MQ:RabbitMQ、RocketMQ、Kafka
【消息中间件】详解三大MQ:RabbitMQ、RocketMQ、Kafka
11671 1
|
消息中间件 编解码 Docker
Docker部署RabbitMQ消息中间件
【7月更文挑战第4天】Docker部署RabbitMQ消息中间件
473 3
|
消息中间件 编解码 Docker
【Docker项目实战】Docker部署RabbitMQ消息中间件
【10月更文挑战第8天】Docker部署RabbitMQ消息中间件
560 2
【Docker项目实战】Docker部署RabbitMQ消息中间件
|
消息中间件 Java 测试技术
消息中间件RabbitMQ---SpringBoot整合RabbitMQ【三】
这篇文章是关于如何在SpringBoot应用中整合RabbitMQ的消息中间件。内容包括了在SpringBoot项目中添加RabbitMQ的依赖、配置文件设置、启动类注解,以及如何通过单元测试来创建交换器、队列、绑定,并发送和接收消息。文章还介绍了如何配置消息转换器以支持对象的序列化和反序列化,以及如何使用注解`@RabbitListener`来接收消息。
消息中间件RabbitMQ---SpringBoot整合RabbitMQ【三】
|
消息中间件 Docker 容器
消息中间件RabbitMQ---Docker安装RabbitMQ、以及RabbitMQ的基本使用【二】
这篇文章提供了RabbitMQ的安装和基本使用教程,包括如何使用Docker拉取RabbitMQ镜像、创建容器、通过浏览器访问管理界面,以及如何创建交换机、队列、绑定和使用direct、fanout和topic三种类型的交换器进行消息发布和接收的测试。
消息中间件RabbitMQ---Docker安装RabbitMQ、以及RabbitMQ的基本使用【二】

热门文章

最新文章