【MyBatis框架】mybatis和spring整合

時間 2019-11-08

標籤 MyBatis框架 mybatis spring 整合欄目 MyBatis 简体版

原文原文鏈接

spring和mybatis整合

1.整合思路

須要spring經過單例方式管理SqlSessionFactory。
spring和mybatis整合生成代理對象，使用SqlSessionFactory建立SqlSession。（spring和mybatis整合自動完成）
持久層的mapper都須要由spring進行管理。

2.整合環境
建立一個新的java工程（接近實際開發的工程結構）

jar包：
mybatis3.2.7的jar包
spring3.2.0的jar包
mybatis和spring的整合包：早期ibatis和spring整合是由spring官方提供，mybatis和spring整合由mybatis提供。jar包名mybatis-spring-1.2.2.jar

下面加入MyBatis與Spring整合的所有jar包
java

如圖mysql

工程結構：
spring

如圖sql

3.sqlSessionFactory
在applicationContext.xml配置sqlSessionFactory和數據源
sqlSessionFactory在mybatis和spring的整合包下。數據庫

<?xml version="1.0" encoding="UTF-8"?>
<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" />


    <!-- 數據源，使用dbcp -->
    <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>




    <!-- sqlSessinFactory -->
    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
        <!-- 加載mybatis的配置文件 -->
        <property name="configLocation" value="mybatis/SqlMapConfig.xml" />
        <!-- 數據源 -->
        <property name="dataSource" ref="dataSource" />
    </bean>
</beans>

4.原始dao開發（和spring整合後）
4.1User.xmlapache

<?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">


<!-- namespace命名空間，做用就是對sql進行分類化管理，理解sql隔離
注意:使用mapper代理方法開發，namespace有特殊重要的做用 -->
<mapper namespace="test">
    <!-- 在映射文件中配置不少sql語句 -->
    
    <!-- 需求:經過id查詢用戶表的記錄 -->
    <!-- 經過select執行數據庫查詢，
         id:標示映射文件中的sql，成爲Statement的id 
         將sql語句封裝到mappedStatement對象中，因此將id稱爲statement的id,
         
         parameterType:指定輸入參數的類型，
         
         #{}標示一個佔位符,
         
         #{id}其中id表示接收輸入參數的名稱，若是輸入參數是簡單類型，那麼#{}中的值能夠任意(如value)。
         
         resultType：指定sql輸出結果的映射的java對象類型，
         select指定resultType表示將單條記錄映射成java對象-->    
    <select id="findUserById" parameterType="int" resultType="cn.edu.hpu.ssm.po.User">
      SELECT * FROM USER WHERE id=#{id}
    </select>
    
</mapper>

在SqlMapconfig.xml中加載User.xmlspring-mvc

<!-- 加載映射文件 -->
<mappers>
    <!-- 經過resource方法一次加載一個映射文件 -->
    <mapper resource="sqlmap/User.xml"/>
    
    <!-- 批量加載mapper-->
    <package name="cn.edu.hpu.ssm.mapper"/>
</mappers>

4.2dao(實現類繼承SqlSessionDaoSupport)session

dao接口實現類須要注入SqlSessoinFactory，經過spring進行注入。
這裏spring聲明配置方式，配置dao的bean：

讓UserDaoImpl實現類繼承SqlSessionDaoSupport

4.3配置dao
首先建立UserDao接口和UserDaoImpl接口實現
UserDao.java:mybatis

package cn.edu.hpu.ssm.dao;

import cn.edu.hpu.ssm.po.User;

//用戶管理的Dao接口
public interface UserDao{
    
    //根據Id查詢用戶信息
    public User findUserById(int id) throws Exception;
}

UserDaoImpl.java:mvc

package cn.edu.hpu.ssm.dao;

import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;

import cn.edu.hpu.ssm.po.User;

public class UserDaoImpl implements UserDao{


    //須要向dao實現類中注入SqlSessionFactory工廠
    //這裏咱們暫時沒用spring，咱們經過構造方法注入
    private SqlSessionFactory sqlSessionFactory;
    public UserDaoImpl(SqlSessionFactory sqlSessionFactory){
        this.sqlSessionFactory=sqlSessionFactory;
    }


    public User findUserById(int id) throws Exception {
        SqlSession sqlSession=sqlSessionFactory.openSession();
        
        User user=sqlSession.selectOne("test.findUserById",id);
        
        //釋放資源
        sqlSession.close();
        return user;
    }
}

在applicationContext.xml中配置dao。

<?xml version="1.0" encoding="UTF-8"?>
<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" />


    <!-- 數據源，使用dbcp -->
    <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>




    <!-- sqlSessinFactory -->
    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
        <!-- 加載mybatis的配置文件 -->
        <property name="configLocation" value="mybatis/SqlMapConfig.xml" />
        <!-- 數據源 -->
        <property name="dataSource" ref="dataSource" />
    </bean>
    
    <!-- 原始Dao接口 -->
    <bean id="userDao" class="cn.edu.hpu.ssm.dao.UserDaoImpl">
        <property name="sqlSessionFactory" ref="sqlSessionFactory"></property>
    </bean>
    
    
</beans>

讓UserDaoImpl去繼承SqlSessionDaoSupport類，在SqlSessionDaoSupport類中提供了set和getsqlSessionFactory的方法。

package cn.edu.hpu.ssm.dao;

import org.apache.ibatis.session.SqlSession;
import org.mybatis.spring.support.SqlSessionDaoSupport;


import cn.edu.hpu.ssm.po.User;


