【译】ASP.NET CORE 2.0 中间件

Asp.net core 2.0

== 原文地址已不能访问，停止本系列更新==

问题

使用ASP.NET Core中间件创建Hello World

解决方案

从上一篇的空项目开始，如下修正Startup.cs中的Configure()方法

 public void Configure(
            IApplicationBuilder app,
            IHostingEnvironment env)
        {
            // setup request pipeline using middleware
            app.Run(async (context) =>
            {
                await context.Response.WriteAsync("Hello World! (Run)");
            });
        }

一个不错的练习使用扩展方法在IApplicationBuilder 上build pipeline:

 // RunMiddlewareExtensions.cs
        public static void RunHelloWorld(this IApplicationBuilder app)
        {
            app.Run(async (context) =>
            {
                await context.Response.WriteAsync("Hello World! (Run)");
            });
        }
        // Startup.cs
        public void Configure(
            IApplicationBuilder app,
            IHostingEnvironment env)
        {
            // setup request pipeline using middleware
            app.RunHelloWorld();
        }

上一段代码中我们使用IApplicationBuilder.Run() 配置中间件，另一种方法是用这个IApplicationBuilder.Run()

 // UseMiddlewareExtensions.cs
        public static IApplicationBuilder UseHelloWorld(
            this IApplicationBuilder app)
        {
            return app.Use(async (context, next) =>
            {
                await context.Response.WriteAsync("Hello World! (Use)\n");
                await next();
            });
        }
        // Startup.cs
        public void Configure(
            IApplicationBuilder app,
            IHostingEnvironment env)
        {
            // setup request pipeline using middleware
            app.UseHelloWorld();
            app.RunHelloWorld();
        }

一个不错的练习如何使用中间件定义在单独的类中

 public class HelloWorldMiddleware
    {
        private readonly RequestDelegate next;

        public HelloWorldMiddleware(RequestDelegate next)
        {
            this.next = next;
        }

        public async Task Invoke(HttpContext context)
        {
            await context.Response.WriteAsync("Hello World! (Use in Class)\n");
            await this.next(context);
        }
    }
    // UseMiddlewareExtensions.cs
    public static IApplicationBuilder UseHelloWorldInClass(
       this IApplicationBuilder app)
    {
          return app.UseMiddleware();
    }
    // Startup.cs
    public void Configure(
            IApplicationBuilder app,
            IHostingEnvironment env)
    {
        // setup request pipeline using middleware
        app.UseHelloWorld();
        app.UseHelloWorldInClass();
        app.RunHelloWorld();
    }

讨论

中间件是一个拦截HTTP请求和响应消息的组件。我们创建这些组件连来构建我们的应用管道。
我们设置这个管道通过Configure()方法，IApplicationBuilder是参数，有下面三个方法：

1. Run(): 添加一个中间件到管道， 不继续调用其他中间件
2. Use(): 添加一个中间件，使用Lambda或者单独的类
3. Map(): 根据请求路径添加中间件

Run

它用RequestDelegate 作为参数，当调用的时候用HttpContext作为参数， 返回void无类型，应为这个是短的请求管道。

Use

它用Func作为参数， 也就是把HttpContext和指针（Pointer）传到下一个中间件， 返回Task。 如果下个中间件没有调用，那他就是一个短的请求管道，和Run一样。

UseMiddleware

当我们设置一个中间件的类时，我们要用UseMiddleware去包装，提供我们的类和泛型参数。
独立的中间件类有两个关键内容：

1. 构成方法接受RequestDelegate。 这个会调用请求到下一个中间件
2. 它用Invoke接受参数HttpContext返回Task。 框架会根据需要调用中间件。
   注：用独立的类实现中间件并且用UseMdilleware是最佳实践

扩展方法

知道扩展方法的区别，RunXXX不支持返回值，然后UseXXX支持。这个是应为Run()是短路径请求管道，而Use()是以连的的形式连接其他中间件。

顺序

中间件调用顺序如他们在Configure()方法里，按添加他们到管道的顺序。在响应方面，返回给客户端也是传递一样的中间件管道。

Source Code

GitHub:

https://github.com/TahirNaushad/Fiver.Asp.Middleware