AOP面向切面编程的核心思想是将横切关注点从业务逻辑中分离,比如日志、异常处理、权限校验这些通用功能,不需要在每个业务方法里重复编写,而是通过切面统一处理。Castle.Core提供的动态代理能力,可以在不修改原有业务代码的前提下,为对象添加额外的行为,是实现AOP的常用方案。

Castle.Core实现AOP的核心组件
使用Castle.Core实现动态代理需要了解三个核心部分:
- IInterceptor接口:拦截器接口,所有自定义切面逻辑都需要实现这个接口,在接口的Intercept方法中编写横切逻辑。
- ProxyGenerator类:代理生成器,负责创建动态代理对象,支持类代理和接口代理两种模式。
- 被代理的目标对象:可以是普通的类或者接口的实现类,代理对象会在调用目标方法前后执行拦截器里的逻辑。
环境准备
首先需要在项目中安装Castle.Core的NuGet包,可以通过包管理器控制台执行以下命令:
// 安装Castle.Core包 Install-Package Castle.Core
如果是.NET Core或者.NET 5+项目,也可以通过dotnet命令安装:
dotnet add package Castle.Core
实现步骤详解
1. 定义业务接口和实现类
首先定义一个简单的业务接口和它的实现,作为被代理的目标:
// 业务接口
public interface IUserService
{
string GetUserName(int userId);
}
// 接口实现类
public class UserService : IUserService
{
public string GetUserName(int userId)
{
// 模拟业务逻辑
return $"用户ID为{userId}的用户名称";
}
}
2. 自定义拦截器实现IInterceptor接口
拦截器是AOP逻辑的核心,我们需要实现IInterceptor接口,在方法执行前后添加自定义逻辑:
using Castle.DynamicProxy;
// 自定义日志拦截器
public class LogInterceptor : IInterceptor
{
public void Intercept(IInvocation invocation)
{
// 方法执行前的逻辑
Console.WriteLine($"方法{invocation.Method.Name}开始执行,参数:{string.Join(",", invocation.Arguments)}");
// 执行目标方法
invocation.Proceed();
// 方法执行后的逻辑
Console.WriteLine($"方法{invocation.Method.Name}执行完成,返回值:{invocation.ReturnValue}");
}
}
这里的invocation.Proceed()是必须调用的,它会触发下一个拦截器或者目标方法的执行,如果不调用这个方法,目标方法就不会被执行。
3. 创建动态代理对象
使用ProxyGenerator创建代理对象,将拦截器和目标对象关联起来:
using Castle.DynamicProxy;
class Program
{
static void Main(string[] args)
{
// 创建代理生成器
ProxyGenerator proxyGenerator = new ProxyGenerator();
// 创建拦截器实例
LogInterceptor logInterceptor = new LogInterceptor();
// 创建目标对象
IUserService userService = new UserService();
// 创建接口代理对象
IUserService proxy = proxyGenerator.CreateInterfaceProxyWithTarget(userService, logInterceptor);
// 调用代理对象的方法
string result = proxy.GetUserName(1001);
Console.WriteLine($"最终输出结果:{result}");
}
}
如果需要代理类而不是接口,可以使用CreateClassProxy方法,要求被代理的类必须是可继承的,也就是不能是密封类:
// 被代理的类,不能是sealed
public class OrderService
{
public virtual string CreateOrder(string orderNo)
{
return $"创建订单:{orderNo}";
}
}
// 创建类代理
OrderService orderService = new OrderService();
OrderService orderProxy = proxyGenerator.CreateClassProxy<OrderService>(logInterceptor);
string orderResult = orderProxy.CreateOrder("ORD20240501");
注意类代理模式下,被代理的方法需要标记为virtual,否则拦截器无法生效。
多拦截器的执行顺序
Castle.Core支持同时添加多个拦截器,拦截器的执行顺序和添加顺序一致:
// 定义第二个拦截器,处理异常
public class ExceptionInterceptor : IInterceptor
{
public void Intercept(IInvocation invocation)
{
try
{
invocation.Proceed();
}
catch (Exception ex)
{
Console.WriteLine($"方法{invocation.Method.Name}执行出现异常:{ex.Message}");
invocation.ReturnValue = default;
}
}
}
// 添加多个拦截器
IInterceptor[] interceptors = new IInterceptor[] { logInterceptor, exceptionInterceptor };
IUserService multiProxy = proxyGenerator.CreateInterfaceProxyWithTarget(userService, interceptors);
执行顺序为:第一个拦截器前置逻辑 -> 第二个拦截器前置逻辑 -> 目标方法 -> 第二个拦截器后置逻辑 -> 第一个拦截器后置逻辑。
常见问题说明
| 问题 | 解决方案 |
|---|---|
| 拦截器不生效 | 检查被代理的方法是否是virtual(类代理模式),或者是否调用了invocation.Proceed() |
| 无法代理密封类 | Castle.Core无法代理sealed类,需要修改类的修饰符,或者改用接口代理模式 |
| 拦截器里获取不到返回值 | 需要在invocation.Proceed()调用之后才能获取invocation.ReturnValue,之前获取会是默认值 |
适用场景
这种AOP实现方式适合以下场景:
- 统一的日志记录,不需要在每个方法里写日志代码
- 全局的权限校验,在方法执行前判断用户是否有权限
- 事务管理,在方法执行前开启事务,执行后提交或者回滚
- 性能监控,统计方法的执行耗时
C#_AOP动态代理Castle_Core面向切面编程修改时间:2026-07-04 02:09:31