【每日一博】手把手教你写个 AOP 框架

Why AOP?

AOP（Aspect-Oriented Programming），意思是面 向切面编程 。传统的 OOP 面向对象相当于站在一个上帝模式从上往下看，里面的一块块都是一个对象，由我任意组合；而 AOP 不同之处在于，他是以一个旁观者的身法，从“侧面”看整个系统模块，看看哪里可以见缝插针，将自己想要处理的一段业务逻辑“编织”进去。

Code duplication is the ultimate code smell. It’s a sign that something is very wrong with implementation or design.（重复的代码会让代码的质量很糟糕。如果出现这个状况，那么一定是实现或者设计环境出了问题）

OOP本身是极力反对“ 重复发明轮子 ”的，但是有时却对重复的代码显得无可奈何，而 AOP 本身是一种很好的能解决这个问题的一种思想。

抽象了半天，还是利用一个例子还更加形象的解释吧。如果你要做一个权限系统，那么肯定需要在很多业务逻辑之前都加上一个权限判断——只有符合条件的才能完成后面的操作。如果利用传统思想，很显然你会把做权限判断的业务逻辑做封装，然后在每个业务逻辑执行之前都执行以下那片处理权限判断的代码。如下图：

看到没，每次一个判断每次一个判断，如果让这些权限判断的代码散落在系统的各个角落，那会是一个噩梦！就算采用 OOP 思想，将权限检查的业务放在一个类中，照样无济于事。因为每段业务代码开头总有这么一段抹不掉的身影（ doSecurityCheck ）。

这时， AOP 老兄终于按耐不住，要出场大展身手了！这位老兄马上说，放着那段业务逻辑代码，我来处理！

他首先将权限处理的部分视作一个 aspect （切面），然后想办法在运行时把切面 weave （编织）进业务逻辑中合适的位置。比如就像这样做：

这样， AOP 就成功的帮我把权限验证部分插入到调用代码的前面执行。具体调用哪个方法其实 AOP 并不知道，只要你把切面织入了用户登录，那后调用用户登录，只要你织入了用户查询，那就调用用户查询。而且不单单是只掉某一个方法，它可以挨着排的调用。

这只是其中一个强大的用处，还有像日志记录、性能分析、事务处理等更多都可以利用到 AOP 的地方。

Think of AOP as complementing, not competing with, OOP. AOP can supplement OOP where it is weak. （AOP和OOP没有竞争关系，相反，AOP能够很好的补充OOP的不足）

AOP 基本术语

l  Aspect（切面）：就是你想给程序织入的代码片段、如权限处理、日志记录等。

l  Weaving（编织）：就是给指定的程序加上额外的业务逻辑的过程，比如将权限验证插入到用户登录的过程。

l  Advice（通知）：表示是在程序的哪里织入切面，比如前面织入，还是后面织入，或者是抛出异常的时候织入。

l  Joinpoint（连接点）：表示给那个程序织入切面，也就是被代理的目标对象的目标方法。

l  Pointcut（切入点）：表示给哪些程序织入切面，是连接点的集合，比如是用户登录和用户查询等都需要被织入。

为了方便用户使用 AOP ，需要定义几种通知类型。

l  Before：前置通知，在业务逻辑之前通知

l  After：后置通知，在业务逻辑正常完结之后通知

l  End：结束通知，不管业务逻辑是否正常完结，都会在后面执行的通知

l  Error：错误通知，在业务逻辑抛出异常的时候通知

AOP 执行流程

下图展示了 AOP 核心调用过程，通过调用 AOP 代理类，开始一个一个调用后面的（前置）通知 / 拦截器链条，完成之后在调用目标方法，最后回来的时候接着调用（后置、结束）通知 / 拦截器链条。

如此一来就成功的完成了在 AOP 中给某个程序（目标方法）之前加上一段业务逻辑，之后加上一段业务逻辑的流程，并且杀伤力极大，可以将目标方法的范围进行任意控制。

动手实现一个 AOP

前戏那么长，高潮不会短！这次写的 AOP 参考了很多 Spring 的代码，吸收了大师补充的养分。

