深入浅出mybatis之与spring集成
写在前面
在Java世界，AOP编程是非常流行的模式，大大降低了功能业务与核心业务之间的代码耦合度。而说到AOP，Spring更是业界主流实现框架。 MyBatis作为ORM框架，既可以独立使用，当然也不可免俗地可以与Spring集成在一起使用。 特别是在已经使用Spring框架的应用程序中，如果需要使用MyBatis作为ORM组件时，就必然需要将二者集成在一起。 实际上，MyBatis与Spring集成，本质上就是将MyBatis中的相应组件交给Spring容器进行管理，使得我们可以按照Spring方式来使用MyBatis。
详细配置
既然MyBatis与Spring集成时是将其组件交给Spring进行管理，是如何实现的呢？
实际上，集成MyBatis与Spring需要使用通过mybatis-spring这个组件来实现。
<!-- mybatis集成spring -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis-spring</artifactId>
<version>${version.mybatis.spring}</version>
</dependency>具体是哪些组件要交给Spring托管呢？
1.dataSource（数据源）
数据源通常以连接池方式使用，如：C3P0，Druid等。 druid数据源配置示例（详见：https://github.com/alibaba/druid ） 如下：
<bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close">
<property name="url" value="${url}" />
<property name="username" value="${username}" />
<property name="password" value="${password}" />
<property name="filters" value="stat" />
<property name="maxActive" value="20" />
<property name="initialSize" value="1" />
<property name="maxWait" value="60000" />
<property name="minIdle" value="1" />
<property name="timeBetweenEvictionRunsMillis" value="60000" />
<property name="minEvictableIdleTimeMillis" value="300000" />
<property name="testWhileIdle" value="true" />
<property name="testOnBorrow" value="false" />
<property name="testOnReturn" value="false" />
<property name="poolPreparedStatements" value="true" />
<property name="maxOpenPreparedStatements" value="20" />
<property name="asyncInit" value="true" />
</bean>2.sqlSessionFactory（Session工厂）
在独立使用MyBatis时，sqlSessionFactory是通过SqlSessionFactoryBuilder构建的。
// 从xml配置中构建sessionFactory
String resource = "mybatis-config.xml";
InputStream is = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);而与Spring集成时，sqlSessionFactory直接交给Spring管理。 实际上就是在Spring中使用SqlSessionFactoryBean对MyBatis的sqlSessionFactory进行了包装。
<!-- 配置sqlSessionFactory -->
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
<property name="dataSource" ref="dataSource" />
</bean>3.Mapper（映射器）
MyBatis本身支持2种映射器（XML映射器和接口映射器），与Spring集成时2种映射器的注册方式不同。
（1）注册XML映射器 XML映射器在注册SqlSessionFactoryBean时通过属性mapperLocations指定。
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
<property name="dataSource" ref="dataSource" />
<!-- 注册xml映射器 -->
<property name="mapperLocations" value="classpath*:org/chench/test/mybatis/mapper/**/*.xml" />
</bean>
<bean id="sqlSession" class="org.mybatis.spring.SqlSessionTemplate">
<constructor-arg index="0" ref="sqlSessionFactory" />
</bean>另外，在注册xml映射器时，可以同时在Spring中声明一个sqlSession对象，用于执行xml映射器中配置的CRUD操作。 注意：
- 这里在Spring中注册sqlSession对象并不是MyBatis的sqlSession对象，而是SqlSessionTemplate。
- SqlSessionTemplate是MyBatis-Spring的核心，这个类负责管理MyBatis的SqlSession, 调用MyBatis映射器的SQL方法, 翻译异常等。
- SqlSessionTemplate是线程安全的, 可以被多个DAO所共享使用。
- 当调用SQL方法时, SqlSessionTemplate将会保证使用的SqlSession是和当前Spring的事务相关的。此外，它管理SqlSession的生命周期，包含必要的关闭，提交或回滚操作。使用示例如下：
// 使用spring提供的sqlSession
SqlSession sqlSession = (SqlSession) context.getBean("sqlSession");
Test test = sqlSession.selectOne("org.chench.test.mybatis.mapper.selectOneTest", 1);
logger.info("test: {}", test);
test.setName(new Date().getTime() + "_haha");
sqlSession.update("org.chench.test.mybatis.mapper.updateOneTest", test);
//注意: 使用spring管理的sqlSession时,不允许手动提交事务
//sqlSession.commit();（2）注册接口映射器
<bean id="testMapper" class="org.mybatis.spring.mapper.MapperFactoryBean">
<!-- 独立注册每一个映射器接口 -->
<property name="mapperInterface" value="org.chench.test.mybatis.mapper.impl.TestMapper" />
<property name="sqlSessionFactory" ref="sqlSessionFactory" />
</bean>实际上，在注册接口映射器时无需手动注册每一个映射器，使用MapperScannerConfigurer可以实现注册指定包路径下的所有映射器接口。
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
<property name="basePackage" value="org.chench.test.mybatis.mapper.impl" />
</bean>使用举例：
// 当使用接口映射器时,直接获取映射器接口Bean进行CRUD操作
TestMapper testMapper = context.getBean(TestMapper.class);
Test test = testMapper.selectOneTest(1);
logger.info("test: {}", test);
test.setName("heihei");
testMapper.updateOneTest(test);4.TransactionManager（事务管理器）
一个使用MyBatis-Spring的主要原因是它允许MyBatis参与到Spring的事务管理中。 而不是给MyBatis创建一个新的特定的事务管理器，MyBatis-Spring利用了存在于Spring中的 DataSourceTransactionManager。 一旦Spring的PlatformTransactionManager配置好了，你可以在Spring中以你通常的做法来配置事务，@Transactional注解和AOP样式的配置都是支持的。 在事务处理期间，一个单独的SqlSession对象将会被创建和使用。当事务完成时，这个session会以合适的方式提交或回滚。 一旦事务创建之后，MyBatis-Spring将会透明的管理事务。在你的DAO类中就不需要额外的代码了。
<bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
<property name="dataSource" ref="dataSource" />
</bean>
<!-- 开启注解方式控制事务 -->
<tx:annotation-driven transaction-manager="transactionManager" /> 注意： 对于事务管理器的使用，与MyBatis注册映射器方式不同而不同！ （1）如果MyBatis使用xml映射器，可以使用编程式地控制事务。
// 编程控制事务
DefaultTransactionDefinition def = new DefaultTransactionDefinition();
def.setPropagationBehavior(TransactionDefinition.PROPAGATION_REQUIRED);
PlatformTransactionManager txManager = (PlatformTransactionManager) context.getBean("transactionManager");
TransactionStatus status = txManager.getTransaction(def);
try {
sqlSession.update("org.chench.test.mybatis.mapper.updateOneTest", test);
txManager.commit(status);
} catch (Exception e) {
txManager.rollback(status);
e.printStackTrace();
}（2）如果MyBatis的映射器为接口，则可以使用注解方式管理事务（需要在Spring中配置开启注解方式控制事务）。
// 这是一个事务型操作，使用注解方式控制事务
@Transactional
@Update("update test set name=#{name},descr=#{descr},url=#{url},update_time=now() where id=#{id}")
public Integer updateOneTest(Test test);关于MyBatis与Spring集成的详细例子：https://gitee.com/cchanghui/test-mybatis.git
【参考】 [1]. http://www.mybatis.org/spring/ [2]. http://www.mybatis.org/spring/zh/sqlsession.html