ASP.NET Core MVC 项目 AOP之IActionFilter和IAsyncActionFilter

文章详细介绍了在ASP.NETCoreMVC中使用IActionFilter和IAsyncActionFilter实现日志记录的同步与异步方法。通过控制器代码和过滤器类的示例,展示了如何在Action执行前后记录请求和响应信息。日志记录对于调试和监控应用程序非常有用。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

目录

一:说明

二:IActionFilter同步

三:IAsyncActionFilter异步


一:说明

IActionFilter同步过滤器与IAsyncActionFilter异步过滤器常常被用作于日志。

IActionFilter同步过滤器执行顺序:

1:执行控制器中的构造函数,实例化控制器

2:执行ActionFilter.OnActionExecuting方法

3:执行具体的Action方法

4:执行ActionFilter.OnActionExecuted方法


IActionFilter同步过滤器与IAsyncActionFilter异步过滤器搭配Log4Net或NLog效果更佳。


二:IActionFilter同步

控制器代码:


        /// <summary>
        /// Get请求
        /// 应用ActionFilter扩展
        /// Home控制器的Index
        /// </summary>
        /// <returns>Index视图</returns>
        [HttpGet]
        [TypeFilter(typeof(ActionFilter))]
        public IActionResult Index(int id)
        {
            object Info = "请求Home控制器Index方法成功!";
            return View(Info);
        }

关键类ActionFilter代码:

using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.Filters;
using Newtonsoft.Json;
using Study_ASP.NET_Core_MVC.Controllers;

namespace Study_ASP.NET_Core_MVC.Utility.Filters
{
    public class ActionFilter : Attribute, IActionFilter
    {
        /// <summary>
        /// 初始化构造函数
        /// </summary>
        private readonly ILogger<ActionFilter> _logger;
        public ActionFilter(ILogger<ActionFilter> logger)
        {
            _logger = logger;
        }
        /// <summary>
        /// 在XXX执行之前
        /// </summary>
        /// <param name="context"></param>
        public void OnActionExecuting(ActionExecutingContext context)
        {
            var controller = context.HttpContext.GetRouteValue("Controller");
            var action = context.HttpContext.GetRouteValue("Action");
            var param = context.Result;
            _logger.LogInformation($"当前请求的控制器:{controller},方法:{action},请求参数:{JsonConvert.SerializeObject(param)}");
        }
        /// <summary>
        /// 在XXX执行之后
        /// </summary>
        /// <param name="context"></param>
        public void OnActionExecuted(ActionExecutedContext context)
        {
            var controller = context.HttpContext.GetRouteValue("Controller");
            var action = context.HttpContext.GetRouteValue("Action");
            var param = context.Result;
            _logger.LogInformation($"当前请求的控制器:{controller},方法:{action},请求结果:{JsonConvert.SerializeObject(param)}");
        }
    }
}

效果截图:

 日志记录:

2023-02-13 19:06:27.5242|0|INFO|Study_ASP.NET_Core_MVC.Utility.Filters.ActionFilter|当前请求的控制器:Home,方法:Index,请求参数:"?id=123456789" 
2023-02-13 19:06:27.5568|0|INFO|Study_ASP.NET_Core_MVC.Utility.Filters.ActionFilter|当前请求的控制器:Home,方法:Index,请求结果:"{\"StatusCode\":null,\"ViewName\":null,\"Model\":\"请求Home控制器Index方法成功!\",\"ViewData\":{},\"TempData\":{},\"ViewEngine\":null,\"ContentType\":null}" 

三:IAsyncActionFilter异步

控制器代码:


        /// <summary>
        /// Get请求
        /// 应用ActionAsyncFilter扩展
        /// Home控制器的Index
        /// </summary>
        /// <returns>Index视图</returns>
        [HttpGet]
        [TypeFilter(typeof(ActionAsyncFilter))]
        public IActionResult Index(int id)
        {
            object Info = "请求Home控制器Index方法成功!";
            return View(Info);
        }

关键类ActionAsyncFilter代码:

using Microsoft.AspNetCore.Mvc.Filters;
using Newtonsoft.Json;

