在 C# ASP.NET Core 管道中添加中间件时,"Map"扩展有什么用?

csharpserver side programmingprogramming更新于 2025/9/30 14:22:17

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

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

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 类型的谓词都可用于将请求映射到管道的新分支。

private static void HandleBranch(IApplicationBuilder app){
   app.Run(async context =>{
      await context.Response.WriteAsync("Branch used.");
   });
}
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);
   });
}

Map 也可以嵌套

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

相关文章