在 ASP.NET Core Web API 中使用操作筛选器统一处理通用操作 ...

媒介：什么是操作筛选器

操作筛选器是 ASP.NET Core Web API 中的一种过滤器，用于在实行控制器操作（Action）之前或之后实行一些代码，完成特定的功能，比如实行日志记录、身份验证、授权、异常处理等通用的处理逻辑。
每次 ASP.NET Core Web API 中控制器的操作方法被实行的时间，操作筛选器都会被实行，所以操作筛选器默认是应用于全部控制器的操作方法的。
一个项目中可以注册多个操作筛选器，这些操作筛选器构成一个链，上一个筛选器实行完了再实行下一个。next 就是一个用来指向下一个操作筛选器的委托，如果当前的操作筛选器是最后一个筛选器的话，next 就会实行要实行的操作方法。
操作筛选器跟前文（见《怎样在 ASP.NET Core Web API 方法实行前后 “偷偷“ 作一些 “坏“ 事？初识 ActionFilterAttribute》）讲过的 ActionFilterAttribute 比较相似，ActionFilterAttribute 是用于将操作筛选器逻辑应用于控制器操作的一种方式，而操作筛选器是一种更广泛的概念，可以说，ActionFilterAttribute 是操作筛选器的一种特定实现方式，它通过特性的方式将操作筛选器逻辑应用于控制器操作。
Step By Step 步骤

• 创建一个 ASP.NET Core Web API 项目
  
• 编写两个自定义的操作筛选器 MyActionFilter1 和 MyActionFilter2，实现 IAsyncActionFilter 接口（注意看代码中的解释）
  1. using Microsoft.AspNetCore.Mvc.Filters;
  3. public class MyActionFilter1 : IAsyncActionFilter
  4. {
  5.         // context 参数代表 Action 执行的上下文对象，从 context 中我们可以获取请求的路径、参数值等信息
  6.         // next 参数代表下一个要执行的操作筛选器
  7.         public async Task OnActionExecutionAsync(
  8.                 ActionExecutingContext context,
  9.                 ActionExecutionDelegate next)
  10.         {
  11.                 // next 之前的代码是在操作方法执行之前要执行的代码
  12.                 Console.WriteLine("MyActionFilter 1:开始执行");
  14.                 // 用 next 来执行下一个操作筛选器，
  15.                 // 如果这是最后一个操作筛选器，它就会执行实际的操作方法
  16.                 // next 的返回值是操作方法的执行结果，返回值是 ActionExecutedContext 类型的。
  17.                 // 如果操作方法执行的时候出现了未处理异常，
  18.                 // 那么 ActionExecutedContext 的 Exception 属性就是异常对象，
  19.                 // ActionExecutedContext 的 Result 属性就是操作方法的执行结果。
  20.                 ActionExecutedContext r = await next();
  21.                
  22.                 // 以下代码则是在操作方法执行之后要执行的代码
  23.                 if (r.Exception != null)
  24.                 {
  25.                         Console.WriteLine("MyActionFilter 1:执行失败");
  26.                 }
  27.                 else
  28.                 {
  29.                         Console.WriteLine("MyActionFilter 1:执行成功");
  30.                 }
  31.         }
  32. }
  34. public class MyActionFilter2 : IAsyncActionFilter
  35. {
  36.         public async Task OnActionExecutionAsync(
  37.                 ActionExecutingContext context,
  38.                 ActionExecutionDelegate next)
  39.         {
  40.                 Console.WriteLine("MyActionFilter 2:开始执行");
  41.                 ActionExecutedContext r = await next();
  42.                 if (r.Exception != null)
  43.                 {
  44.                         Console.WriteLine("MyActionFilter 2:执行失败");
  45.                 }
  46.                 else
  47.                 {
  48.                         Console.WriteLine("MyActionFilter 2:执行成功");
  49.                 }
  50.         }
  51. }

  复制代码
• 打开 Program.cs，注册这两个操作筛选器
  1. using Microsoft.AspNetCore.Mvc;
  3. var builder = WebApplication.CreateBuilder(args);
  5. // Add services to the container.
  7. builder.Services.AddControllers();
  8. // Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle
  9. builder.Services.AddEndpointsApiExplorer();
  10. builder.Services.AddSwaggerGen();
  12. // 注册操作筛选器服务
  13. builder.Services.Configure<MvcOptions>(options => {
  14.         options.Filters.Add<MyActionFilter1>();
  15.         options.Filters.Add<MyActionFilter2>();
  16. });
  18. var app = builder.Build();
  20. // Configure the HTTP request pipeline.
  21. if (app.Environment.IsDevelopment())
  22. {
  23.         app.UseSwagger();
  24.         app.UseSwaggerUI();
  25. }
  27. app.UseHttpsRedirection();
  29. app.UseAuthorization();
  31. app.MapControllers();
  33. app.Run();

  复制代码
• 打开控制器，增长一个用于测试的操作方法
  1. using Microsoft.AspNetCore.Mvc;
  3. namespace 操作筛选器.Controllers
  4. {
  5.         [ApiController]
  6.         [Route("[controller]/[action]")]
  7.         public class TestController : ControllerBase
  8.         {
  9.                 [HttpGet]
  10.                 public string GetData()
  11.                 {
  12.                         Console.WriteLine("执行GetData");
  13.                         return "yzk";
  14.                 }
  15.         }
  16. }

  复制代码

测试运行和效果

1. 执行顺序：
2. MyActionFilter 1:开始执行
3. MyActionFilter 2:开始执行
4. 执行GetData
5. MyActionFilter 2:执行成功
6. MyActionFilter 1:执行成功

复制代码

我是老杨，一个执着于编程乐趣、至今奋斗在一线的 10年+ 资深研发老鸟，是软件项目管理师，也是快乐的程序猿，持续免费分享全栈实用编程技巧、项目管理履历和职场成长心得！欢迎关注老杨的公众号（名称：代码掌控者），和你共同探索代码世界的奥秘！

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。