java-mybaits-00701-与spring整合

1.1     整合思路

 

需要spring通过单例方式管理SqlSessionFactory。

spring和mybatis整合生成代理对象，使用SqlSessionFactory创建SqlSession。（spring和mybatis整合自动完成）

持久层的mapper都需要由spring进行管理。

 

1.2     整合环境

创建一个新的java工程（接近实际开发的工程结构）

 

jar包：

 

mybatis3.2.7的jar包

spring3.2.0的jar包

mybatis和spring的整合包：早期ibatis和spring整合是由spring官方提供，mybatis和spring整合由mybatis提供。

 

.3     Mybatis配置文件

在classpath下创建mybatis/SqlMapConfig.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>

<!—使用自动扫描器时，mapper.xml文件如果和mapper.java接口在一个目录则此处不用定义mappers -->
<mappers>
<package name="cn.itcast.mybatis.mapper" />
</mappers>
</configuration> 

1.4 Spring配置文件

在classpath下创建applicationContext.xml，定义数据库链接池、SqlSessionFactory。

<beans xmlns="http://www.springframework.org/schema/beans"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:mvc="http://www.springframework.org/schema/mvc"
   xmlns:context="http://www.springframework.org/schema/context"
   xmlns:aop="http://www.springframework.org/schema/aop" xmlns:tx="http://www.springframework.org/schema/tx"
   xsi:schemaLocation="http://www.springframework.org/schema/beans
      http://www.springframework.org/schema/beans/spring-beans-3.2.xsd
      http://www.springframework.org/schema/mvc
      http://www.springframework.org/schema/mvc/spring-mvc-3.2.xsd
      http://www.springframework.org/schema/context
      http://www.springframework.org/schema/context/spring-context-3.2.xsd
      http://www.springframework.org/schema/aop
      http://www.springframework.org/schema/aop/spring-aop-3.2.xsd
      http://www.springframework.org/schema/tx
      http://www.springframework.org/schema/tx/spring-tx-3.2.xsd ">
<!-- 加载配置文件 -->
<context:property-placeholder location="classpath:db.properties"/>
<!-- 数据库连接池 -->
<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close">
       <property name="driverClassName" value="${jdbc.driver}"/>
      <property name="url" value="${jdbc.url}"/>
      <property name="username" value="${jdbc.username}"/>
      <property name="password" value="${jdbc.password}"/>
      <property name="maxActive" value="10"/>
      <property name="maxIdle" value="5"/>
</bean>
<!-- mapper配置 -->
   <!-- 让spring管理sqlsessionfactory 使用mybatis和spring整合包中的 -->
   <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
      <!-- 数据库连接池 -->
      <property name="dataSource" ref="dataSource" />
      <!-- 加载mybatis的全局配置文件 -->
      <property name="configLocation" value="classpath:mybatis/SqlMapConfig.xml" />
   </bean>
</beans>

注意：在定义sqlSessionFactory时指定数据源dataSource和mybatis的配置文件。

 

 

1.4     原始dao开发（和spring整合后）

 

1.4.1     User.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="test">
    <select id="findUserById" parameterType="int" resultType="com.ds365.ssm.po.User">
        select
        * from User where
        id=#{id}
    </select>
</mapper>

在SqlMapconfig.xml中加载User.xml

    <mappers>
        <mapper resource="sqlMap/User.xml" />
    </mappers>

1.4.2     dao(实现类继承SqlSessionDaoSupport)

public interface UserDao {
    // 获取用户
    public User findUserById(int id) throws Exception;
}

dao接口实现类需要注入SqlSessoinFactory，通过spring进行注入。

这里spring声明配置方式【当然也可以自动注入】，配置dao的bean：

 

让UserDaoImpl实现类继承SqlSessionDaoSupport

