SqlSessionTemplate MapperScannerConfigurer「建议收藏」

1. MyBatis简介

     MyBatis是什么? MyBatis是一款一流的支持自定义SQL、存储过程和高级映射的持久化框架。MyBatis几乎消除了所有的JDBC代码，也基本不需要手工去设置参数和获取检索结果。MyBatis能够使用简单的XML格式或者注解进行来配置，能够映射基本数据元素、Map接口和POJOs（普通java对象）到数据库中的记录。

• SqlSessionFactoryBuilder：build方法创建SqlSessionFactory实例。

• SqlSessionFactory：创建SqlSession实例的工厂。

• SqlSession：用于执行持久化操作的对象，类似于jdbc中的Connection。

     所有的MyBatis应用都以SqlSessionFactory实例为中心。SqlSessionFactory实例通过SqlSessionFactoryBuilder来获得，SqlSessionFactoryBuilder能够从XML配置文件或者通过自定义编写的配置类（Configurationclass），来创建一个SqlSessionFactory实例。然后通过SqlSessionFactory实例来创建一个SqlSession实例。SqlSession包含了所有执行数据库SQL语句的方法。您能够直接地通过SqlSession实例执行映射SQL语句

  SqlSessionFactoryBuilder这个类可以在任何时候被实例化、使用和销毁。一旦您创造了SqlSessionFactory就不需要再保留它了。所以SqlSessionFactoryBuilder实例的最好的作用域是方法体内（即一个本地方法变量）

  SqlSessionFactory一旦创建，SqlSessionFactory将会存在于您的应用程序整个运行生命周期中。很少或根本没有理由去销毁它或重新创建它。最佳实践是不要在一个应用中多次创建SqlSessionFactory。这样做会被视为“没品味”。所是SqlSessionFactory最好的作用域范围是一个应用的生命周期范围。这可以由多种方式来实现，最简单的方式是使用Singleton模式或静态Singleton模式。但这不是被广泛接受的最佳做法，相反，您可能更愿意使用像GoogleGuice或Spring的依赖注入方式。这些框架允许您创造一个管理器，用于管理SqlSessionFactory的生命周期

  每个线程都有自己的SqlSession实例，SqlSession实例是不能被共享，也是不是线程安全的。因此最好使用Request作用域或者方法体作用域。不要使用类的静态变量来引用一个SqlSession实例，甚至不要使用类的一个实例变更来引用。永远不要在一个被管理域中引用SqlSession，比如说在Servlet中的HttpSession中。如果你正在使用WEB框架，应该让SqlSession跟随HTTP请求的相似作用域。也就是说，在收到一个HTTP请求过后，打开SqlSession，等返回一个回应以后，立马关掉这个SqlSession。关闭SqlSession是非常重要的。你必须要确保SqlSession在finally方法体中正常关闭

   Mapper是一种创建用于绑定映射语句的接口。Mapper接口的实例是用SqlSession来获得的，所以Mapper 实例作用域像SqlSession 一样，使用请求作用域。在方法被调用的时候调用Mapper实例，然后使用后，就会自动销毁掉，而不需要使用明确的注销

2.MyBatis-Spring

     <bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close">  
                 <property name="driverClassName" value="oracle.jdbc.driver.OracleDriver" />    
                <property name="url" value="jdbc:oracle:****:*****:1521:****" />    
                <property name="username" value="****" />    
                <property name="password" value="****" />    
      </bean>  

  <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
        <property name="configLocation">
            <value>classpath:mybatis/mapper.xml</value>
        </property>
        <property name="dataSource" ref="dataSource" />
    </bean>
    <bean id="sqlSession" class="org.mybatis.spring.SqlSessionTemplate">
        <constructor-arg index="0" ref="sqlSessionFactory" />
    </bean>

    <!-- 注解Mapper scanner -->
    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <property name="basePackage" value="com.**.ext" />
        <property name="sqlSessionTemplateBeanName" value="sqlSession" />
    </bean>

   1）SqlSessionFactoryBean 

    在基本的 MyBatis 中,session 工厂可以使用 SqlSessionFactoryBuilder 来创建。而在 MyBatis-Spring 中,则使用 SqlSessionFactoryBean 来替代

   为了得到factory bean，如上面所示，需在Spring
applicationContext.xml 配置文件中配置:

    

  <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
        <property name="configLocation">
            <value>classpath:mybatis/mapper.xml</value>
        </property>
        <property name="dataSource" ref="dataSource" />
    </bean>

   SqlSessionFactoryBean 实现了 Spring 的 FactoryBean 接口，就说明了由 Spring 最终创建的 bean 不是 SqlSessionFactoryBean 本身, 。 而是工厂类的 getObject()返回的方法的结果。这种情况下,Spring 将会在应用启动时为你 创建 SqlSessionFactory 对象,然后将它以 SqlSessionFactory 为名来存储，这相当于下面的代码：

SqlSessionFactoryBean factoryBean = new SqlSessionFactoryBean();
SqlSessionFactory sessionFactory = factoryBean.getObject();

     1. SqlSessionFactoryBean 属性

        1）SqlSessionFactory 有一个单独的必须属性,就是 JDBC 的 DataSource。这可以是任意 的 DataSource,其配置应该和其它 Spring 数据库连接是一样的。

       2） 一个通用的属性是 configLocation,它是用来指定 MyBatis 的 XML 配置文件路径的。 如果基本的 MyBatis 配置需要改变, 那么这就是一个需要它的地方。 通常这会是
<settings>  或
<typeAliases> 的部分。

