首页 > 资讯 > 后端开发 > ASP.NET >理解ASP.NET Core 中间件(Middleware)

438

分享到

理解ASP.NET Core 中间件(Middleware)

2024-04-02 19:04:59 438人浏览独家记忆

摘要

目录中间件中间件管道RunUseUseWhenMapMapWhenRun & Use & UseWhen & Map & Map编写中间件并激活基于约

中间件

先借用微软官方文档的一张图：

可以看到，中间件实际上是一种配置在Http请求管道中，用来处理请求和响应的组件。它可以：

决定是否将请求传递到管道中的下一个中间件
可以在管道中的下一个中间件处理之前和之后进行操作

此外，中间件的注册是有顺序的，书写代码时一定要注意！

中间件管道

Run

该方法为HTTP请求管道添加一个中间件，并标识该中间件为管道终点，称为终端中间件。也就是说，该中间件就是管道的末尾，在该中间件之后注册的中间件将永远都不会被执行。所以，该方法一般只会书写在Configure方法末尾。


public class Startup
{
    public void Configure(IApplicationBuilder app)
    {
        app.Run(async context =>
        {
            await context.Response.WriteAsync("Hello, World!");
        });
    }
}

Use

通过该方法快捷的注册一个匿名的中间件


public class Startup
{
    public void Configure(IApplicationBuilder app)
    {
        app.Use(async (context, next) =>
        {
            // 下一个中间件处理之前的操作
            Console.WriteLine("Use Begin");
            
            await next();
            
            // 下一个中间件处理完成后的操作
            Console.WriteLine("Use End");
        });
    }
}

注意：

1.如果要将请求发送到管道中的下一个中间件，一定要记得调用next.Invoke / next()，否则会导致管道短路，后续的中间件将不会被执行
2.在中间件中，如果已经开始给客户端发送Response，请千万不要调用next.Invoke / next()，也不要对Response进行任何更改，否则，将抛出异常。
3.可以通过context.Response.HasStarted来判断响应是否已开始。

以下都是错误的代码写法

错误1：


public class Startup
{
    public void Configure(IApplicationBuilder app)
    {
        app.Use(async (context, next) =>
        {
            await context.Response.WriteAsync("Use");
            await next();
        });

        app.Run(context =>
        {
            // 由于上方的中间件已经开始 Response，此处更改 Response Header 会抛出异常
            context.Response.Headers.Add("test", "test");
            return Task.CompletedTask;
        });
    }
}

错误2：


public class Startup
{
    public void Configure(IApplicationBuilder app)
    {
        app.Use(async (context, next) =>
        {
            await context.Response.WriteAsync("Use");
            
            // 即使没有调用 next.Invoke / next()，也不能在 Response 开始后对 Response 进行更改
            context.Response.Headers.Add("test", "test");
        });
    }
}

UseWhen

通过该方法针对不同的逻辑条件创建管道分支。需要注意的是：

进入了管道分支后，如果管道分支不存在管道短路或终端中间件，则会再次返回到主管道。

当使用PathString时，路径必须以“/”开头，且允许只有一个'/'字符

支持嵌套，即UseWhen中嵌套UseWhen等

支持同时匹配多个段，如 /get/user


public class Startup
{
    public void Configure(IApplicationBuilder app)
    {
        // /get 或 /get/xxx 都会进入该管道分支
        app.UseWhen(context => context.Request.Path.StartsWithSegments("/get"), app =>
        {
            app.Use(async (context, next) =>
            {
                Console.WriteLine("UseWhen:Use");

                await next();
            });
        });
        
        app.Use(async (context, next) =>
        {
            Console.WriteLine("Use");

            await next();
        });

        app.Run(async context =>
        {
            Console.WriteLine("Run");

            await context.Response.WriteAsync("Hello World!");
        });
    }
}

当访问 /get 时，输出如下：

UseWhen:Use
Use
Run

如果你发现输出了两遍，别慌，看看是不是浏览器发送了两次请求，分别是 /get 和 /favicon.ico

Map

通过该方法针对不同的请求路径创建管道分支。需要注意的是：
一旦进入了管道分支，则不会再回到主管道。
使用该方法时，会将匹配的路径从HttpRequest.Path 中删除，并将其追加到HttpRequest.PatHBase中。
路径必须以“/”开头，且不能只有一个'/'字符
支持嵌套，即Map中嵌套Map、MapWhen（接下来会讲）等
支持同时匹配多个段，如 /post/user