public class UserDaoImpl extends SqlSessionDaoSupport implements UserDao {
    @Override
    public User findUserById(int id) throws Exception {
        SqlSession sqlSession = this.getSqlSession();
        User user = sqlSession.selectOne("test.findUserById", 1);
        return user;
    }
}

  开启sqlsession，关闭sqlsession 由spring代替操作

1.4.3     配置dao

在applicationContext.xml中配置dao。

    <!-- 原始dao接口 -->
    <bean id="userDao" class="com.ds365.ssm.dao.UserDaoImpl">
        <property name="sqlSessionFactory" ref="sqlSessionFactory"></property>
    </bean>

1.4.4     测试程序

    private ApplicationContext applicationContext;
    // 在setup中得到spring容器
    @Before
    public void setUp() throws Exception {
        applicationContext = new ClassPathXmlApplicationContext("classpath:spring/applicationContext.xml");
    }

    @Test
    public void testFindUserById() throws Exception {
        UserDao userDao = (UserDao) applicationContext.getBean("userDao");
        User user = userDao.findUserById(1);
        System.out.println(user);
    }

1.5     mapper代理开发

 

1.5.1     mapper.xml和mapper.java

在同一包下

 public interface UserMapper {
    // 获取用户
    public User findUserById(int id) throws Exception;
}

<mapper namespace="com.ds365.ssm.mapper.UserMapper">
    <select id="findUserById" parameterType="int" resultType="com.ds365.ssm.po.User">
        select * from User where id=#{id}
    </select>
</mapper>

1.5.2     通过MapperFactoryBean创建代理对象

    <!-- mapper配置 -->
    <!-- MapperFactoryBean:根据mapper接口生成代理对象 -->
    <bean id="userMapper" class="org.mybatis.spring.mapper.MapperFactoryBean">
        <property name="mapperInterface" value="com.ds365.ssm.mapper.UserMapper"></property>
        <property name="sqlSessionFactory" ref="sqlSessionFactory"></property>
    </bean>

此方法问题：

需要针对每个mapper进行配置，麻烦。

 

1.5.3     使用mapper扫描器

通过MapperScannerConfigurer进行mapper扫描（建议使用）

    <!-- mapper 批量扫描，从mapper包中扫描出mapper接口， 自动创建代理对象并且在spring容器中注册 -->
    <!-- 遵循规范：mapper.xml和mapper.java 同名并在同一目录下 -->
    <!-- 这时自动扫描出的id与类名一致（首字母小写） -->
    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <!-- 扫描指定的包，如果扫描多个包，半角逗号分隔 -->
        <property name="basePackage" value="com.ds365.ssm.mapper"></property>
        <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"></property>
        <!-- 不能如下使用 -->
        <!-- 因为自动扫描会先执行 context:property-placeholder 会后执行 导致ref引用不到包 -->
        <!-- <property name="sqlSessionFactory" ref="sqlSessionFactory"></property> -->
    </bean>

这时可以去掉sqlmapconfig。xml中的mappers配置的扫描【扫描接口与xml对应的文件】

使用扫描器后从spring容器中获取mapper的实现对象

          如果将mapper.xml和mapper接口的名称保持一致且放在一个目录 则不用在sqlMapConfig.xml中进行配置

1.5.4     测试代码

    private ApplicationContext applicationContext;

    // 在setup中得到spring容器
    @Before
    public void setUp() throws Exception {
        applicationContext = new ClassPathXmlApplicationContext("classpath:spring/applicationContext.xml");
    }

    @Test
    public void testFindUserById() throws Exception {
        UserMapper userMapper = (UserMapper) applicationContext.getBean("userMapper");
        User user = userMapper.findUserById(1);
        System.out.println(user);
    }

常见错误

 org.springframework.beans.factory.BeanDefinitionStoreException: Failed to read candidate component class: file [D:\WORK\CODE\Javaworkspace16\mybatis\spring_mybatis02\bin\com\ds365\ssm\mapper\UserMapper.class]; nested exception is java.lang.IllegalArgumentException

 

此错误是spring3与java8造成 更换成最新的spring 4 即可