浅谈ASP.NET Core 2.0 中间件（译）

网络编程 2024/9/22 佚名

3 1 2

问题

如何创建一个最简单的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参数有如下方法：

Run()：添加中间件并终止请求管道（也就是说不再调用下一个中间件）。
Use()：添加中间件，使用lambda表达式或者一个具体的类。
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/

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

ASP.NET,Core2.0,中间件,ASP.NET,Core,中间件

华山资源网 Design By www.eoogi.com

广告合作：本站广告合作请联系QQ：858582 申请时备注：广告合作（否则不回）
免责声明：本站资源来自互联网收集,仅供用于学习和交流,请遵循相关法律法规,本站一切资源不代表本站立场,如有侵权、后门、不妥请联系本站删除！

华山资源网 Design By www.eoogi.com

评论“浅谈ASP.NET Core 2.0 中间件（译）”

暂无评论...

《魔兽世界》大逃杀！60人新游玩模式《强袭风暴》3月21日上线

暴雪近日发布了《魔兽世界》10.2.6 更新内容，新游玩模式《强袭风暴》即将于3月21 日在亚服上线，届时玩家将前往阿拉希高地展开一场 60 人大逃杀对战。

艾泽拉斯的冒险者已经征服了艾泽拉斯的大地及遥远的彼岸。他们在对抗世界上最致命的敌人时展现出过人的手腕，并且成功阻止终结宇宙等级的威胁。当他们在为即将于《魔兽世界》资料片《地心之战》中来袭的萨拉塔斯势力做战斗准备时，他们还需要在熟悉的阿拉希高地面对一个全新的敌人──那就是彼此。在《巨龙崛起》10.2.6 更新的《强袭风暴》中，玩家将会进入一个全新的海盗主题大逃杀式限时活动，其中包含极高的风险和史诗级的奖励。
《强袭风暴》不是普通的战场，作为一个独立于主游戏之外的活动，玩家可以用大逃杀的风格来体验《魔兽世界》，不分职业、不分装备（除了你在赛局中捡到的），光是技巧和战略的强弱之分就能决定出谁才是能坚持到最后的赢家。本次活动将会开放单人和双人模式，玩家在加入海盗主题的预赛大厅区域前，可以从强袭风暴角色画面新增好友。游玩游戏将可以累计名望轨迹，《巨龙崛起》和《魔兽世界：巫妖王之怒经典版》的玩家都可以获得奖励。

更新日志

2024年09月22日

浅谈ASP.NET Core 2.0 中间件（译）

浅谈ASP.NET Core 2.0 带初始参数的中间件(译)

.NET发送邮件遇到问题及解决方法

评论“浅谈ASP.NET Core 2.0 中间件（译）”

《魔兽世界》大逃杀！60人新游玩模式《强袭风暴》3月21日上线

更新日志

友情链接