public class Startup
{
    public void Configure(IApplicationBuilder app)
    {
        // 访问 /get 时会进入该管道分支
        // 访问 /get/xxx 时会进入该管道分支
        app.Map("/get", app =>
        {
            app.Use(async (context, next) =>
            {
                Console.WriteLine("Map get: Use");
                Console.WriteLine($"Request Path: {context.Request.Path}"); 
                Console.WriteLine($"Request PathBase: {context.Request.PathBase}");
        
                await next();
            });
        
            app.Run(async context =>
            {
                Console.WriteLine("Map get: Run");
        
                await context.Response.WriteAsync("Hello World!");
            });
        
        });
        
        // 访问 /post/user 时会进入该管道分支
        // 访问 /post/user/xxx 时会进入该管道分支
        app.Map("/post/user", app =>
        {
            // 访问 /post/user/student 时会进入该管道分支
            // 访问 /post/user/student/1 时会进入该管道分支
            app.Map("/student", app =>
            {
                app.Run(async context =>
                {
                    Console.WriteLine("Map /post/user/student: Run");
                    Console.WriteLine($"Request Path: {context.Request.Path}");
                    Console.WriteLine($"Request PathBase: {context.Request.PathBase}");
        
                    await context.Response.WriteAsync("Hello World!");
                });
            });
            
            app.Use(async (context, next) =>
            {
                Console.WriteLine("Map post/user: Use");
                Console.WriteLine($"Request Path: {context.Request.Path}");
                Console.WriteLine($"Request PathBase: {context.Request.PathBase}");
                
                await next();
            });
        
            app.Run(async context =>
            {
                Console.WriteLine("Map post/user: Run");
        
                await context.Response.WriteAsync("Hello World!");
            });
        });
    }
}

当你访问 /get/user 时，输出如下：

Map get: Use
Request Path: /user
Request PathBase: /get
Map get: Run

当你访问 /post/user/student/1 时，输出如下：

Map /post/user/student: Run
Request Path: /1
Request PathBase: /post/user/student

其他情况交给你自己去尝试啦！

MapWhen

与Map类似，只不过MapWhen不是基于路径，而是基于逻辑条件创建管道分支。注意事项如下：

一旦进入了管道分支，则不会再回到主管道。
当使用PathString时，路径必须以“/”开头，且允许只有一个'/'字符
HttpRequest.Path和HttpRequest.PathBase不会像Map那样进行特别处理
支持嵌套，即MapWhen中嵌套MapWhen、Map等
支持同时匹配多个段，如 /get/user


public class Startup
{
    public void Configure(IApplicationBuilder app)
    {
        // /get 或 /get/xxx 都会进入该管道分支
        app.MapWhen(context => context.Request.Path.StartsWithSegments("/get"), app =>
        {
            app.MapWhen(context => context.Request.Path.ToString().Contains("user"), app =>
            {
                app.Use(async (context, next) =>
                {
                    Console.WriteLine("MapWhen get user: Use");

                    await next();
                });
            });
        
            app.Use(async (context, next) =>
            {
                Console.WriteLine("MapWhen get: Use");
        
                await next();
            });
        
            app.Run(async context =>
            {
                Console.WriteLine("MapWhen get: Run");
        
                await context.Response.WriteAsync("Hello World!");
            });
        });
    }
}

当你访问 /get/user 时，输出如下：

MapWhen get user: Use

可以看到，即使该管道分支没有终端中间件，也不会回到主管道。

Run & Use & UseWhen & Map & Map

一下子接触了4个命名相似的、与中间件管道有关的api，不知道你有没有晕倒，没关系，我来帮大家总结一下：

Run用于注册终端中间件，Use用来注册匿名中间件，UseWhen、Map、MapWhen用于创建管道分支。
UseWhen进入管道分支后，如果管道分支中不存在短路或终端中间件，则会返回到主管道。Map和MapWhen进入管道分支后，无论如何，都不会再返回到主管道。
UseWhen和MapWhen基于逻辑条件来创建管道分支，而Map基于请求路径来创建管道分支，且会对HttpRequest.Path和HttpRequest.PathBase进行处理。

编写中间件并激活

上面已经提到过的Run和Use就不再赘述了。

基于约定的中间件

