点击上方“dotNET名人堂”,选择“设为星标”
用学习的姿态,步入工作的状态
阅读目录
1.中间件的概念
1 Run
2 Use
3 Map
4 MapWhen
2 使用中间件记录错误日志
3 使用过滤器记录错误日志
1.中间件的概念
ASP.NET Core的处理流程是一个管道,中间件是组装到应用程序管道中用来处理请求和响应的组件。 每个中间件可以:
选择是否将请求传递给管道中的下一个组件。
可以在调用管道中的下一个组件之前和之后执行业务逻辑。
中间件是一个请求委托( public delegate Task RequestDelegate(HttpContext context) )的实例,所以中间件的本质就是一个方法,方法的参数是HttpContext,返回Task。传入的HttpContext参数包含了请求和响应信息,我们可以在中间件中对这些信息就行修改。中间件的管道处理流程如下:
我们知道中间件是配置请求处理管道的组件,那么谁来负责构建管道呢?负责构建管道的角色是ApplicationBuilder。ApplicationBuilder通过Use、Run、Map及MapWhen方法来注册中间件,构建请求管道。我们简单看下这几个方法。
1 Run
新建一个WebAPI项目,修改StartUp中的Configure方法如下,用Run方法注册的中间件可以叫做终端中间件,即该中间件执行完成后不再执行后续的中间件。
publicvoid Configure(IApplicationBuilder app, IHostingEnvironment env){
//第一个中间件 app.Run(async (context) => {
context.Response.ContentType = "text/plain;charset=utf-8";//防止中文乱码 await context.Response.WriteAsync("第一个中间件输出你好~"); }); //第二个中间件 app.Run(async (context) => {
await context.Response.WriteAsync("第二个中间件输出你好~"); });}
运行程序,我们看到只执行了第一个中间件,后边的中间件不会执行。
2 Use
Use方法的参数是一个委托实例,委托的第一个参数是HttpContext,这是待处理的请求上下文;第二个参数next是下一个中间件,我们可以通过next.Invoke()调用下一个中间件,并且可以在调用下一个中间件之前/之后对HttpContext做一个逻辑处理。
publicvoid Configure(IApplicationBuilder app, IHostingEnvironment env){
//第一个中间件 app.Use(async (context, next) => {
context.Response.ContentType = "text/plain;charset=utf-8";//防止中文乱码 await context.Response.WriteAsync($"第一个中间件输出你好~{Environment.NewLine}"); await context.Response.WriteAsync($"下一个中间件执行前执行===>{Environment.NewLine}"); await next.Invoke(); await context.Response.WriteAsync($"下一个中间件执行后执行<==={Environment.NewLine}"); }); //第二个中间件 app.Use(async (context,next) => {
await context.Response.WriteAsync($"第二个中间件输出你好~{Environment.NewLine}"); });}
运行程序如下所示。注意如果我们没有调用next.Invoke()方法,会造成管道短路,后续的所有中间件都不再执行。