第五节：管道中间件入门(Use、Run、Map)

一. 简介

1.中间件是一种装配到应用管道以处理请求和响应的组件,每个组件可以选择是否把请求传递到管道中的下一个组件、可在管道中的下一个组件的前后执行工作.请求管道中的每一个组件负责调用管道中的下一个组件（或者使管道短路）.

经典的管道请求图：

2.当中间件短路的时候，它被称为“终端中间件”，因为它阻止中间件进一步处理请求。

3.顺序：向Startup.Configure方法中添加常用中间件组件，需要按照下面的顺序，从而保证安全性、性能、功能。

 异常/错误处理→ HTTP 严格传输安全协议→HTTPS 重定向→静态文件服务器→Cookie 策略实施→身份验证→会话→MVC。

public void Configure(IApplicationBuilder app)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
        app.UseDatabaseErrorPage();
    }
    else
    {
        app.UseExceptionHandler("/Error");
        app.UseHsts();
    }

    // Use HTTPS Redirection Middleware to redirect HTTP requests to HTTPS.
    app.UseHttpsRedirection();

    // Return static files and end the pipeline.
    app.UseStaticFiles();

    // Use Cookie Policy Middleware to conform to EU General Data 
    // Protection Regulation (GDPR) regulations.
    app.UseCookiePolicy();

    // Authenticate before the user accesses secure resources.
    app.UseAuthentication();

    // If the app uses session state, call Session Middleware after Cookie 
    // Policy Middleware and before MVC Middleware.
    app.UseSession();

    // Add MVC to the request pipeline.
    app.UseMvc();
}

4.中间件的三大核心方法，分别是：Use、Run、Map.

二. Use方法

1. 用途：Use可以将多个中间件连接在一起，实现在下一个中间件的前后执行操作，Use方法也可以使管道短路，即不调用next请求委托,此时和Run的作用一样。

2. 查看Use方法的源代码，参数为：Func<HttpContext, Func<Task>, Task> middleware，可以参考自己封装一个中间件， 如：MyMiddleware。

 代码分享：

    /// <summary>
    /// 自定义一个中间件
    /// </summary>
    public class MyMiddleware
    {
        public Task DelegateMiddleware(HttpContext context, Func<Task> next)
        {
            context.Response.WriteAsync("MyOwinMiddle Start<br/>");
            next.Invoke();
            return context.Response.WriteAsync("MyOwinMiddle End<br/>");
        }
    }  
    public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            //1. Use用法
            {
                app.Use(async (context, next) =>
                {
                    await context.Response.WriteAsync("First  Start<br/>");
                    //调用下一个中间件
                    await next.Invoke();
                    await context.Response.WriteAsync("First End<br/>");
                });
                app.Use(async (context, next) =>
                {
                    await context.Response.WriteAsync("Second Start<br/>");
                    //调用下一个中间件
                    await next.Invoke();
                    await context.Response.WriteAsync("Second End<br/>");
                });
                //调用封装后的中间件
                MyMiddleware myMiddleware = new MyMiddleware();
                app.Use(myMiddleware.DelegateMiddleware);

                //没有调用next，它在此处的作用是使管道短路
                app.Use(async (context, next) =>
                {
                    await context.Response.WriteAsync("Third Start<br/>");
                    await context.Response.WriteAsync("Third End<br/>");
                });

            }
        }

 运行结果及分析：执行到next.Invoke(),调用下一个中间件。

 

三. Run方法

 1. Run是一种约定，在某些中间件的可公开的管道末尾运行Run[Middleware]方法，表示终止请求。

代码分享：

            //2. Run用法
            {
                app.Run(async context =>
                {
                    await context.Response.WriteAsync("First  Start<br/>");
                    await context.Response.WriteAsync("First End<br/>");
                });
                //不能执行下面代码，因为第一个Run直接终止了管道
                app.Run(async context =>
                {
                    await context.Response.WriteAsync("Second  Start<br/>");
                    await context.Response.WriteAsync("Second End<br/>");
                });
            }

运行结果：

 

四. Map和MapWhen方法

 1. 当请求满足某种规则，执行某个中间件，下面分享Map和MapWhen的代码

代码分享：

            //3. Map用法
            {
                //http://localhost:5000/map1 访问
                app.Map("/map1", appBulider => appBulider.Run(async context =>
                {
                    await context.Response.WriteAsync("This is Map1<br/>");
                }));
                //http://localhost:5000/map2 访问
                app.Map("/map2", appBulider => appBulider.Run(async context =>
                {
                    await context.Response.WriteAsync("This is Map2<br/>");
                }));
                //当没有map1和map2的时候，访问下面的中间件
                app.Run(async context =>
                {
                    await context.Response.WriteAsync("Hello from non-Map delegate. <p>");
                });
            }

            //4. MapWhen用法
            {
                //http://localhost:5000/?userName=ypf 访问 
                app.MapWhen(context => context.Request.Query.ContainsKey("userName"),
                    appBulider => appBulider.Run(async context =>
                    {
                        var value = context.Request.Query["userName"];
                        await context.Response.WriteAsync($"this value is {value}");
                    }));
                //没有拼接的时候访问下面
                app.Run(async context =>
                {
                    await context.Response.WriteAsync("Hello from non-Map delegate. <p>");
                });
            }

运行结果分析：如上述代码中的描述。

!

• 作       者 : Yaopengfei(姚鹏飞)
• 博客地址 : http://www.cnblogs.com/yaopengfei/
• 声     明1 : 本人才疏学浅，用郭德纲的话说“我是一个小学生”，如有错误，欢迎讨论，请勿谩骂^_^。
• 声     明2 : 原创博客请在转载时保留原文链接或在文章开头加上本人博客地址，否则保留追究法律责任的权利。