如安在 ASP.NET Core Web API 方法执行前后 “偷偷“ 作一些 “坏“ 事？初 ...

前言：什么是 ActionFilterAttribute？

ActionFilterAttribute 是一种作用于控制器 Action 方法的特性（Attribute），通过它，你可以在操作执行前后、异常处理时等不同的阶段插入自定义逻辑。
比如在执行操作方法之前修改请求参数、记录日记、进行权限验证等操作，在执行操作方法之后发送邮件、同步数据等等。
本文主要通过一些例子来说明什么是 ActionFilterAttribute 及如何应用。
Step By Step 步骤：

• 创建一个 asp.net core webapi 的项目
  
• 直接继承 ActionFilterAttribute 抽象类创建自定义的 Test1ActionFilterAttribute 类并注入 ILogger
  1. using Microsoft.AspNetCore.Mvc.Filters;
  3. namespace AttributeSample
  4. {
  5.         [AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = false)]
  6.         public class Test1ActionFilterAttribute: ActionFilterAttribute
  7.         {
  8.                 private ILogger<Test1ActionFilterAttribute> _logger;
  9.                
  10.                 // 在构造方法里注入 ILogger
  11.                 public Test1ActionFilterAttribute(ILogger<Test1ActionFilterAttribute> logger)
  12.                 {
  13.                         _logger = logger;
  14.                 }
  15.                
  16.                 /// <summary>
  17.                 /// 在控制器执行之前调用
  18.                 /// </summary>
  19.                 /// <param name="context"></param>
  20.                 public override void OnActionExecuting(ActionExecutingContext context)
  21.                 {
  22.                         _logger.LogInformation("在控制器执行之前调用...");
  23.                         base.OnActionExecuting(context);
  24.                 }
  26.                 /// <summary>
  27.                 /// 在控制器执行之后调用
  28.                 /// </summary>
  29.                 /// <param name="context"></param>
  30.                 public override void OnActionExecuted(ActionExecutedContext context)
  31.                 {
  32.                         _logger.LogInformation("在控制器执行之后调用...");
  33.                         base.OnActionExecuted(context);
  34.                 }
  35.         }
  36. }

  复制代码
• 通过实现 IActionFilter 接口创建自定义的 Test2ActionFilterAttribute 类并注入 ILogger（推荐方式）
  1. using Microsoft.AspNetCore.Mvc.Filters;
  3. namespace AttributeSample
  4. {
  5.         [AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = false)]
  6.         public class Test2ActionFilterAttribute: Attribute, IActionFilter
  7.         {
  8.                 private ILogger<Test2ActionFilterAttribute> _logger;
  9.                
  10.                 // 在构造方法里注入 ILogger
  11.                 public Test2ActionFilterAttribute(ILogger<Test2ActionFilterAttribute> logger)
  12.                 {
  13.                         _logger = logger;
  14.                 }
  15.                
  16.                 /// <summary>
  17.                 /// 在控制器执行之前调用
  18.                 /// </summary>
  19.                 /// <param name="context"></param>
  20.                 public void OnActionExecuting(ActionExecutingContext context)
  21.                 {
  22.                         _logger.LogInformation("在控制器执行之前调用...");
  23.                 }
  25.                 /// <summary>
  26.                 /// 在控制器执行之后调用
  27.                 /// </summary>
  28.                 /// <param name="context"></param>
  29.                 public void OnActionExecuted(ActionExecutedContext context)
  30.                 {
  31.                         _logger.LogInformation("在控制器执行之后调用...");
  32.                 }
  33.         }
  34. }

  复制代码
