## 1 设计原理与基本过程 在使用Spring声明式事务处理的时候,一种常用的方法是结合IoC容器和Spring已有的TransactionProxyFactoryBean对事务管理进行配置,比如,可以在这个TransactionProxyFactoryBean中为事务方法配置传播行为、并发事务隔离级别等事务处理属性,从而对声明式事务的处理提供指导。具体来说,在对声明式事务处理的原理分析中,声明式事务处理的实现大致可以分为以下几个部分: - 读取和处理在IoC容器中配置的事务处理属性,并转化为Spring事务处理需要的内部数据结构,这里涉及的类是TransactionAttributeSourceAdvisor,从名字可以看出,它是一个AOP通知器,Spring使用这个通知器来完成对事务处理属性值的处理。处理的结果是,在IoC容器中配置的事务处理属性信息,会被读入并转化成TransactionAttribute表示的数据对象,这个数据对象是Spring对事物处理属性值的数据抽象,对这些属性的处理是和TransactionProxyFactoryBean拦截下来的事务方法的处理结合起来的。 - Spring事务处理模块实现统一的事务处理过程。这个通用的事务处理过程包含处理事务配置属性,以及与线程绑定完成事务处理的过程,Spring通过TransactionInfo和TransactionStatus这两个数据对象,在事务处理过程中记录和传递相关执行场景。 - 底层的事务处理实现。对于底层的事务操作,Spring委托给具体的事务处理器来完成,这些具体的事务处理器,就是在IoC容器中配置声明式事务处理时,配置的PlatformTransactionManager的具体实现,比如DataSourceTransactionManager和HibernateTransactionManager等。 ## 2 实现分析 ### 2.1 事务处理拦截器的配置 和前面的思路一样,从声明式事务处理的基本用法入手,来了解它的基本实现原理。在使用声明式事务处理的时候,需要在IoC容器中配置TransactionProxyFactoryBean,见名知义,这是一个FactoryBean,有一个getObject()方法。在IoC容器进行注入的时候,会创建TransactionInterceptor对象,而这个对象会创建一个TransactionAttributePointcut,为读取TransactionAttribute做准备。在容器初始化的过程中,由于实现了InitializingBean接口,因此AbstractSingletonProxyFactoryBean会实现afterPropertiesSet()方法,正是在这个方法实例化了一个ProxyFactory,建立起Spring AOP的应用,在这里,会为这个ProxyFactory设置通知、目标对象,并最终返回Proxy代理对象。在Proxy代理对象建立起来以后,在调用其代理方法的时候,会调用相应的TransactionInterceptor拦截器,在这个调用中,会根据TransactionAttribute配置的事务属性进行配置,从而为事务处理做好准备。 从TransactionProxyFactoryBean入手,通过代码实现来了解Spring是如何通过AOP功能来完成事务管理配置的,Spring为声明式事务处理的实现所做的一些准备工作:包括为AOP配置基础设施,这些基础设施包括设置拦截器TransactionInterceptor、通知器DefaultPointcutAdvisor或TransactionAttributeSourceAdvisor。同时,在TransactionProxyFactoryBean的实现中, 还可以看到注人进来的PlatformTransactionManager和事务处理属性TransactionAttribute等。 ```java /** * 代理工厂bean用于简化声明式事务处理,这是标准AOP的一个方便的替代方案 * 使用单独的TransactionInterceptor定义。 */ @SuppressWarnings("serial") public class TransactionProxyFactoryBean extends AbstractSingletonProxyFactoryBean implements BeanFactoryAware { /** 事务拦截器,通过AOP来发挥作用,spring在此拦截器中封装了 事务处理实现 */ private final TransactionInterceptor transactionInterceptor = new TransactionInterceptor(); /** 切面 */ private Pointcut pointcut; /** * 通过依赖注入的事务属性以properties的形式出现 * 把从beandefinition中读到的事务管理的属性信息注入到transactionInterceptor */ public void setTransactionManager(PlatformTransactionManager transactionManager) { this.transactionInterceptor.setTransactionManager(transactionManager); } /** * 创建AOP对事务处理的advisor * 本方法在IoC容器完成Bean的依赖注入时,通过initializeBean方法被调用 */ @Override protected Object createMainInterceptor() { this.transactionInterceptor.afterPropertiesSet(); if (this.pointcut != null) { // 如果自己定义了切面,就使用默认的通知器,并为其配置事务处理拦截器 return new DefaultPointcutAdvisor(this.pointcut, this.transactionInterceptor); } else { // 如果没定义,则使用spring默认的切面,使用TransactionAttributeSourceAdvisor // 作为通知器,并配置拦截器 return new TransactionAttributeSourceAdvisor(this.transactionInterceptor); } } public void setTransactionAttributes(Properties transactionAttributes) { this.transactionInterceptor.setTransactionAttributes(transactionAttributes); } public void setTransactionAttributeSource(TransactionAttributeSource transactionAttributeSource) { this.transactionInterceptor.setTransactionAttributeSource(transactionAttributeSource); } public void setPointcut(Pointcut pointcut) { this.pointcut = pointcut; } public void setBeanFactory(BeanFactory beanFactory) { this.transactionInterceptor.setBeanFactory(beanFactory); } } ``` 以上代码完成了AOP配置,对于用户来说,一个值得关心的问题是,Spring的TransactionInterceptor配置是在什么时候被启动并成为Advisor通知器的一部分的呢?从对createMainInterceptor()方法的调用分析中可以看到,这个createMainInterceptor()方法在IoC容器完成Bean的依赖注入时,通过initializeBean()方法被调用,具体的调用过程如下图所示。 ![avatar](/images/springTransaction/createMainInterceptor()方法的调用链.png) 在TransactionProxyFactoryBean的父类AbstractSingletonProxyFactoryBean中的afterPropertiesSet()方法,是Spring事务处理完成AOP配置的地方,在建立TransactionProxyFactoryBean的事务处理拦截器的时候,首先需要对ProxyFactoryBean的目标Bean设置进行检查,如果这个目标Bean的设置是正确的,就会创建一个ProxyFactory对象,从而实现AOP的使用。在afterPropertiesSet()的方法实现中,可以看到为ProxyFactory生成代理对象、配置通知器、设置代理接口方法等。 ```java public abstract class AbstractSingletonProxyFactoryBean extends ProxyConfig implements FactoryBean, BeanClassLoaderAware, InitializingBean { private Object target; private Class[] proxyInterfaces; private Object[] preInterceptors; private Object[] postInterceptors; /** Default is global AdvisorAdapterRegistry */ private AdvisorAdapterRegistry advisorAdapterRegistry = GlobalAdvisorAdapterRegistry.getInstance(); private transient ClassLoader proxyClassLoader; private Object proxy; /** * 处理完成AOP配置,创建ProxyFactory对象,为其生成代理对象 * 配置通知器、设置代理接口方法 */ public void afterPropertiesSet() { // 校验target(目标对象) if (this.target == null) { throw new IllegalArgumentException("Property 'target' is required"); } if (this.target instanceof String) { throw new IllegalArgumentException("'target' needs to be a bean reference, not a bean name as value"); } if (this.proxyClassLoader == null) { this.proxyClassLoader = ClassUtils.getDefaultClassLoader(); } // 使用ProxyFactory完成AOP的基本功能,ProxyFactory提供proxy对象 // 并将TransactionIntercepter设为target方法调用的拦截器 ProxyFactory proxyFactory = new ProxyFactory(); if (this.preInterceptors != null) { for (Object interceptor : this.preInterceptors) { proxyFactory.addAdvisor(this.advisorAdapterRegistry.wrap(interceptor)); } } // 加入Advisor通知器,可以加入两种通知器,分别是: // DefaultPointcutAdvisor、TransactionAttributeSourceAdvisor // 这里通过调用TransactionProxyFactoryBean实例的createMainInterceptor()方法 // 来生成需要的Advisors。在ProxyFactory的基类AdvisedSupport中维护了一个持有Advisor // 的链表LinkedList,通过对这个链表中的元素执行增、删、改等操作,用来管理 // 配置给ProxyFactory的通知器 proxyFactory.addAdvisor(this.advisorAdapterRegistry.wrap(createMainInterceptor())); if (this.postInterceptors != null) { for (Object interceptor : this.postInterceptors) { proxyFactory.addAdvisor(this.advisorAdapterRegistry.wrap(interceptor)); } } proxyFactory.copyFrom(this); // 这里创建AOP的目标源,与在其它地方使用ProxyFactory没什么差别 TargetSource targetSource = createTargetSource(this.target); proxyFactory.setTargetSource(targetSource); if (this.proxyInterfaces != null) { proxyFactory.setInterfaces(this.proxyInterfaces); } else if (!isProxyTargetClass()) { // 需要根据AOP基础设施来确定使用哪个接口作为代理 proxyFactory.setInterfaces( ClassUtils.getAllInterfacesForClass(targetSource.getTargetClass(), this.proxyClassLoader)); } // 设置代理对象 this.proxy = proxyFactory.getProxy(this.proxyClassLoader); } } ``` DefaultAopProxyFactory创建AOP Proxy的过程在前面分析AOP的实现原理时已分析过,这里就不再重复了。可以看到,通过以上的一系列步骤,Spring为实现事务处理而设计的拦截器TransctionInterceptor已经设置到ProxyFactory生成的AOP代理对象中去了,这里的TransactionInterceptor是作为AOP Advice的拦截器来实现它的功能的。在IoC容器中,配置其他与事务处理有关的属性,比如,比较熟悉的transactionManager和事务处理的属性,也同样会被设置到已经定义好的TransactionInterceptor中去。这些属性配置在TransactionInterceptor对事务方法进行拦截时会起作用。在AOP配置完成以后,可以看到,在Spring声明式事务处理实现中的一些重要的类已经悄然登场,比如TransactionAttributeSourceAdvisor和TransactionInterceptor,正是这些类通过AOP封装了Spring对事务处理的基本实现。 ### 2.2 事务处理配置的读入 在AOP配置完成的基础上,以TransactionAttributeSourceAdvisor的实现为入 口,了解具体的事务属性配置是如何读入的。 ```java public class TransactionAttributeSourceAdvisor extends AbstractPointcutAdvisor { /** * 与其它Advisor一样,同样需要定义AOP中用到的Interceptor和Pointcut */ private TransactionInterceptor transactionInterceptor; /** * 对于切面pointcut,这里使用了一个匿名内部类 */ private final TransactionAttributeSourcePointcut pointcut = new TransactionAttributeSourcePointcut() { /** * 通过transactionInterceptor来得到事务的配置属性,在对Proxy的方法进行匹配调用时, * 会使用到这些配置属性 */ @Override protected TransactionAttributeSource getTransactionAttributeSource() { return (transactionInterceptor != null ? transactionInterceptor.getTransactionAttributeSource() : null); } }; } ``` 在声明式事务处理中,通过对目标对象的方法调用进行拦截来实现事务处理的织入,这个拦截通过AOP发挥作用。在AOP中,对于拦截的启动,首先需要对方法调用是否需要拦截进行判断,而判断的依据是那些在TransactionProxyFactoryBean中为目标对象设置的事务属性。也就是说,需要判断当前的目标方法调用是不是一个配置好的并且需要进行事务处理的方法调用。具体来说,这个匹配判断在TransactionAttributeSourcePointcut的matches()方法中完成,该方法实现 首先把事务方法的属性配置读取到TransactionAttributeSource对象中,有了这些事务处理的配置以后,根据当前方法调用的Method对象和目标对象,对是否需要启动事务处理拦截器进行判断。 ```java abstract class TransactionAttributeSourcePointcut extends StaticMethodMatcherPointcut implements Serializable { public boolean matches(Method method, Class targetClass) { TransactionAttributeSource tas = getTransactionAttributeSource(); return (tas == null || tas.getTransactionAttribute(method, targetClass) != null); } } ``` 在Pointcut的matches()判断过程中,会用到TransactionAttributeSource对象,这个TransactionAttributeSource对象是在对TransactionInterceptor进行依赖注入时就配置好的。它的设置是在TransactionInterceptor的基类TransactionAspectSupport中完成的,配置的是一个NameMatchTransactionAttributeSource对象。 ```java public abstract class TransactionAspectSupport implements BeanFactoryAware, InitializingBean { /** * 设置事务属性,以方法名为key,事务属性描述符为value * 例如:key = "myMethod", value = "PROPAGATION_REQUIRED,readOnly" */ public void setTransactionAttributes(Properties transactionAttributes) { // 可以看到这是一个NameMatchTransactionAttributeSource的实现 NameMatchTransactionAttributeSource tas = new NameMatchTransactionAttributeSource(); tas.setProperties(transactionAttributes); this.transactionAttributeSource = tas; } } ``` 在以上的代码实现中可以看到,NameMatchTransactionAttributeSource作为TransactionAttributeSource的具体实现,是实际完成事务处理属性读入和匹配的地方。在对事务属性TransactionAttributes进行设置时,会从事务处理属性配置中读取事务方法名和配置属性,在得到配置的事务方法名和属性以后,会把它们作为键值对加入到一个nameMap中。 在应用调用目标方法的时候,因为这个目标方法已经被TransactionProxyFactoryBean代理,所以TransactionProxyFactoryBean需要判断这个调用方法是否是事务方法。这个判断的实现,是通过在NameMatchTransactionAttributeSource中能否为这个调用方法返回事务属性来完成的。具体的实现过程是这样的:首先,以调用方法名为索引在nameMap中查找相应的事务处理属性值,如果能够找到,那么就说明该调用方法和事务方法是直接对应的,如果找不到,那么就会遍历整个nameMap,对保存在nameMap中的每一个方法名,使用PatternMatchUtils的simpleMatch()方法进行命名模式上的匹配。这里使用PatternMatchUtils进行匹配的原因是,在设置事务方法的时候,可以不需要为事务方法设置一个完整的方法名,而可以通过设置方法名的命名模式来完成,比如可以通过对通配符*的使用等。所以,如果直接通过方法名没能够匹配上,而通过方法名的命名模式能够匹配上,这个方法也是需要进行事务处理的,相对应地,它所配置的事务处理属性也会从nameMap中取出来,从而触发事务处理拦截器的拦截。 ```java public class NameMatchTransactionAttributeSource implements TransactionAttributeSource, Serializable { /** key是方法名,value是事务属性 */ private Map nameMap = new HashMap(); /** * 将给定属性transactionAttributes解析为名称/属性的map对象。以 方法名称 为键, * 字符串属性定义 为值,可通过TransactionAttributeEditor解析为TransactionAttribute实例。 */ public void setProperties(Properties transactionAttributes) { TransactionAttributeEditor tae = new TransactionAttributeEditor(); Enumeration propNames = transactionAttributes.propertyNames(); while (propNames.hasMoreElements()) { String methodName = (String) propNames.nextElement(); String value = transactionAttributes.getProperty(methodName); tae.setAsText(value); TransactionAttribute attr = (TransactionAttribute) tae.getValue(); addTransactionalMethod(methodName, attr); } } /** * 为事务方法添加属性 */ public void addTransactionalMethod(String methodName, TransactionAttribute attr) { if (logger.isDebugEnabled()) { logger.debug("Adding transactional method [" + methodName + "] with attribute [" + attr + "]"); } this.nameMap.put(methodName, attr); } /** * 对调用的方法进行判断,判断它是否是事务方法,如果是事务方法,则取出相应的事务配置属性 */ public TransactionAttribute getTransactionAttribute(Method method, Class targetClass) { // 直接通过 方法名 匹配 String methodName = method.getName(); TransactionAttribute attr = this.nameMap.get(methodName); if (attr == null) { // 查找最具体的名称匹配 String bestNameMatch = null; for (String mappedName : this.nameMap.keySet()) { if (isMatch(methodName, mappedName) && (bestNameMatch == null || bestNameMatch.length() <= mappedName.length())) { attr = this.nameMap.get(mappedName); bestNameMatch = mappedName; } } } return attr; } /** * 如果给定的方法名与映射的名称匹配,则返回 */ protected boolean isMatch(String methodName, String mappedName) { return PatternMatchUtils.simpleMatch(mappedName, methodName); } ``` 通过以上过程可以得到与目标对象调用方法相关的TransactionAttribute对象,在这个对象中,封装了事务处理的配置。具体来说,在前面的匹配过程中,如果匹配返回的结果是null,那么说明当前的调用方法不是一个事务方法,不需要纳入Spring统一的事务管理中,因为它并没有配置在TransactionProxyFactoryBean的事务处理设置中。如果返回的TransactionAttribute对象不是null,那么这个返回的TransactionAttribute对象就已经包含了对事务方法的配置信息,对应这个事务方法的具体事务配置也已经读入到TransactionAttribute对象中了,为TransactionInterceptor做好了对调用的目标方法添加事务处理的准备。 ### 2.3 事务处理拦截器的设计与实现 在完成以上的准备工作后,经过TransactionProxyFactoryBean的AOP包装, 此时如果对目标对象进行方法调用,起作用的对象实际上是一个Proxy代理对象,对目标对象方法的调用,不会直接作用在TransactionProxyFactoryBean设置的目标对象上,而会被设置的事务处理拦截器拦截。而在TransactionProxyFactoryBean的AOP实现中,获取Proxy对象的过程并不复杂,TransactionProxyFactoryBean作为一个FactoryBean,对这个Bean的对象的引用是通过调用其父类AbstractSingletonProxyFactoryBean的getObject()方法来得到的。 ```java public abstract class AbstractSingletonProxyFactoryBean extends ProxyConfig implements FactoryBean, BeanClassLoaderAware, InitializingBean { private Object proxy; // 返回的是一个proxy代理对象,这个proxy是ProxyFactory生成的AOP代理, // 已经封装了对事务处理的拦截器配置 public Object getObject() { if (this.proxy == null) { throw new FactoryBeanNotInitializedException(); } return this.proxy; } } ``` InvocationHandler的实现类中有一个非常重要的方法invoke(),该方法是proxy代理对象的回调方法,在调用proxy对象的代理方法时触发这个回调。事务处理拦截器TransactionInterceptor中实现了InvocationHandler的invoke()方法,其过程是,首先获得调用方法的事务处理配置;在得到事务处理配置以后,会取得配置的PlatformTransactionManager,由这个事务处理器来实现事务的创建、提交、回滚操作。 ```java public class TransactionInterceptor extends TransactionAspectSupport implements MethodInterceptor, Serializable { public Object invoke(final MethodInvocation invocation) throws Throwable { // 得到代理的目标对象,并将事务属性传递给目标对象 Class targetClass = (invocation.getThis() != null ? AopUtils.getTargetClass(invocation.getThis()) : null); // 在其父类TransactionAspectSupport中进行后续的事务处理 return invokeWithinTransaction(invocation.getMethod(), targetClass, new InvocationCallback() { public Object proceedWithInvocation() throws Throwable { return invocation.proceed(); } }); } } public abstract class TransactionAspectSupport implements BeanFactoryAware, InitializingBean { private static final ThreadLocal transactionInfoHolder = new NamedThreadLocal("Current aspect-driven transaction"); protected Object invokeWithinTransaction(Method method, Class targetClass, final InvocationCallback invocation) throws Throwable { // 获取事务属性,如果属性为空,则该方法是非事务性的 final TransactionAttribute txAttr = getTransactionAttributeSource().getTransactionAttribute(method, targetClass); final PlatformTransactionManager tm = determineTransactionManager(txAttr); final String joinpointIdentification = methodIdentification(method, targetClass); // 这里区分不同类型的PlatformTransactionManager,因为他们的调用方式不同, // 对CallbackPreferringPlatformTransactionManager来说,需要回调函数 // 来实现事务的创建和提交,而非CallbackPreferringPlatformTransactionManager // 则不需要 if (txAttr == null || !(tm instanceof CallbackPreferringPlatformTransactionManager)) { // 这里创建事务,同时把创建事务过程中得到的信息放到TransactionInfo中, // TransactionInfo是保存当前事务状态的对象 TransactionInfo txInfo = createTransactionIfNecessary(tm, txAttr, joinpointIdentification); Object retVal = null; try { // 这里的调用使处理沿着拦截器链进行,使最后目标对象的方法得以调用 retVal = invocation.proceedWithInvocation(); } catch (Throwable ex) { // 如果在事务处理方法调用中出现了异常,事务如何进行处理需要 // 根据具体情况考虑回滚或提交 completeTransactionAfterThrowing(txInfo, ex); throw ex; } finally { // 这里把 与线程绑定的TransactionInfo设置为oldTransactionInfo cleanupTransactionInfo(txInfo); } // 这里通过事务处理器来对事务进行提交 commitTransactionAfterReturning(txInfo); return retVal; } else { // 使用回调的方式来使用事务处理器 try { Object result = ((CallbackPreferringPlatformTransactionManager) tm).execute(txAttr, new TransactionCallback() { public Object doInTransaction(TransactionStatus status) { TransactionInfo txInfo = prepareTransactionInfo(tm, txAttr, joinpointIdentification, status); try { return invocation.proceedWithInvocation(); } catch (Throwable ex) { if (txAttr.rollbackOn(ex)) { // RuntimeException会导致事务回滚 if (ex instanceof RuntimeException) { throw (RuntimeException) ex; } else { throw new ThrowableHolderException(ex); } } else { // 如果正常返回,则提交该事务 return new ThrowableHolder(ex); } } finally { cleanupTransactionInfo(txInfo); } } }); // Check result: It might indicate a Throwable to rethrow. if (result instanceof ThrowableHolder) { throw ((ThrowableHolder) result).getThrowable(); } else { return result; } } catch (ThrowableHolderException ex) { throw ex.getCause(); } } } /** * 用于保存事务信息的不透明对象。子类必须将其传递回该类上的方法,但看不到其内部。 */ protected final class TransactionInfo { private final PlatformTransactionManager transactionManager; private final TransactionAttribute transactionAttribute; private final String joinpointIdentification; private TransactionStatus transactionStatus; private TransactionInfo oldTransactionInfo; public TransactionInfo(PlatformTransactionManager transactionManager, TransactionAttribute transactionAttribute, String joinpointIdentification) { this.transactionManager = transactionManager; this.transactionAttribute = transactionAttribute; this.joinpointIdentification = joinpointIdentification; } } } ``` 以事务提交为例,简要的说明下该过程。在调用代理的事务方法时,因为前面已经完成了一系列AOP配置,对事务方法的调用,最终启动 TransactionInterceptor拦截器的invoke()方法。在这个方法中,首先会读取该事务方法的事务属性配置,然后根据事务属性配置以及具体事务处理器的配置来决定采用哪一个事务处理器,这个事务处理器实际上是一个PlatformTransactionManager。在确定好具体的事务处理器之后,会根据事务的运行情况和事务配置来决定是不是需要创建新的事务。 对于Spring而言,事务的管理实际上是通过一个TransactionInfo对象来完成的,在该对象中,封装了事务对象和事务处理的状态信息,这是事务处理的抽象。在这一步完成以后,会对拦截器链进行处理,因为有可能在该事务对象中还配置了除事务处理AOP之外的其他拦截器。在结束对拦截器链处理之后,会对TransactionInfo中的信息进行更新,以反映最近的事务处理情况,在这个时候,也就完成了事务提交的准备,通过调用事务处理器PlatformTransactionManager的commitTransactionAfterReturning()方法来完成事务的提交。这个提交的处理过程已经封装在PlatformTransactionManager的事务处理器中了,而与具体数据源相关的处理过程,最终委托给相关的具体事务处理器来完成,比如DataSourceTransactionManager、Hibermate'TransactionManager等。 在这个invoke()方法的实现中,可以看到整个事务处理在AOP拦截器中实现的全过程。同时,它也是Spring采用AOP封装事务处理和实现声明式事务处理的核心部分。这部分实现是一个桥梁,它胶合了具体的事务处理和Spring AOP框架,可以看成是一个Spring AOP应用,在这个桥梁搭建完成以后,Spring事务处理的实现就开始了。