“约定大于配置”，先来个约法三章：

1.拥有公共（public）构造函数，且该构造函数至少包含一个类型为RequestDelegate的参数
2.拥有名为Invoke或InvokeAsync的公共（public）方法，必须包含一个类型为HttpContext的方法参数，且该参数必须位于第一个参数的位置，另外该方法必须返回Task类型。
3.构造函数中的其他参数可以通过依赖注入（DI）填充，也可以通过UseMiddleware传参进行填充。

通过DI填充时，只能接收 Transient 和 Singleton 的DI参数。这是由于中间件是在应用启动时构造的（而不是按请求构造），所以当出现 Scoped 参数时，构造函数内的DI参数生命周期与其他不共享，如果想要共享，则必须将Scoped DI参数添加到Invoke/InvokeAsync来进行使用。

通过UseMiddleware传参时，构造函数内的DI参数和非DI参数顺序没有要求，传入UseMiddleware内的参数顺序也没有要求，但是我建议将非DI参数放到前面，DI参数放到后面。（这一块感觉微软做的好牛皮）

4.Invoke/InvokeAsync的其他参数也能够通过依赖注入（DI）填充，可以接收 Transient、Scoped 和 Singleton 的DI参数。

一个简单的中间件如下：


public class MyMiddleware
{
    // 用于调用管道中的下一个中间件
    private readonly RequestDelegate _next;

    public MyMiddleware(
        RequestDelegate next,
        ITransientService transientService,
        ISingletonService singletonService)
    {
        _next = next;
    }

    public async Task InvokeAsync(
        HttpContext context,
        ITransientService transientService,
        IScopedService scopedService,
        ISingletonService singletonService)
    {
        // 下一个中间件处理之前的操作
        Console.WriteLine("MyMiddleware Begin");
        
        await _next(context);
        
        // 下一个中间件处理完成后的操作
        Console.WriteLine("MyMiddleware End");
    }
}

然后，你可以通过UseMiddleware方法将其添加到管道中


public class Startup
{
    public void Configure(IApplicationBuilder app)
    {
        app.UseMiddleware<MyMiddleware>();
    }
}

不过，一般不推荐直接使用UseMiddleware，而是将其封装到扩展方法中


public static class AppMiddlewareApplicationBuilderExtensions
{
    public static IApplicationBuilder UseMy(this IApplicationBuilder app) => app.UseMiddleware<MyMiddleware>();
}

public class Startup
{
    public void Configure(IApplicationBuilder app)
    {
        app.UseMy();
    }
}

基于工厂的中间件

优势：

按照请求进行激活。这个就是说，上面基于约定的中间件实例是单例的，但是基于工厂的中间件，可以在依赖注入时设置中间件实例的生命周期。
使中间件强类型化（因为其实现了接口IMiddleware）

该方式的实现基于IMiddlewareFactory和IMiddleware。先来看一下接口定义：


public interface IMiddlewareFactory
{
    IMiddleware? Create(Type middlewareType);

    void Release(IMiddleware middleware);
}

public interface IMiddleware
{
    Task InvokeAsync(HttpContext context, RequestDelegate next);
}

你有没有想过当我们调用UseMiddleware时，它是如何工作的呢？事实上，UseMiddleware扩展方法会先检查中间件是否实现了IMiddleware接口。如果实现了，则使用容器中注册的IMiddlewareFactory实例来解析该IMiddleware的实例（这下你知道为什么称为“基于工厂的中间件”了吧）。如果没实现，那么就使用基于约定的中间件逻辑来激活中间件。

注意，基于工厂的中间件，在应用的服务容器中一般注册为 Scoped 或 Transient 服务。

这样的话，咱们就可以放心的将 Scoped 服务注入到中间件的构造函数中了。

接下来，咱们就来实现一个基于工厂的中间件：


public class YourMiddleware : IMiddleware
{
    public async Task InvokeAsync(HttpContext context, RequestDelegate next)
    {
        // 下一个中间件处理之前的操作
        Console.WriteLine("YourMiddleware Begin");

        await next(context);

        // 下一个中间件处理完成后的操作
        Console.WriteLine("YourMiddleware End");
    }
}

public static class AppMiddlewareApplicationBuilderExtensions
{
    public static IApplicationBuilder UseYour(this IApplicationBuilder app) => app.UseMiddleware<YourMiddleware>();
}

