Castle DynamicProxy基本用法(AOP)
本文介绍aop编程的基本概念、castle dynamicproxy(dp)的基本用法,使用第三方扩展实现对异步(async)的支持,结合autofac演示如何实现aop编程。
aop
百科中关于aop的解释:
aop为aspect oriented programming的缩写,意为:面向切面编程,通过预编译方式和运行期动态代理实现程序功能的统一维护的一种技术。aop是oop的延续,是软件开发中的一个热点……是函数式编程的一种衍生范型。利用aop可以对业务逻辑的各个部分进行隔离,从而使得业务逻辑各部分之间的耦合度降低,提高程序的可重用性,同时提高了开发的效率。
在aop中,我们关注横切点,将通用的处理流程提取出来,我们会提供系统通用功能,并在各业务层中进行使用,例如日志模块、异常处理模块等。通过aop编程实现更加灵活高效的开发体验。
dynamicproxy的基本用法
动态代理是实现aop的一种方式,即在开发过程中我们不需要处理切面中(日志等)的工作,而是在运行时,通过动态代理来自动完成。castle dynamicproxy是一个实现动态代理的框架,被很多优秀的项目用来实现aop编程,ef core、autofac等。
我们来看两段代码,演示aop的好处。在使用aop之前:
public class productrepository : iproductrepository { private readonly ilogger logger; public productrepository(ilogger logger) { this.logger = logger; } public void update(product product) { //执行更新操作 //...... //记录日志 logger.writelog($"产品{product}已更新"); } }
在使用aop之后:
public class productrepository : iproductrepository { public void update(product product) { //执行更新操作 //...... } }
可以明显的看出,在使用之前我们的productrepository依赖于ilogger,并在执行update操作以后,要写出记录日志的代码;而在使用之后,将日志记录交给动态代理来处理,降低了不少的开发量,即使遇见略微马虎的程序员,也不耽误我们日志的记录。
那该如何实现这样的操作呢?
- 首先,引用
castle.core
- 然后,定义拦截器,实现
iinterceptor
接口
public class loggerinterceptor : iinterceptor { private readonly ilogger logger; public loggerinterceptor(ilogger logger) { this.logger = logger; } public void intercept(iinvocation invocation) { //获取执行信息 var methodname = invocation.method.name; //调用业务方法 invocation.proceed(); //记录日志 this.logger.writelog($"{methodname} 已执行"); } }
- 最后,添加调用代码
static void main(string[] args) { ilogger logger = new consolelogger(); product product = new product() { name = "book" }; iproductrepository target = new productrepository(); proxygenerator generator = new proxygenerator(); iinterceptor loggerintercept = new loggerinterceptor(logger); iproductrepository proxy = generator.createinterfaceproxywithtarget(target, loggerintercept); proxy.update(product); }
至此,我们已经完成了一个日志拦截器,其它业务需要用到日志记录的时候,也可通过创建动态代理的方式来进行aop编程。
但是,调用起来还是比较复杂,需要怎么改进呢?当然是使用依赖注入(di)了。
autofac的集成
autofac集成了对dynamicproxy的支持,我们需要引用autofac.extras.dynamicproxy
,然后创建容器、注册服务、生成实例、调用方法,我们来看下面的代码:
containerbuilder builder = new containerbuilder(); //注册拦截器 builder.registertype<loggerinterceptor>().asself(); //注册基础服务 builder.registertype<consolelogger>().asimplementedinterfaces(); //注册要拦截的服务 builder.registertype<productrepository>().asimplementedinterfaces() .enableinterfaceinterceptors() //启用接口拦截 .interceptedby(typeof(loggerinterceptor)); //指定拦截器 var container = builder.build(); //解析服务 var productrepository = container.resolve<iproductrepository>(); product product = new product() { name = "book" }; productrepository.update(product);
对这段代码做一下说明:
- 注册拦截器时,需要注册为
asself
,因为服务拦截时使用的是拦截器的实例,这种注册方式可以保证容器能够解析到拦截器。 - 开启拦截功能:注册要拦截的服务时,需要调用
enableinterfaceinterceptors
方法,表示开启接口拦截; - 关联服务与拦截器:
interceptedby
方法传入拦截器,指定拦截器的方式有两种,一种是我们代码中的写法,对服务是无入侵的,因此推荐这种用法。另一种是通过intercept
特性来进行关联,例如我们上面的代码可以写为productrepository
类上添加特性[intercept(typeof(loggerinterceptor))]
- 拦截器的注册,可以注册为类型拦截器,也可以注册为命名的拦截器,使用上会有一些差异,主要在拦截器的关联上,此部分可以参考autofac官方文档。我们示例用的是类型注册。
- 拦截器只对公共的接口方法、类中的虚方法有效,使用时需要特别注意。
dynamicproxy的基本原理
上面我们说到动态代理只对公共接口方法、类中的虚方法生效,你是否想过为什么?
其实,动态代理是在运行时为我们动态生成了一个代理类,通过generator
生成的时候返回给我们的是代理类的实例,而只有接口中的方法、类中的虚方法才可以在子类中被重写。
如果不使用动态代理,我们的代理服务应该是什么样的呢?来看下面的代码,让我们手工创建一个代理类:
以下是我对代理类的理解,请大家辩证的看待,如果存在不正确的地方,还望指出。
为接口使用代理:
public class iproductrepositoryproxy : iproductrepository { private readonly ilogger logger; private readonly iproductrepository target; public productrepositoryproxy(ilogger logger, iproductrepository target) { this.logger = logger; this.target = target; } public void update(product product) { //调用iproductrepository的update操作 target.update(product); //记录日志 this.logger.writelog($"{nameof(update)} 已执行"); } } //使用代理类 iproductrepository target = new productrepository(); ilogger logger = new consolelogger(); iproductrepository productrepository = new productrepositoryproxy(logger, target);
为类使用接口:
public class productrepository : iproductrepository { //改写为虚方法 public virtual void update(product product) { //执行更新操作 //...... } } public class productrepositoryproxy : productrepository { private readonly ilogger logger; public productrepositoryproxy(ilogger logger) { this.logger = logger; } public override void update(product product) { //调用父类的update操作 base.update(product); //记录日志 this.logger.writelog($"{nameof(update)} 已执行"); } } //使用代理类 ilogger logger = new consolelogger(); productrepository productrepository = new productrepositoryproxy(logger);
异步(async/await)的支持
如果你站在应用程序的角度来看,异步只是微软的一个语法糖,使用异步的方法返回结果为一个task或task
我们本节仍然结合autofac进行处理,首先对代码进行改造,将 接下来定义我们的异步拦截器: 在我们上面的代码中,只实现了 由于 从代码中可以看到,异步拦截器 接下来我们修改di的服务注册部分: 以上便是通过 通过上面的介绍,我们已经了解了aop的基本用法,但是如何用在 我们知道,aop的初衷就是对使用者保持黑盒,通过抽取切面进行编程,而这两个问题恰恰需要我们对使用者进行修改,违背了solid原则。 那么,如果我们要在mvc中使用aop,有什么方法呢?其实mvc已经为我们提供了两种实现aop的方式: 这两种方式更符合我们的编码习惯,也体现了mvc框架的特性。 综上,不建议在mvc中对controller使用dp。如果采用nlayer架构,则可以在application层、domain层使用dp,来实现类似数据审计、sql跟踪等处理。 虽然不推荐,但还是给出代码,给自己多一条路: 参考文档:castle.core.asyncinterceptor
是帮我们处理异步拦截的框架,通过使用该框架可以降低异步处理的难度。productrepository.update
方法改为异步的。public class productrepository : iproductrepository
{
public virtual task<int> update(product product)
{
console.writeline($"{nameof(update)} entry");
//执行更新操作
var task = task.run(() =>
{
//......
thread.sleep(1000);
console.writeline($"{nameof(update)} 更新操作已完成");
//返回执行结果
return 1;
});
//返回
return task;
}
}
public class loggerasyncinterceptor : iasyncinterceptor
{
private readonly ilogger logger;
public loggerasyncinterceptor(ilogger logger)
{
this.logger = logger;
}
/// <summary>
/// 同步方法拦截时使用
/// </summary>
/// <param name="invocation"></param>
public void interceptsynchronous(iinvocation invocation)
{
throw new notimplementedexception();
}
/// <summary>
/// 异步方法返回task时使用
/// </summary>
/// <param name="invocation"></param>
public void interceptasynchronous(iinvocation invocation)
{
throw new notimplementedexception();
}
/// <summary>
/// 异步方法返回task<t>时使用
/// </summary>
/// <typeparam name="tresult"></typeparam>
/// <param name="invocation"></param>
public void interceptasynchronous<tresult>(iinvocation invocation)
{
//调用业务方法
invocation.returnvalue = internalinterceptasynchronous<tresult>(invocation);
}
private async task<tresult> internalinterceptasynchronous<tresult>(iinvocation invocation)
{
//获取执行信息
var methodname = invocation.method.name;
invocation.proceed();
var task = (task<tresult>)invocation.returnvalue;
tresult result = await task;
//记录日志
this.logger.writelog($"{methodname} 已执行,返回结果:{result}");
return result;
}
}
iasyncinterceptor
接口是异步拦截器接口,它提供了三个方法:
interceptsynchronous
:拦截同步执行的方法interceptasynchronous
:拦截返回结果为task的方法interceptasynchronous<tresult>
:拦截返回结果为taskinterceptasynchronous<tresult>
方法。iasyncinterceptor
接口和dp框架中的iinterceptor
接口没有关联,所以我们还需要一个同步拦截器,此处直接修改旧的同步拦截器:public class loggerinterceptor : iinterceptor
{
private readonly loggerasyncinterceptor interceptor;
public loggerinterceptor(loggerasyncinterceptor interceptor)
{
this.interceptor = interceptor;
}
public void intercept(iinvocation invocation)
{
this.interceptor.tointerceptor().intercept(invocation);
}
}
loggerasyncinterceptor
具有名为tointerceptor()
的扩展方法,该方法可以将iasyncinterceptor
接口的对象转换为iinterceptor
接口的对象。containerbuilder builder = new containerbuilder();
//注册拦截器
builder.registertype<loggerinterceptor>().asself();
builder.registertype<loggerasyncinterceptor>().asself();
//注册基础服务
builder.registertype<consolelogger>().asimplementedinterfaces();
//注册要拦截的服务
builder.registertype<productrepository>().asimplementedinterfaces()
.enableinterfaceinterceptors() //启用接口拦截
.interceptedby(typeof(loggerinterceptor)); //指定拦截器
var container = builder.build();
iasyncinterceptor
实现异步拦截器的方式。除了使用这种方式,我们也可以在在动态拦截器中判断返回结果手工处理,此处不再赘述。探讨:asp.net mvc中的切面编程
asp.net core
中呢?
services.addmvc()
.addcontrollersasservices();
builder.registertype<productcontroller>()
.enableclassinterceptors()
.interceptedby(typeof(controllerinterceptor));
[httppost]
public virtual task<int> update(product product)
{
return this.productrepository.update(product);
}