在spring、tomcat中使用多数据源并支持分布式事务管理

q456123

题目起得有点模糊，第一次接触这东西，还不怎么理解。
起因：
小项目，没有用分布式，但要操作两个数据库。本以为随便用spring配置两个数据源就搞定，查询是没问题，问题是有一个数据库老是插不进数据。Google狂搜之后，大概了解到是事务控制的问题。我用的是spring的声明式事务管理(<tx:annotation-driven/>)。用一般的数据源配置，只有一个数据源的事务生效，其它数据源只能读不能写。
有帖子说，要支持多数据源的事务，只能用JTA事务管理（没用过 -_-||），而且应用服务器还不能是Tomcat（一直在用tomcat，不想换-_-!!），头疼了。幸亏后面还有说，有第三方的实现支持JTA事务管理，一是JOTM，一是Atomikos。只要用了其中一个，还能继续用Tomcat。因为名字短，先考虑用JOTM。到官网一看，最后更新日期是2010年。。呃。。转向Atomikos。在Atomikos的官网看看文档，看看例子，边做边调试，一个下午下来，总算有点成果，高兴之余做个记录。其中会涉及到一些概念，比如分布式事务、JTA、XA，我都有搜来了解一下，因理解肤浅没法做记录。下面只是记录atomikos配合spring的使用方法：
1、依赖包
Atomikos的：
transactions-jdbc
transactions-jta
transactions-api
transactions
atomikos-utils
还有一个不要忘了，是jta的包。
用maven要简单一点，只需要加入两个依赖：
<dependency>
<groupId>com.atomikos</groupId>
<artifactId>transactions-jdbc</artifactId>
<version>3.7.0</version>
</dependency>
<dependency>
<groupId>javax.transaction</groupId>
<artifactId>jta</artifactId>
<version>1.1</version>
</dependency>

2、配置数据源
    这一步是比较重要的。要用AtomikosDataSourceBean，而不是以前用的连接池如dbcp。最好也用XA(这东西我还不太懂)，注意jdbc的链接地址和登陆账号与普通连接池的配置的格式不一样。下面是一个mysql数据库的配置举例：
<bean id="dataSource1" class="com.atomikos.jdbc.AtomikosDataSourceBean" init-method="init" destroy-method="close">
<property name="uniqueResourceName" value="ds1"/>
<property name="xaDataSourceClassName" value="com.mysql.jdbc.jdbc2.optional.MysqlXADataSource"/>
<property name="xaProperties">
<props>
<prop key="url">jdbc:mysql://localhost/test</prop>
<prop key="user">test</prop>
<prop key="password">test</prop>
</props>
</property>
<property name="minPoolSize" value="10" />
<property name="maxPoolSize" value="100" />
<property name="borrowConnectionTimeout" value="30" />
<property name="testQuery" value="select 1" />
<property name="maintenanceInterval" value="60" />
</bean>
再来一个sybase的配置举例：
<bean id="dataSource2" class="com.atomikos.jdbc.AtomikosDataSourceBean" init-method="init" destroy-method="close">
<property name="uniqueResourceName" value="ds2"/>
<property name="xaDataSourceClassName" value="com.sybase.jdbc3.jdbc.SybXADataSource"/>
<property name="xaProperties">
<props>
<prop key="serverName">192.168.1.10</prop>
<prop key="portNumber">2638</prop>
<prop key="databaseName">test</prop>
<prop key="user">test</prop>
<prop key="password">test</prop>
</props>
</property>
<property name="minPoolSize" value="10" />
<property name="maxPoolSize" value="100" />
<property name="borrowConnectionTimeout" value="30" />
<property name="testQuery" value="select 1" />
<property name="maintenanceInterval" value="60" />
</bean>

3、使用数据源
    这一步与平时好像没什么不一样。我做例子的时候是用mybatis，配置如下：
<bean id="sqlSessionFactory1" class="org.mybatis.spring.SqlSessionFactoryBean">
<property name="dataSource" ref="dataSource1"/>
</bean>
<bean id="sqlSessionFactory2" class="org.mybatis.spring.SqlSessionFactoryBean">
<property name="dataSource" ref="dataSource2"/>
</bean>
当然，mybatis还要配置一下映射文件的自动扫描，这里与atomikos无关：
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
<property name="basePackage" value="xx.xx;" />
<property name="sqlSessionFactory" ref="sqlSessionFactory1"/>
</bean>
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
<property name="basePackage" value="yy.yy;" />
<property name="sqlSessionFactory" ref="sqlSessionFactory2"/>
</bean>
用spring JdbcTemplate应该与普通使用没什么不同，用hibernate可能会有点不一样，没测试过。
4、配置jta事务管理
    这是很关键的一步。原理我不太懂，例子如下：
<bean id="transactionManager" class="org.springframework.transaction.jta.JtaTransactionManager">
<property name="transactionManager">
<bean class="com.atomikos.icatch.jta.UserTransactionManager" init-method="init" destroy-method="close">
<property name="forceShutdown" value="true"/>
</bean>
</property>
<property name="userTransaction">
<bean class="com.atomikos.icatch.jta.UserTransactionImp"/>
</property>
</bean>
当然，用spring的声明式事务配置，再加上一行：
<tx:annotation-driven/>
（注意，本来要配置transaction-manager属性，如：<tx:annotation-driven transaction-manager="transactionManager"/>。这里没有配置是因为它的默认值是transactionManager）
5、atomikos的配置文件jta.properties
    这个文件一般放在根路径吧，与log4j.properties类似。jta.properties也可命名为transactions.properties。如果不配置这个文件，项目也能启动，因为几乎所有配置项都有默认值。最好还是配置了，详细配置信息请查看：http://www.atomikos.com/Documentation/JtaProperties。
6、不管是用JdbcTemplate、mybatis还是hibernate，应该都可以写代码来测试了。。。