配置 asp.net core 请求(request)处理管道

在本节中，我们将讨论使用中间件组件为 asp.net core 应用程序配置请求处理管道。

作为应用程序启动的一部分，我们要在configure()方法中设置请求处理管道。

public class startup
{
    public void configureservices(iservicecollection services)
    {
    }

    public void configure(iapplicationbuilder app, ihostingenvironment env)
    {
        if (env.isdevelopment())
        {
            app.usedeveloperexceptionpage();
        }

        app.run(async (context) =>
        {
            await context.response.writeasync("hello world!");
        });
    }

}

目前我们的代码中有 2 个中间件在管道中 ：usedeveloperexceptionpage()方法和run()方法

usedeveloperexceptionpage 中间件：顾名思义，如果存在异常并且环境是development，此中间件会被调用，显示开发异常页面。 我们将在后面的视频中讨论这个developerexceptionpage 中间件和环境变量的使用。

第二个中间件是注册run()方法到管道中,它只能处理将一个信息传入response对象。 目前，它是一个响应每个请求的中间件，返回 hello world。 在这种情况下，无论您的请求路径是什么。 所有请求都会被这个中间件所处理，我们得到的返回值都是这个中间件调用response对象,返回的 string 类型的字符串。 返回的值是纯文本而不是 html。 我们可以通过检查页面源代码来确认这一点。 可以看到，我们在源代码中没有任何 html 标记。 只是纯文本。

即使您现在创建一个为52abp.html的文件，并且您在请求中包含该文件的路径，我们的应用程序也无法返回该静态文件。 这是因为，目前我们的请求处理管道没有可以提供静态文件的中间件，如html文件，图像，css和javascript文件。 在后面的课程中，我们将添加所需的中间件以便能够提供静态文件。

研究下 configure()方法中的代码。

app.run(async (context) =>
{
    await context.response.writeasync("hello world!");
});

代码说明:

• 我们调用 run() 方法添加中间件到请求处理管道中。
• 如果将鼠标悬停在 run()方法上，则可以从 智能提示中看到run()方法是作为iapplicationbuilder接口的扩展方法实现的。这就是我们能够在iapplicationbuilder对象应用程序上调用此run()方法的原因。
• 我们传递给run()方法的参数是一个requestdelegate，我们可以从智能提示中看到它。
• requestdelegate是一个作为httpcontext对象的参数委托。
• 通过这个httpcontext对象，中间件可以访问传入的 http 请求和传出的 http 响应。
• 目前，我们使用lambda将请求，它通过委托内联的方式作为匿名方法传递,所以很多人都说 lambda 表达式是一种特殊的委托。如果你听不明白 lambda 表达式，委托，及内联，你可以参考学习:
  • 委托（delegate）
  • lambda 简介 ,或者等我录制 c#的基础视频吧。
• 使用run()扩展方法，我们只能将一个终端中间件添加到请求管道。
• 终端中间件是我们之前已经说到过，他会使管道短路，不会去调用下一个中间件。

研究下面的代码

app.run(async (context) =>
{
    await context.response.writeasync("从第一个中间件中打印hello world");
});

app.run(async (context) =>
{
    await context.response.writeasync("从第二个中间件中打印hello world");
});

• 我们使用run()方法注册了 2 个中间件。
• 运行此项目时，我们只看到第一个中间件的响应，有返回值。
• 我们没有看到第二个中间件的响应。
• 这是因为，使用run()方法注册的中间件无法调用管道中的下一个中间件。
• 因此，我们使用run()方法注册的中间件是终端中间件

如果您希望中间件能够调用管道中的下一个中间件，则使用use()方法注册中间件，如下所示。

app.use(async (context, next) =>
{
    await context.response.writeasync("从第一个中间件中打印hello world");
    await next();
});

app.run(async (context) =>
{
    await context.response.writeasync("从第二个中间件中打印hello world");
});

注意，use()方法有 2 个参数。第一个参数是httpcontext上下文对象，第二个参数是func类型，即它是代表管道中下一个中间件的通用委托。

我们再看看以下代码

public void configure(iapplicationbuilder app, ihostingenvironment env,
                ilogger<startup> logger)
{
    app.use(async (context, next) =>
    {
        logger.loginformation("mw1:传入请求");
        await next();
        logger.loginformation("mw1:传出响应");
    });

    app.use(async (context, next) =>
    {
        logger.loginformation("mw2: 传入请求");
        await next();
        logger.loginformation("mw2: 传出响应");
    });

    app.run(async (context) =>
    {
        await context.response.writeasync("mw3: 处理请求并生成响应");
        logger.loginformation("mw3: 处理请求并生成响应");
    });
}

• ilogger < startup >被注入到configure()方法中
• main()方法调用的createdefaultbuilder()配置日志记录
• 您可以通过查看在 github 的源代码验证这一点 ：https：//github.com/aspnet/metapackages/blob/release/2.2/src/microsoft.aspnetcore/webhost.cs
• 检查方法configurelogging(),* 您会发现，ilogger 配置了console，debug和eventsource三种.
• 我们使用依赖注入的方式将ilogger记录到系统中。
• 如果使用.net core cli 运行项目，则可以在“控制台”窗口中查看记录的信息
• 如果直接从visual studio运行项目，则可以在输出窗口中查看记录的信息。从输出窗口的下拉列表中选择 asp.net core web server。
• 您将看到，信息按以下顺序记录
  • mw1：传入请求
  • mw2：传入请求
  • mw3：处理请求并生成响应
  • mw2：传出响应
  • mw1：传出响应

现在将上面的输出与微软的官方文档中的下图集合起来，是不是就清晰明了啊。吐槽下，微软的文档有粗糙。

• 请记住，asp.net core 中的中间件可以访问传入请求和传出响应

• 请求先到达middleware1，它记录**（mw1：传入请求）**，因此我们首先看到此消息。

• 然后middleware1调用next()。next()会调用管道中的middleware2。

• middleware2 记录**（mw2：传入请求）**。

• 然后 middleware2 会调用next()再调用 middleware3.

• middleware3处理请求并生成响应。因此，我们看到的下一条消息是（mw3：处理请求并生成响应)

• 此时管道开始逆转。

• 此时控制权将，交回到middleware2，并将middleware3生成的响应传递给它。middleware2记录**（mw2：传出响应）**，这是我们接下来看到的。

• 最后, middleware2将控制权交给 midleware1。

• middleware1 记录 (mw1: 传出响应), 这是我们最后看到的。

请求处理管道的中 3 个非常重要的知识点：

• 所有的请求都会在每个中间件组件调用next()方法之前触发。请求按照图中箭头的所示方向，依次穿过所有管道。
• 当中间件处理请求并产生响应时，请求处理流程在管道中开始反向传递。
• 所有的响应都会在每个中间件组件调用next()方法之前触发。响应按照图中箭头的所示方向，依次穿过所有管道。

小结

response 为抽象类

乱码问题

                context.response.contenttype = "text/plain; charset=utf-8";

 

欢迎添加个人微信号：like若所思。

欢迎关注我的公众号，不仅为你推荐最新的博文，还有更多惊喜和资源在等着你!一起学习共同进步！