利用测试驱动开发的原则，我们先来考虑考虑我们会怎么用（写好测试代码），然后想想 API 怎么设计（将接口写好），最后考虑实现的问题。

 @Test  public void testTranscation() {   // 创建动态代理工厂，这是调用动态代理实现aop的初始点   AopProxyFactory proxy = new AopProxyFactory();   // 创建目标对象   proxy.setTarget(new AopDemo());   // 设置各个advice，以便在调用目标对象的指定方法时可以出现这些advice   proxy.addAdvice(new TransactionAspect());   // 获取代理对象   IAopDemo p = (IAopDemo) proxy.getProxy();   // 通过代理对象调用目标对象的指定方法   p.doSomething();  } 

参考 spring 的 API 设计，我们给出了上面这段测试代码。这样就能给 AOP 代理工厂配置目标对象，和各种各样的通知，目前只有事务处理的通知。然后通过代理工厂获取目标对象的代理对象，并完成类型转换的过程。最后调用指定方法，完成在这个方法的周围实现事务处理过程。

设置目标对象的方法无需赘言，就是看中了那个对象，设置进去，这样就能搞个代理帮他做了。。。

添加通知的实现，我想设计的好用一点。什么叫好用呢？也就是给你一些接口， Before 、 After 、 Error 、 End 等，只要你定义的 aspect 类（切面）实现了任意一个接口，就能保证按照这个接口名字所显示的那样执行。比如我实现了 Before 接口和他的抽象方法，并在里面加了个“记录日志”的功能，这样，我以后就能在我的目标方法执行之前完成一次记录日志的过程了。这里我们使用的是事务处理的 aspect 切面：

@Component @Match(methodMatch = "org.*.doSomething") public class TransactionAspect implements Before, End, Error {   @Override  public void error(Method method, Object[] args, Exception e) {   System.out.println("回滚事务");  }   @Override  public void before(Method method, Object[] args) {   System.out.println("开启事务");  }   @Override  public void end(Method method, Object[] args, Object retVal) {   System.out.println("关闭事务");  }  }

在代理工厂中，我们使用 Object  target 存储这个目标对象，并使用集合来记录所有该类涉及到的通知。

 private Object target;  private List<Advice> adviceList = new ArrayList<Advice>();  /**   *    * @Title: setTarget   * @Description: 设置目标   * @param @param target 设定文件   * @return void 返回类型   * @throws   */  public void setTarget(Object target) {   this.target = target;  }  public void addAdvice(Advice advice) {   if (advice == null)    throw new NullPointerException("添加的通知不能为空");   adviceList.add(advice);  } 

而在完成配置代理工厂后，需要通过这个代理工厂来获取代理对象。在获取代理对象之前，我们把之前完成的配置（目标方法、通知集合）都初始化到 AdvisedSupport 对象中，将这个对象整体传给后面的代理实现（ jdk 、 cglib ）完成代理类的初始化，以及通知和目标方法的调用。

 public Object getProxy() {   if (target == null)    throw new NullPointerException("目标对象不能为空");   AdvisedSupport config=new AdvisedSupport(target, adviceList);   AopProxy proxy = null;   // 若该目标对象实现了接口，就优先选择jdk动态代理；如果没有实现任何接口，就只能采用cglib动态代理；   if (config.hasInterfaces()) {    logger.info("采用jdk动态代理");    proxy = new JDKAopProxy(config);   } else {    logger.info("采用cglib动态代理");    proxy = new CglibAopProxy(config);   }   return proxy.getProxy();  } 

这里我们会根据不同的情况来判断他是选择jdk动态代理还是选择cglib动态代理。

这里以jdk动态代理为例，cglib留给读者自行分析：

public class JDKAopProxy implements AopProxy, InvocationHandler {   private AdvisedSupport config;   public JDKAopProxy(AdvisedSupport config) {   this.config = config;  }   @Override  public Object getProxy() {   return Proxy.newProxyInstance(config.getClassLoader(),     config.getInterfaces(), this);  }   @Override  public Object invoke(Object proxy, Method method, Object[] args)    throws Throwable {   return new ReflectiveMethodInvocation(config.getInterceptors(),config.getMatchers(), args,     method, config.getTarget()).proceed();  }  }

这里我们首先在 getProxy 初始化了代理类，然后当代理类的方法被调用时，会完成目标方法调用，这个步骤都是 ReflectiveMethodInvocation 对象完成的。这个类实现了 MethodInvocation ，目的是为了完成之后的回调过程，这个后面可以看到。在这个 ReflectiveMethodInvocation 类里面，我们存储了足够多的信息

 /**   * 通知advice   */  private List<MethodInterceptor> chain;  /**   * 每个advice所配置的匹配信息   */  private List<Matcher> matches;  /**   * 执行目标方法需要的参数   */  private Object[] arguments;  /**   * 目标方法   */  private Method method;  /**   * 目标对象   */  private Object target;  /**   * 记录当前advice链条（chain）所需要执行的方法的索引   */  private int index; 

目的很简单：就是将多个通知链条和目标对象的方法本身的调用整合起来，形成逻辑完善的链条——前置通知在目标方法前面排着队完成，如果目标方法抛出了异常就执行错误通知，一旦正常执行完成目标方法就执行后置通知，而结束通知时不管是是正常执行完目标方法还是抛出了异常，最后都会执行的一个通知。

下面来看看这个类中处理一连串方法调用的核心方法 proceed() ：

@Override  public Object proceed() throws Throwable {   //当链条走完的时候调用目标方法   if (index == chain.size())    return invokeJoinpoint();    Matcher matcher = matches.get(index);    // 查看是否匹配，   if (matcher.matches(this.method, this.target.getClass())) {    return chain.get(index++).invoke(this);   } else {    index++;    return proceed();   }   }   /**   *    * @Title: invokeJoinpoint   * @Description: 调用连接点方法   * @param @return   * @param @throws Throwable 设定文件   * @return Object 返回类型   * @throws   */  protected Object invokeJoinpoint() throws Throwable {   return method.invoke(target, arguments);  }

很简单，就是当链条走完的时候，调用目标方法。否则就继续指向链条上的方法。这里有一个检测是否匹配的过程，也就是我给我的切面类，也就是处理事务的切面TransactionAspect配置了一个注解Match，这个注解表示当目标类是org包下的某个类时，我就会对他的doSomething方法完成拦截，在这个方法周围加上事务处理。

@Component @Match(methodMatch = "org.*.doSomething") public class TransactionAspect implements Before, End, Error {   @Override  public void error(Method method, Object[] args, Exception e) {   System.out.println("回滚事务");  }   @Override  public void before(Method method, Object[] args) {   System.out.println("开启事务");  }   @Override  public void end(Method method, Object[] args, Object retVal) {   System.out.println("关闭事务");  }  }

具体判断是否匹配，我采用的是正则表达式，也就是当目标类的某个方法被调用时，一旦检测到他符合methodMatch配置的正则表达式，就给该方法前后加上指定的逻辑。如果发现不匹配，这继续寻找链条上下一个通知，直到走完整个通知链条。

这里大家肯定会有一个问题：在链条上获取到一个通知，执行该通知的时候，如何确保前置通知是再前面执行，后置通知是再后面执行呢？并且在完成调用之后确保执行后面的通知调用流程？

其实，spring在这里用到了一个很巧妙的编程技巧——通过多态原理和回调函数来处理。

chain.get(index++).invoke(this);

这里获取到了第index个通知，拿到的是个接口类型，但是实现类出卖了他的本质，表示它到底是前置还是后置或者是其他等。当执行invoke时，将该 MethodInvocation 的实现类 ReflectiveMethodInvocation 的对象的引用传递进去。如此调用的方法，其实是这样的：

可以发现，当实现类是后置通知的时候，我会选择AfterInterceptor来执行，当时前置通知的时候，会选择BeforeInterceptor来执行。也就是，碰到合适的通知，就采用合适的拦截器处理。

以前置通知的方法拦截器为例：

public class BeforeInterceptor implements MethodInterceptor {   private Before advice;   public BeforeInterceptor(Before advice) {   this.advice =advice;  }   @Override  public Object invoke(MethodInvocation mi) throws Throwable {   advice.before(mi.getMethod(), mi.getArguments());   return mi.proceed();  }  }

看到这里是不是有种似曾相识的感觉，这不就是开始那个权限验证的翻版么？对啊，it is。这里实现的很明确，就是在目标方法调用之前执行before中的业务逻辑，接着进行mi.proceed()又回调到了我们 MethodInvocation 的实现类 ReflectiveMethodInvocation 中的 proceed 方法中了。

这样，也就保证了链条的次序执行。

来看看我们测试用例的输出结果吧：

开启事务  和哈哈哈哈哈...  关闭事务

目前还没能把ioc和aop整合起来使用，还有像ioc在web mvc框架中如何使用都还没提到，不过这些会在我们以后的博客中不断出现。

源代码

最后，放出源代码： https://github.com/mjaow/my_spring