将中间件添加到C#ASP.NET Core管道时,“ Map”扩展的用途是什么?

中间件是组装到应用程序管道中以处理请求和响应的软件组件。

每个组件都选择是否将请求传递给管道中的下一个组件,并可以在管道中调用下一个组件之前和之后执行某些操作。

映射扩展名用作分支管道的约定。

Map扩展方法用于根据请求的路径来匹配请求委托。Map仅接受路径和配置单独的中间件管道的函数。

在下面的示例中,任何带有/ maptest基本路径的请求都将由HandleMapTest方法中配置的管道处理。

示例

private static void HandleMapTest(IApplicationBuilder app){
   app.Run(async context =>{
      await context.Response.WriteAsync("Map Test Successful");
   });
}
public void ConfigureMapping(IApplicationBuilder app){
   app.Map("/maptest", HandleMapTest);
}

除了基于路径的映射外,MapWhen方法还支持基于谓词的中间件分支,从而允许以非常灵活的方式构造单独的管道。

类型Func <HttpContext,bool>的任何谓词均可用于将请求映射到管道的新分支。

private static void HandleBranch(IApplicationBuilder app){
   app.Run(async context =>{
      await context.Response.WriteAsync("使用分支。");
   });
}
public void ConfigureMapWhen(IApplicationBuilder app){
   app.MapWhen(context => {
      return context.Request.Query.ContainsKey("branch");
   }, HandleBranch);
      app.Run(async context =>{
         await context.Response.WriteAsync("Hello from " + _environment);
   });
}

映射也可以嵌套

app.Map("/level1", level1App => {
   level1App.Map("/level2a", level2AApp => {
      // "/level1/level2a"
      //...------
   });
   level1App.Map("/level2b", level2BApp => {
      // "/level1/level2b"
      //...------
   });
});