浅谈ASP.NET Core 2.0 中间件(译)

 更新时间:2017年10月23日 16:38:11   作者:三生石上(FineUI控件)  
这篇文章主要介绍了浅谈ASP.NET Core 2.0 中间件,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧

问题

如何创建一个最简单的ASP.NET Core中间件?

答案

使用VS创建一个ASP.NET Core 2.0的空项目,注意Startup.cs中的Configure()方法:

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

比较好的创建请求管道的方法是使用IApplicationBuilder上的扩展方法:

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

运行,此时页面显示:

上面我们使用IApplicationBuilder.Run()来配置中间件,另外一种方法是IApplicationBuilder.Use():

public static void UseHelloWorld(this IApplicationBuilder app)
{
  app.Use(async (context, next) =>
  {
    await context.Response.WriteAsync("Hello World! (Use)\n");
    await next();
  });
}
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
  app.UseHelloWorld();
  app.RunHelloWorld();
}

运行,此时页面显示:

将中间件作为单独的类定义是更好的实践方法:

public class HelloWorldMiddleware
{
  private readonly RequestDelegate _next;

  public HelloWorldMiddleware(RequestDelegate next)
  {
    _next = next;
  }

  public async Task Invoke(HttpContext context)
  {
    await context.Response.WriteAsync("Hello World! (Use in Class)\n");
    await _next(context);
  }
}


public static class UseHelloWorldInClassExtensions
{
  public static IApplicationBuilder UseHelloWorldInClass(this IApplicationBuilder app)
  {
    return app.UseMiddleware<HelloWorldMiddleware>();
  }
}

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
  app.UseHelloWorld();
  app.UseHelloWorldInClass();
  app.RunHelloWorld();
}

运行,此时页面显示:

讨论

中间件是一个拦截HTTP请求和响应消息的组件。我们通过创建这些组件链,来为我们的应用程序创建一个请求管道。

我们通过Configure()方法的IApplicationBuilder参数来创建这个请求管道,IApplicationBuilder参数有如下方法:

  1. Run():添加中间件并终止请求管道(也就是说不再调用下一个中间件)。
  2. Use():添加中间件,使用lambda表达式或者一个具体的类。
  3. Map():根据请求路径添加中间件。

Run

这个方法接受RequestDelegate委托作为参数,当委托方法被调用时接受HttpContext参数。这个委托方法返回void,因为它会终止请求管道。

Use

这个方法接受Func委托作为参数,此委托方法有两个参数,分别是HttpContext和指向下一个中间件的next,返回空(Task)。如果没有调用下一个中间件,就会终止请求管道(和Run效果一样)。

UserMiddleware

当通过单独类创建中间件时,我们使用UseMiddleware方法,并将具体的实现类型作为泛型参数。

在中间件类中,有两个部分很重要:

1. 构造函数接受RequestDelegate。当调用此委托时会将当前请求传入下一个中间件。

2. 它拥有一个Invoke方法,接收HttpContext参数并返回空(Task)。当需要用到中间件时,框架会主动调用这个方法。

注:在单独类中实现中间件,并用UseMiddleware封装起来是最佳实践。

扩展方法

需要注意扩展方法的不同之处,RunXXX不会返回值,而UseXXX会返回值(IApplicationBuilder)。这是因为Run()终止请求管道,而Use()可能会链接到其他的中间件。

顺序

中间件按照它们在Configure()方法出现的顺序依次被调用。而返回到客户端的响应也会经历相同的中间件管道。

源代码下载

原文:https://tahirnaushad.com/2017/08/14/asp-net-core-middleware/

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持脚本之家。

相关文章

  • .NET中如何将文本文件的内容存储到DataSet

    .NET中如何将文本文件的内容存储到DataSet

    大家在项目中比较多的会对文件进行操作,例如文件的上传下载,文件的压缩和解压等IO操作。而在.NET项目中较多的会使用DataSet,DataTable进行数据的缓存。每一个DataSet都是一个或多个DataTable对象的集合,本文主要介绍的是如何将文本文件的内容存储到DataSet里去。
    2016-12-12
  • ASP.NET MVC中的视图生成实例分析

    ASP.NET MVC中的视图生成实例分析

    这篇文章主要介绍了ASP.NET MVC中的视图生成的过程,以实例形式详细分析了控制器、布局与视图的操作方法与技巧,非常具有实用价值,需要的朋友可以参考下
    2014-12-12
  • 查看Json输出的*最方便*的方法 (转)

    查看Json输出的*最方便*的方法 (转)

    项目的表现层使用MVC+Extjs。在开发过程中,一旦页面显示不正常,第一个需要排查的总是“Action是否输出了正确的Json?”。
    2009-11-11
  • ASP.NET MVC实现文件下载

    ASP.NET MVC实现文件下载

    这篇文章介绍了ASP.NET MVC实现文件下载的方法,文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-07-07
  • .net下log4net使用方法详解

    .net下log4net使用方法详解

    这篇文章主要为大家详细介绍了.net下log4net使用方法,以控制台应用程序为例,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-07-07
  • 使用.Net Core实现的一个图形验证码功能

    使用.Net Core实现的一个图形验证码功能

    SimpleCaptcha是一个使用简单,基于.Net Standard 2.0的图形验证码模块。这篇文章主要介绍了使用.Net Core实现的一个图形验证码功能,需要的朋友可以参考下
    2021-12-12
  • ASP.NET Core中使用xUnit进行单元测试

    ASP.NET Core中使用xUnit进行单元测试

    这篇文章主要介绍了ASP.NET Core中使用xUnit进行单元测试,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-11-11
  • ASP.NET MVC实现路由功能

    ASP.NET MVC实现路由功能

    这篇文章介绍了ASP.NET MVC实现路由功能的方法,文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-08-08
  • 利用.net控件实现下拉导航菜单制作的具体方法

    利用.net控件实现下拉导航菜单制作的具体方法

    这篇文章介绍了利用.net控件实现下拉导航菜单制作的具体方法,有需要的朋友可以参考一下,希望对你有所帮助
    2013-07-07
  • asp.net项目开发中用到的小技巧

    asp.net项目开发中用到的小技巧

    项目中用到的小技巧
    2010-03-03

最新评论