共计 2980 个字符,预计需要花费 8 分钟才能阅读完成。
ASP.Net Core 是微软开源的跨平台、可扩大、轻量级的模块化框架,可用于构建高性能的 web 应用程序。中间件组件能够注入到 ASP.Net Core 申请管道中实现对 Request 和 Response 的定制和批改。
ASP.Net Core 中间件能够用于查看、路由或者批改流转于 Pipeline 的 Request 和 Response。本文将会探讨如何应用这些中间件来实现一些高级操作。
Use,Run,Map 办法介绍
Use、Map,Run 办法罕用来一起构建 HTTP Pipeline 管道,上面疾速浏览一下这些办法和它们的用处。
- Use
该办法将会执行一个委托,而后将 交接棒
传给 Pipeline 的下一个中间件,因该办法短暂领有 交接棒
,所以该办法可用于 短路操作
。
- Run
该办法会执行委托并返回后果。
- Map
该办法将有条件地执行委托并返回后果。
注册中间件
中间件是在 Startup.Configure
中进行注册,调用办法就是 Use*
系列扩大办法,上面是注册中间件的语法。
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{app.UseMyCustomMiddleware<MyCustomMiddleware>();
}
须要留神的是,中间件的执行程序和你注册的程序是保持一致的。
Invoke 办法
每个中间件都蕴含一个 Invoke()
办法, 这个办法参数是 HttpContext 的一个实例,本中间件的业务逻辑会在下一个中间件的执行前后都会被执行,如果你有点懵的话,能够理解一下什么叫:递归调用
,如上面代码正文所示:
public async Task Invoke(HttpContext context)
{
// Write code here that will be executed before the
// next middleware is called
await _next.Invoke(context); // call next middleware
// Write code here that will be executed after the
//next middleware is called
}
分流 Http 管道
Map 系
扩大办法,比方:Map 和 MapWhen,它们罕用于给 pipeline 管道操作进行分流,前者是基于 Request path
进行分流,后者是基于指定的 谓语动词
进行分流。
上面的代码片段展现了如何应用 Map 办法对 Request Pipeline 进行分流。
public class Startup
{private static void MapRequestA(IApplicationBuilder app)
{
app.Run(async context =>
{await context.Response.WriteAsync("This is MapRequestA");
});
}
private static void MapRequestB(IApplicationBuilder app)
{
app.Run(async context =>
{await context.Response.WriteAsync("This is MapRequestB");
});
}
private static void MapRequestC(IApplicationBuilder app)
{
app.Run(async context =>
{await context.Response.WriteAsync("This is MapRequestC");
});
}
public void Configure(IApplicationBuilder app)
{app.Map("/mapRequestPathA", MapRequestA);
app.Map("/mapRequestPathB", MapRequestB);
app.Map("/mapRequestPathB", MapRequestC);
app.Run(async context =>
{await context.Response.WriteAsync("Hello World!");
});
}
//Other methods
}
MapWhen 办法承受两个参数:
Func<HttpContext, bool> predicate
delegate action
你能够在 Startup.Configure
办法中回绝 text/xml
格局的 request,如下代码所示:
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{if (env.IsDevelopment())
{app.UseDeveloperExceptionPage();
}
app.MapWhen(context => context.Request.ContentType.Equals
("text/xml", StringComparison.InvariantCultureIgnoreCase),
(IApplicationBuilder applicationBuilder) =>
{
applicationBuilder.Run(async context =>
{await Task.FromResult(context.Response.StatusCode = StatusCodes.Status406NotAcceptable);
});
});
app.UseMvc();}
应用 UseWhen
UseWhen 办法能够用于有条件的执行中间件, 上面的代码片段展现了如果以后 Request 申请门路是以 /api
结尾的话,执行一个指定的中间件,代码如下:
app.UseWhen(context => context.Request.Path.StartsWithSegments("/api"), applicationBuilder =>
{applicationBuilder.UseCustomMiddleware();
});
请留神,UseWhen 不像 MapWhen,前者会继续执行前面的中间件逻辑,不论以后 UseWhen 的委托函数返回的是 true 还是 false,如果有点懵的话,能够了解一下上面的代码:
app.UseMiddlewareA();
app.UseWhen(context => context.Request.Path.StartsWithSegments("/api"), applicationBuilder =>
{applicationBuilder.UseMiddlewareB();
});
app.UseMiddlewareC();
如果中间件没有短路,那么中间件 A 和 C 必定会被执行的,而且当申请门路是以 /api
结尾时,中间件 B 也会被调度。
在 ASP.Net Core
申请解决管道中有一个中间件链,所有申请和响应都流经此管道,当新申请达到时,这些中间件要么解决申请,要么将申请传递给管道中的下一个组件,对于更简单的申请解决,咱们能够应用 Map 和 MapWhen 办法来分流管道,并能够应用 UseWhen 有条件的执行中间件。
译文链接:https://www.infoworld.com/art…
更多高质量干货:参见我的 GitHub: csharptranslate