namespace Study_ASP.NET_Core_MVC.Utility.Filters
{
    public class ActionAsyncFilter : Attribute, IAsyncActionFilter
    {
        /// <summary>
        /// 初始化构造函数
        /// </summary>
        private readonly ILogger<ActionAsyncFilter> _logger;
        public ActionAsyncFilter(ILogger<ActionAsyncFilter> logger)
        {
            _logger = logger;
        }
        /// <summary>
        /// 在XXX执行时
        /// </summary>
        /// <param name="context"></param>
        /// <param name="next"></param>
        /// <returns></returns>
        /// <exception cref="NotImplementedException"></exception>
        public async Task OnActionExecutionAsync(ActionExecutingContext context, ActionExecutionDelegate next)
        {
            var controller = context.HttpContext.GetRouteValue("Controller");
            var action = context.HttpContext.GetRouteValue("Action");
            var param = context.HttpContext.Request.QueryString.Value;
            _logger.LogInformation($"当前请求的控制器:{controller},方法:{action},请求参数:{JsonConvert.SerializeObject(param)}");
            ActionExecutedContext executedContext = await next.Invoke();
            _logger.LogInformation($"当前请求的控制器:{controller},方法:{action},请求结果:{JsonConvert.SerializeObject(executedContext.Result)}");
        }
    }
}

效果截图:

### .NET Core Filters Interceptors 的区别及使用场景 #### 定义与功能差异 .NET Core 中的 **Filters** 是一种用于处理请求响应生命周期的方法,主要用于 MVC 或 Web API 应用程序中。它们可以执行诸如日志记录、身份验证、授权以及修改输入/输出数据的操作[^3]。 相比之下,**Interceptors** 更常见于依赖注入(DI)容器上下文中,尤其是在使用像 Autofac 这样的第三方库时。Interceptor 主要通过 AOP(面向切面编程)模式实现,在方法调用前后插入逻辑[^4]。 --- #### 工作机制对比 - **Filters** 在 ASP.NET Core 中,Filter 可以分为多种类型,包括 `Authorization`、`Resource`、`Action` `Result` Filter。这些 Filter 都是在 HTTP 请求管道的不同阶段运行。例如,`Action Filter` 负责在控制器操作之前或之后执行逻辑;而 `Exception Filter` 则专门捕获异常并提供统一错误处理方式[^5]。 - **Interceptors** Interceptor 的工作原理基于动态代理技术。当某个服务被注册到 DI 容器并通过配置启用拦截后,每次对该服务实例化或者其成员函数调用时都会触发预定义好的拦截行为。这种设计非常适合跨领域关注点分离的需求,比如性能监控、事务管理等[^6]。 --- #### 使用场景分析 ##### Filters 的典型应用场景: 1. **权限控制**:利用 Authorization Filter 实现细粒度访问策略。 2. **参数校验**:借助 Model Validation Feature 自动完成模型绑定前的数据合法性检查。 3. **缓存优化**:创建自定义 Result Filter 来决定是否返回已存储的结果而不是重新计算业务逻辑。 4. **全局异常捕捉**:设置 Exception Filter 统一格式化未被捕获的 runtime errors 并反馈给客户端[^7]。 ##### Interceptors 的适用范围: 1. **审计跟踪**:每当特定接口下的任何方法被执行时自动记录相关信息至数据库或其他持久介质。 2. **分布式追踪**:配合 tracing libraries 对远程过程调用链路进行全面剖析以便定位瓶颈所在位置。 3. **重试机制**:针对不稳定外部资源连接尝试多次直到成功为止从而提高系统鲁棒性。 4. **安全性增强**:加密解密敏感信息流经内存期间的内容保护措施[^8]。 --- #### 技术选型建议 如果目标是围绕 HTTP 请求构建附加特性,则优先考虑 Filters;而对于更通用的服务层横切需求来说,采用 Interceptors 将会更加灵活高效。当然实际开发过程中也可能存在两者混合使用的状况取决于具体项目架构技术栈偏好[^9]。 ```csharp // Example of a custom Action Filter in .NET Core public class SampleActionFilter : IActionFilter { public void OnActionExecuting(ActionExecutingContext context) { Console.WriteLine("Before the action method executes."); } public void OnActionExecuted(ActionExecutedContext context) { Console.WriteLine("After the action method executes."); } } // Registering an interceptor using Autofac.Extras.DynamicProxy builder.RegisterType<MyService>() .EnableInterfaceInterceptors() .InterceptWith<LoggingInterceptor>(); ```
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

Vin Cente

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值