SpringMvc + Mybatis项目中 使用 Atomikos实现分布式事务

背景：项目架构使用了SpringMvc + Mybatis，同时在使用多数据源的时候需要满足事务一致性

　　通俗的说法是：项目中配置了多个数据源，并且在一个service方法中使用多个数据源的时候需要保证事务一致性。

　　网上的主流资料大概讲解了两种spring对分布式事务的实现：jotm和Atomikos，需要注意的是使用jotm的时候需要用到一个类org.springframework.transaction.jta.JotmFactoryBean然而在spring 3.x之后移除了这个类，所以我采用了Atomikos的方式。

　　实现过程如下：

　　1、在使用了Atomikos之后需要注意DataSource不能再使用c3p0 之类的驱动了，需要用到com.atomikos.jdbc.AtomikosDataSourceBean，下面是两个DataSource的配置示例：

　　

<bean id="dataSource" class="com.atomikos.jdbc.AtomikosDataSourceBean" init-method="init" destroy-method="close">
        <property name="uniqueResourceName" value="XA1DBMS1" />  
        <property name="xaDataSourceClassName" value="com.mysql.jdbc.jdbc2.optional.MysqlXADataSource" />  
        <property name="xaProperties">  
            <props>  
                <prop key="URL">${dataPortal_mysql_jdbc_url}</prop>  
                <prop key="user">${dataPortal_mysql_jdbc_user}</prop>  
                <prop key="password">${dataPortal_mysql_jdbc_password}</prop>  
            </props>  
        </property>  
        <property name="poolSize" value="3" />  
        <property name="minPoolSize" value="3" />  
        <property name="maxPoolSize" value="5" />
    </bean>
    
    <bean id="webDataSource" class="com.atomikos.jdbc.AtomikosDataSourceBean" init-method="init" destroy-method="close">
        <property name="uniqueResourceName" value="XA1DBMS2" />  
        <property name="xaDataSourceClassName" value="com.mysql.jdbc.jdbc2.optional.MysqlXADataSource" />  
        <property name="xaProperties">  
            <props>  
                <prop key="URL">${web.jdbc.url}</prop>  
                <prop key="user">${web.jdbc.username}</prop>  
                <prop key="password">${web.jdbc.password}</prop>  
            </props>  
        </property>  
        <property name="poolSize" value="3" />  
        <property name="minPoolSize" value="3" />  
        <property name="maxPoolSize" value="5" />
    </bean>

　这里一些其他的参数，比如最大连接数，超时时间的参数我是在com.atomikos.jdbc.AtomikosDataSourceBean源码中找到的：

　

两个DataSource中webDataSource我采用的是spring的JdbcTemplate去写sql而dataSource则配置使用了mybatis的方式

2、两种不同的方式配置如下：

<!-- web库jdbcTemplate -->
    <bean id="webJdbcTemplate" class="org.springframework.jdbc.core.JdbcTemplate">
        <property name="dataSource" ref="webDataSource" />
    </bean>
    <!-- gmt库jdbcTemplate -->
    <bean id="jdbcTemplate" class="org.springframework.jdbc.core.JdbcTemplate">
        <property name="dataSource">
            <ref bean="dataSource" />
        </property>
    </bean>
    
    <!-- 创建SqlSessionFactory，同时指定数据源 -->
    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
        <property name="dataSource" ref="dataSource" />
        <property name="mapperLocations"  value="classpath:com/sincetimes/modernship/**/dao/*.xml"/>
    </bean>
    
    <!-- mybatis自动扫描器 -->
    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <property name="basePackage" value="com.sincetimes.modernship.dao" />
        <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory" />
    </bean>
    
    <!-- DAO使用mybatis进行数据库访问操作 -->
    <bean id="sqlSessionTemplate" class="org.mybatis.spring.SqlSessionTemplate">
        <constructor-arg index="0" ref="sqlSessionFactory" />
    </bean>

3、在配置事务的时候，我们可以使用@Transactional注解，也可以写aop

<!-- 分布式事务 -->
    <bean id="userTransaction" class="com.atomikos.icatch.jta.UserTransactionImp">  
        <property name="transactionTimeout" value="300" />  
    </bean>  

    <bean id="springTransactionManager" class="org.springframework.transaction.jta.JtaTransactionManager">  
        <property name="userTransaction" ref="userTransaction" />   
    </bean>

    <tx:annotation-driven transaction-manager="springTransactionManager"/>

    <aop:config>
        <aop:pointcut id="baseServiceMethods" expression="execution(* com.sincetimes..impl..*.*(..))" />
        <aop:advisor pointcut-ref="baseServiceMethods" advice-ref="txAdvice"/>
    </aop:config>

    <!-- 配置事务的传播特性 -->
    <tx:advice id="txAdvice" transaction-manager="springTransactionManager">
        <tx:attributes>
            <tx:method name="query*" propagation="REQUIRED" read-only="true" />
            <tx:method name="get*" propagation="REQUIRED" read-only="true" />
            <tx:method name="find*" propagation="REQUIRED" read-only="true" />
            <tx:method name="list*" propagation="REQUIRED" read-only="true" />
            <tx:method name="count*" propagation="REQUIRED" read-only="true" />
            <tx:method name="insert*" propagation="REQUIRED" />
            <tx:method name="add*" propagation="REQUIRED" />
            <tx:method name="del*" propagation="REQUIRED" />
            <tx:method name="save*" propagation="REQUIRED" />
            <tx:method name="update*" propagation="REQUIRED" />
            <tx:method name="edit*" propagation="REQUIRED" />
            <tx:method name="enable*" propagation="REQUIRED" />                
            <tx:method name="upload*" propagation="REQUIRED" />                
        </tx:attributes>
    </tx:advice>

分布式事务中的重点是事务管理器。在Atomikos中对应的就是 com.atomikos.icatch.jta.UserTransactionManager 

4、如果项目使用了log4j的话，并且日志级别为info，在项目启动后会发现有很多atomikos的info日志打印出来，这个时候在log4j的配置文件中增加一个配置：log4j.logger.com.atomikos = error 即可。

这里参考了网上找到的资料：https://my.oschina.net/pingpangkuangmo/blog/413518