public class UserDaoImpl extends SqlSessionDaoSupport implements UserDao{


    public User findUserById(int id) throws Exception {
        //繼承SqlSessionDaoSupport類，經過this.getSqlSession()獲得sqlSession
        SqlSession sqlSession=this.getSqlSession();
        
        User user=sqlSession.selectOne("test.findUserById",id);
        
        return user;
    }
}

4.4測試程序

package cn.edu.hpu.ssm.test;

import org.junit.Before;
import org.junit.Test;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;


import cn.edu.hpu.ssm.dao.UserDao;
import cn.edu.hpu.ssm.po.User;


public class UserDaoImplTest {
    
    private ApplicationContext applicationContext;
    
    //註解Before是在執行本類全部測試方法以前先調用這個方法
    @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");
        
        //調用UserDao的方法
        User user=userDao.findUserById(1);
        //輸出用戶信息
        System.out.println(user.getId()+":"+user.getUsername());
    }
    
}

測試結果和輸出日誌:

DEBUG [main] - Creating a new SqlSession
DEBUG [main] - SqlSession [org.apache.ibatis.session.defaults.DefaultSqlSession@8dcd5d] was not registered for synchronization because synchronization is not active
DEBUG [main] - Fetching JDBC Connection from DataSource
DEBUG [main] - JDBC Connection [jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf-8, UserName=root@localhost, MySQL-AB JDBC Driver] will not be managed by Spring
DEBUG [main] - ==> Preparing: SELECT * FROM USER WHERE id=? 
DEBUG [main] - ==> Parameters: 1(Integer)
DEBUG [main] - <== Total: 1
DEBUG [main] - Closing non transactional SqlSession [org.apache.ibatis.session.defaults.DefaultSqlSession@8dcd5d]
DEBUG [main] - Returning JDBC Connection to DataSource
1:張明明

5.mapper代理開發
5.1mapper.xml和mapper.java
UserMapper.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="cn.edu.hpu.ssm.mapper.UserMapper">
    
    <select id="findUserById" parameterType="int" resultType="cn.edu.hpu.mybatis.po.User">
      SELECT * FROM USER WHERE id=#{id}
    </select>
    
</mapper>

UserMapper.java:

package cn.edu.hpu.ssm.mapper;

import cn.edu.hpu.ssm.po.User;

//用戶管理的Dao接口
public interface UserMapper {
    
    //根據Id查詢用戶信息
    public User findUserById(int id) throws Exception;
}

5.2經過MapperFactoryBean建立代理對象

<!-- mapper配置 
    MapperFactoryBean根據mapper接口生成mapper代理對象-->
    <bean id="userMapper" class="org.mybatis.spring.mapper.MapperFactoryBean">
        <!-- mapperInterface指定mapper接口 -->
        <property name="mapperInterface" value="cn.edu.hpu.ssm.mapper.UserMapper"/>
        <property name="sqlSessionFactory" ref="sqlSessionFactory"/>
    </bean>

此方法問題：
須要針對每一個mapper進行配置，麻煩。因此要經過MapperScannerConfigurer進行mapper掃描。

5.3經過MapperScannerConfigurer進行mapper掃描（建議使用）

<!-- mapper批量掃描，從mapper包中掃描出mapper接口，自動建立代理對象而且在spring容器中注入 
    遵循規範:將mapper.java和mapper.xml映射文件名稱保持一致，且在一個目錄中.
    自動掃描出來的mapper的bean的id爲mapper類名(首字母小寫)-->
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
    <!-- 指定掃描的包名
    若是掃描多個包，每一個包中間使用半角逗號分隔 -->
    <property name="basePackage" value="cn.edu.hpu.ssm.mapper"/>
    <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"></property>
</bean>

sqlMapperConfig.xml中的mapper掃描就能夠不要了

<!-- 加載映射文件 -->
<mappers>
    <!-- 經過resource方法一次加載一個映射文件 -->
    <mapper resource="sqlmap/User.xml"/>
    
    <!-- 批量加載mapper
        
    和spring整合後，使用mapper掃描器，這裏不須要配置了-->
    <!--<package name="cn.edu.hpu.ssm.mapper"/>-->
</mappers>

測試代碼

package cn.edu.hpu.ssm.test;

import org.junit.Before;
import org.junit.Test;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;


import cn.edu.hpu.ssm.mapper.UserMapper;
import cn.edu.hpu.ssm.po.User;


public class UserMapperTest {


private ApplicationContext applicationContext;
    
    //註解Before是在執行本類全部測試方法以前先調用這個方法
    @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.getId()+":"+user.getUsername());
        
    }


}

測試結果及輸出日誌

DEBUG [main] - Returning cached instance of singleton bean 'userMapper'
DEBUG [main] - Creating a new SqlSession
DEBUG [main] - SqlSession [org.apache.ibatis.session.defaults.DefaultSqlSession@13b5a3a] was not registered for synchronization because synchronization is not active
DEBUG [main] - Fetching JDBC Connection from DataSource
DEBUG [main] - JDBC Connection [jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf-8, UserName=root@localhost, MySQL-AB JDBC Driver] will not be managed by Spring
DEBUG [main] - ==>  Preparing: SELECT * FROM USER WHERE id=? 
DEBUG [main] - ==> Parameters: 1(Integer)
DEBUG [main] - <==      Total: 1
DEBUG [main] - Closing non transactional SqlSession [org.apache.ibatis.session.defaults.DefaultSqlSession@13b5a3a]
DEBUG [main] - Returning JDBC Connection to DataSource
1:張明明