• 直接继承 ActionFilterAttribute 抽象类创建自定义的 Test3ActionFilterAttribute 类，不注入其他依靠
  1. using Microsoft.AspNetCore.Mvc.Filters;
  3. namespace AttributeSample
  4. {
  5.         [AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = false)]
  6.         public class Test3ActionFilterAttribute: Attribute, IActionFilter
  7.         {
  8.                 private string _myName;
  9.                 public Test3ActionFilterAttribute(string myName)
  10.                 {
  11.                         _myName = myName;
  12.                 }
  13.                 /// <summary>
  14.                 /// 在控制器执行之前调用
  15.                 /// </summary>
  16.                 /// <param name="context"></param>
  17.                 public void OnActionExecuting(ActionExecutingContext context)
  18.                 {
  19.                         _myName += " before";
  20.                 }
  22.                 /// <summary>
  23.                 /// 在控制器执行之后调用
  24.                 /// </summary>
  25.                 /// <param name="context"></param>
  26.                 public void OnActionExecuted(ActionExecutedContext context)
  27.                 {
  28.                         _myName += " after";
  29.                 }
  30.         }
  31. }

  复制代码
• 在控制器中应用自定义的 ActionFilterAttribute
  1. using Microsoft.AspNetCore.Mvc;
  2. using AttributeSample;
  3. using System.Reflection;
  5. namespace AttributeSample.Controllers
  6. {
  7.         [ApiController]
  8.         [Route("[controller]")]
  9.         public class WeatherForecastController : ControllerBase
  10.         {
  11.                 private static readonly string[] Summaries = new[]
  12.                 {
  13.                         "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
  14.                 };
  16.                 private readonly ILogger<WeatherForecastController> _logger;
  18.                 /// <summary>
  19.                 ///
  20.                 /// </summary>
  21.                 /// <param name="logger"></param>
  22.                 public WeatherForecastController(ILogger<WeatherForecastController> logger)
  23.                 {
  24.                         _logger = logger;
  25.                 }
  27.                 [HttpGet(Name = "GetWeatherForecast")]
  28.                 [TypeFilter(typeof(Test1ActionFilterAttribute))]
  29.                 [TypeFilter(typeof(Test2ActionFilterAttribute))]
  30.                 [Test3ActionFilter("Jacky")]
  31.                 public IEnumerable<WeatherForecast> Get()
  32.                 {
  33.                         var list = Enumerable.Range(1, 5).Select(index => new WeatherForecast
  34.                         {
  35.                                 Date = DateTime.Now.AddDays(index),
  36.                                 TemperatureC = Random.Shared.Next(-20, 55),
  37.                                 Summary = Summaries[Random.Shared.Next(Summaries.Length)]
  38.                         })
  39.                         .ToArray();
  40.                         _logger.LogInformation("执行方法...");
  41.                         return list;
  42.                 }
  43.         }
  44. }

  复制代码
• 在 Swaager 测试，可以看到其执行顺序如下：
  1. AttributeSample.Test1ActionFilterAttribute: Information: 在控制器执行之前调用...
  2. AttributeSample.Test2ActionFilterAttribute: Information: 在控制器执行之前调用...
  3. AttributeSample.Test3ActionFilterAttribute...
  4. AttributeSample.Controllers.WeatherForecastController: Information: 执行方法...
  5. AttributeSample.Test3ActionFilterAttribute...
  6. AttributeSample.Test2ActionFilterAttribute: Information: 在控制器执行之后调用...
  7. AttributeSample.Test1ActionFilterAttribute: Information: 在控制器执行之后调用...

  复制代码

总结：

• Asp.net core webapi 使用 ActionFilterAttribute，引用的是 Microsoft.AspNetCore.Mvc.Filters 而不是 System.Web.Http.Filters
  
  
  
  • System.Web.Http.Filters 是属于 .Net FrameWork 的命名空间
    
  
  
• ActionFilterAttribute 如果需要在构造方法中注入某些依靠，比如注入 ILogger，有几个使用方法：
  
  
  
  • TypeFilter，无需在IOC中注册，有自实现，本文例子便是使用这种方式
    
  • ServiceFilter，需要在 Program.cs 中针对该过滤器注册服务才能使用
    
  • 自定义 CustomIOCFilterFactoryAttribute 实现，依然需要对过滤器进行服务注册
    
  • 方法2和3比力复杂，以后有时间再针对这两种方式写一些例子
    
  
  
• 没有注入其他依靠的 ActionFilterAttribute 如一般 Attribute 使用即可，比如本文的第 3 个 ActionFilterAttribute
  
  
  
  • [Test3ActionFilter("Jacky")]
    
  
  

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

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