中间件是组装到应用程序管道中以处理请求和响应的软件组件。
每个组件都选择是否将请求传递给管道中的下一个组件,并可以在管道中调用下一个组件之前和之后执行某些操作。
映射扩展名用作分支管道的约定。
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" //...------ }); });