要注意这个配置文件不需要是一个完整的 MyBatis 配置。确切地说,任意环境,数据源 和 MyBatis 的事务管理器都会被忽略。SqlSessionFactoryBean 会创建它自己的,使用这些 值定制 MyBatis 的 Environment 时是需要的。

    如果 MyBatis 映射器 XML 文件在和映射器类相同的路径下不存在,那么另外一个需要 配置文件的原因就是它了。使用这个配置,有两种选择。第一是手动在 MyBatis 的 XML 配 置文件中使用<mappers>部分来指定类路径。第二是使用工厂 bean 的 mapperLocations 属 性。

    3）mapperLocations 属性使用一个资源位置的 list。 这个属性可以用来指定 MyBatis 的 XML 映射器文件的位置。 它的值可以包含 Ant 样式来加载一个目录中所有文件, 或者从基路径下 递归搜索所有路径。比如:

<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
  <property name="dataSource" ref="dataSource" />
  <property name="mapperLocations" value="classpath*:sample/config/mappers/**/*.xml" />
</bean>

这会从类路径下加载在 sample.config.mappers 包和它的子包中所有的 MyBatis 映射器 XML 文件。

2）SqlSessionTemplate

MyBatis提供的持久层访问模板化的工具，线程安全，可通过构造参数或依赖注入SqlSessionFactory实例

    SqlSessionTemplate是MyBatis-spring的核心。这个类负责管理MyBatis的SqlSession,调用MyBatis的SQL方法，翻译异常。SqlSessionTemplate是线程安全的，可以被多个DAO所共享使用。当调用SQL方法时，包含从映射器getMapper()方法返回的方法，SqlSessionTemplate将会保证使用的SqlSession是和当前Spring的事务相关的。此外，它管理session的生命周期，包含必要的关闭，提交或回滚操作。

    SqlSessionTemplate实现了SqlSession，这就是说要对MyBatis的SqlSession进行简易替换。

    SqlSessionTemplate通常是被用来替代默认的MyBatis实现的DefaultSqlSession，因为它不能参与到Spring的事务中也不能被注入，因为它是线程不安全的。相同应用程序中两个类之间的转换可能会引起数据一致性的问题。

<span style="font-size:14px;"><!--创建jdbc数据源 -->  
      <bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close">  
                <property name="driverClassName" value="oracle.jdbc.driver.OracleDriver" />    
                <property name="url" value="jdbc:oracle:****:*****:1521:****" />    
                <property name="username" value="****" />    
                <property name="password" value="****" />    
      </bean>  

      <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">  
         <property name="dataSource" ref="dataSource" />  
         <property name="configLocation" value="classpath:com/Template/configuration.xml" />  
      </bean>  

    <strong>  <bean id="sqlSession"     class="org.mybatis.spring.SqlSessionTemplate">   
          <constructor-arg index="0" ref="sqlSessionFactory" />   
      </bean>  

      <bean id="customerTest" class="com.Template.Test">  
          <property name="sqlSession" ref="sqlSession" />  
      </bean></span>  </strong>

这是测试类，由于这是SqlSessionTemplate，所以不需要继承

<span style="font-size:14px;">import javax.annotation.Resource;  

import org.mybatis.spring.SqlSessionTemplate;  
import org.springframework.beans.factory.BeanFactory;  
import org.springframework.context.support.ClassPathXmlApplicationContext;  
public class Test{  
    @Resource  
    <strong>public SqlSessionTemplate sqlSession;  </strong>

    public static void main(String[] args) {  
        // TODO Auto-generated method stub  
        new Test().firstTest();  
    }  

    public void setSqlSession(SqlSessionTemplate sqlSession) {  
        this.sqlSession = sqlSession;  
   }  

    public void firstTest() {  
        BeanFactory factory = new ClassPathXmlApplicationContext("com/Template/applicationContext.xml");  
       <strong> Test test = (Test)factory.getBean("customerTest");  
        Customer cus = (Customer)test.sqlSession.selectOne("selectCustomer",10696);  </strong>
        System.out.println(cus);  
    }  
}</span>  

3)MapperScannerConfigurer

  没有必要在Spring的XML配置文件中注册所有的映射器。相反，你可以使用一个 MapperScannerConfigurer ,它将会查找类路径下的映射器并自动将它们创建成 MapperFactoryBeans 。要创建MapperScannerConfigurer，可以在Spring的配置中添加如下代码

<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">  
    <propery name="basePackage" value="org.mybatis.spring.sample.mapper"/>  
</bean>  

basePackage属性是让你为映射器接口文件设置基本的包路径。你可以使用分号或逗号作为分隔符设置多于一个的包路径。每个映射器将会在指定的包路径中递归地被搜索到。

注意，没有必要去指定SqlSessionFactory或SqlSessionTemplate，因为MapperScannerConfigurer将会创建MapperFactoryBean，之后自动装配。但是，如果你使用了一个以上的DataSource(因此，也是多个的SqlSessionFactory),那么自动装配可能会失效。这种情况下，你可以使用sqlSessionFactory或sqlSessionTemplate属性来设置正确的工厂/模板。

 

   <bean id="sqlSession" class="org.mybatis.spring.SqlSessionTemplate">
        <constructor-arg index="0" ref="sqlSessionFactory" />
    </bean>

    <!-- 注解Mapper scanner -->
    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <property name="basePackage" value="com.**.ext" />
      <strong>  <property name="sqlSessionTemplateBeanName" value="sqlSession" /></strong>
    </bean>