然后，在ConfigureServices中添加中间件依赖注入


public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddTransient<YourMiddleware>();
    }
}

最后，在Configure中使用中间件


public class Startup
{
    public void Configure(IApplicationBuilder app)
    {
        app.UseYour();
    }
}

微软提供了IMiddlewareFactory的默认实现：


public class MiddlewareFactory : IMiddlewareFactory
{
    // The default middleware factory is just an IServiceProvider proxy.
    // This should be reGIStered as a scoped service so that the middleware instances
    // don't end up being singletons.
    // 默认的中间件工厂仅仅是一个 IServiceProvider 的代理
    // 该工厂应该注册为 Scoped 服务，这样中间件实例就不会成为单例
    private readonly IServiceProvider _serviceProvider;

    public MiddlewareFactory(IServiceProvider serviceProvider)
    {
        _serviceProvider = serviceProvider;
    }

    public IMiddleware? Create(Type middlewareType)
    {
        return _serviceProvider.GetRequiredService(middlewareType) as IMiddleware;
    }

    public void Release(IMiddleware middleware)
    {
        // The container owns the lifetime of the service
        // DI容器来管理服务的生命周期
    }
}

可以看到，该工厂使用过DI容器来解析出服务实例的。因此，当使用基于工厂的中间件时，是无法通过UseMiddleware向中间件的构造函数传参的。

基于约定的中间件 VS 基于工厂的中间件

基于约定的中间件实例都是 Singleton；而基于工厂的中间件实例可以是 Singleton、Scoped 和 Transient（当然，不建议注册为 Singleton）
基于约定的中间件实例构造函数中可以通过依赖注入传参，也可以用过UseMiddleware传参；而基于工厂的中间件只能通过依赖注入传参
基于约定的中间件实例可以在Invoke/InvokeAsync中添加更多的依赖注入参数；而基于工厂的中间件只能按照IMiddleware的接口定义进行实现。

到此这篇关于理解ASP.net core 中间件(Middleware)的文章就介绍到这了,更多相关ASP.net core Middleware内容请搜索编程网以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程网！

点击免费下载>>软考高级考试备考技巧/历年真题/备考精华资料

--结束END--

本文标题: 理解ASP.NET Core 中间件(Middleware)

本文链接: https://www.lsjlt.com/news/134396.html(转载时请注明来源链接)

有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341

本篇文章演示代码以及资料文档资料下载

下载Word文档到电脑，方便收藏和打印～

下载Word文档

去做题

猜你喜欢

理解ASP.NET Core 中间件(Middleware)

目录中间件中间件管道RunUseUseWhenMapMapWhenRun & Use & UseWhen & Map & Map编写中间件并激活基于约...

99+

2022-11-12
ASP.NET Core中间件Middleware是什么

本篇内容介绍了“ASP.NET Core中间件Middleware是什么”的有关知识，在实际案例的操作过程中，不少人都会遇到这样的困境，接下来就让小编带领大家学习一下如何处理这些情况吧！希望大家仔细阅读，能够学有所成！什么是中间件...

99+

2023-06-26
详解ASP.NETCore中间件Middleware

本文为官方文档译文，官方文档现已非机器翻译 https://docs.microsoft.com/zh-cn/aspnet/core/fundamentals/middleware/...

99+

2022-11-12
ASP.Net Core MVC中间件是什么

本篇内容介绍了“ASP.Net Core MVC中间件是什么”的有关知识，在实际案例的操作过程中，不少人都会遇到这样的困境，接下来就让小编带领大家学习一下如何处理这些情况吧！希望大家仔细阅读，能够学有所成！讲中间件, 其...

99+

2023-06-29
ASP.NET Core中间件如何使用

今天小编给大家分享一下ASP.NET Core中间件如何使用的相关知识点，内容详细，逻辑清晰，相信大部分人都还太了解这方面的知识，所以分享这篇文章给大家参考一下，希望大家阅读完这篇文章后有所收获，下面我们一起来了解一下吧。1.前言...

99+

2023-06-29
ASP.NET Core中Startup类、Configure()方法及中间件详解

ASP.NET Core 程序启动过程如下 1, Startup 类 ASP.NET Core 应用使用Startup类，按照约定命名为Startup。Startup类：可选择性...

99+

2022-11-12
ASP.NET Core使用Middleware设置有条件允许访问路由

