简述:
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"
//...------
});
});