目录1.简介2.实现1.简介有时，我们可能在Web API中包含一些具有调试功能的请求。比如我们上次的文章中为什么ASP.NET Core 数据库连接串的值和...

99+

2022-11-13
ASP.NET Core的中间件与管道介绍

今天来讨论一个ASP.NET Core 很重要概念管道和中间件，在ASP.NET Core中，针对HTTP请求采用pipeline也就是通常说的管道方式来处理，而管道容器内可以挂载很...

99+

2022-11-12
ASP.NET Core中间件初始化的实现

目录前言自定义的方式 Use方式基于约定的方式实现IMiddleware的方式源码探究 Use扩展方法 UseMiddleware 总结前言 ...

99+

2022-11-12
ASP.NET Core中间件怎么实现限流

本篇内容介绍了“ASP.NET Core中间件怎么实现限流”的有关知识，在实际案例的操作过程中，不少人都会遇到这样的困境，接下来就让小编带领大家学习一下如何处理这些情况吧！希望大家仔细阅读，能够学有所成！一、限流算法在高并发系统中...

99+

2023-06-29
ASP.NET Core中间件用法与官方常用中间件介绍

目录一、什么是中间件中间件和过滤器的区别二、中间件常用方法1、Run方法2、Use方法3、Map方法4、Mapwhen方法三、自定义中间件四、官方常用中间件1、异常处理中间件2、HT...

99+

2022-11-13
ASP.NET Core中间件实现限流的代码

目录一、限流算法1.计数器算法1.1 固定窗口算法1.2 滑动窗口算法2.令牌桶算法3.漏桶算法二、ASP.NET Core中间件实现限流1.中间件代码2.在管道中的使用一、限流算法...

99+

2022-11-13
ASP.NET Core使用自定义日志中间件

这个日志框架使用的是ASP.NET Core的NLog，用来记录每次请求信息和返回信息。 1.首先创建一个Web应用项目，我选择的是MVC模板： 2.使用NuGet添加Micros...

99+

2022-11-13
Node.js使用Middleware中间件教程详解

目录中间件依赖注入应用中间件路由通配符中间件消费者路由排除函数式中间件多个中间件全局中间件中间件中间件是一个在路由处理程序之前被调用的函数。中间件函数可以访问请求和响应对象，以及应...

99+

2023-05-15

Node.js Middleware Node.js 中间件
ASP.NET Core中间件初始化的实现方法

小编给大家分享一下ASP.NET Core中间件初始化的实现方法，希望大家阅读完这篇文章之后都有所收获，下面让我们一起去探讨吧！前言在日常使用ASP.NET Core开发的过程中我们多多少少会设计到使用中间件的场景，...

99+

2023-06-15
ASP.NET Core 中间件的使用之全局异常处理机制

目录1、创建项目2、创建全局异常过滤器3、依赖注入全局异常处理机制4、测试全局异常处理机制前言：我们经常听到“秒修复秒上线”，觉得很厉害的样子。其实不然，这只是一个调侃而已，出...

99+

2022-11-12
理解ASP.NET Core 启动类(Startup)

目录准备工作：一份ASP.NET Core Web API应用程序Startup类Startup构造函数ConfigureServicesConfigure省略Startup类ISt...

99+

2022-11-12
ASP.NET Core中间件与管道的概念是什么

今天小编给大家分享一下ASP.NET Core中间件与管道的概念是什么的相关知识点，内容详细，逻辑清晰，相信大部分人都还太了解这方面的知识，所以分享这篇文章给大家参考一下，希望大家阅读完这篇文章后有所收获，下面我们一起来了解一下吧...

99+

2023-06-26
ASP.NET Core中间件用法与官方常用中间件的示例分析

小编给大家分享一下ASP.NET Core中间件用法与官方常用中间件的示例分析，希望大家阅读完这篇文章之后都有所收获，下面让我们一起去探讨吧！一、什么是中间件我们都知道，任何的一个web框架都是把http请求封装成一个管道，每一次...

99+

2023-06-29
laravel的中间件middleware怎么用

这篇文章将为大家详细讲解有关laravel的中间件middleware怎么用，小编觉得挺实用的，因此分享给大家做个参考，希望大家阅读完这篇文章后可以有所收获。中间件可以对请求进行过滤，这里可以利用中间件来验证用户是否登录，如果用户登录则可以...

99+

2023-06-21