Spring整合MyBatis的三種方式

1、整合之前的環境準備

導入相關的jar包

Junit測試

<dependency>
 <groupId>junit</groupId>
 <artifactId>junit</artifactId>
 <version>4.12</version>
 <scope>test</scope>
</dependency>

MyBatis

<dependency>
 <groupId>org.mybatis</groupId>
 <artifactId>mybatis</artifactId>
 <version>3.5.2</version>
</dependency>

MySQL數據庫

<dependency>
 <groupId>mysql</groupId>
 <artifactId>mysql-connector-java</artifactId>
 <version>5.1.47</version>
</dependency>

Spring相關

<dependency>
 <groupId>org.springframework</groupId>
 <artifactId>spring-webmvc</artifactId>
 <version>5.3.3</version>
</dependency>
<dependency>
 <groupId>org.springframework</groupId>
 <artifactId>spring-jdbc</artifactId>
 <version>5.3.3</version>
</dependency>

aspectJ AOP 織入器

<dependency>
 <groupId>org.aspectj</groupId>
 <artifactId>aspectjweaver</artifactId>
 <version>1.9.6</version>
</dependency>

mybatis-spring整合包 【重點】

<dependency>
 <groupId>org.mybatis</groupId>
 <artifactId>mybatis-spring</artifactId>
 <version>2.0.5</version>
</dependency>

配置Maven靜態資源過濾問題!

<build>
 <resources>
  <resource>
   <directory>src/main/java</directory>
   <includes>
    <include>**/*.properties</include>
    <include>**/*.xml</include>
   </includes>
   <filtering>true</filtering>
  </resource>
 </resources>
</build>

2、回憶MyBatis

編寫一個實體類User

public class User {
 private Integer id;
 private String name;
 private String pwd;
 // getter and setter
 // 有參和無參
 // toString
}

編寫MyBatis核心配置文件

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mybatis?useUnicode=true&characterEncoding=utf8&autoReconnect=true&failOverReadOnly=false
jdbc.username=root
jdbc.password=123456
<?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>
 <properties resource="jdbc.properties"/>
 <environments default="development">
  <environment id="development">
   <transactionManager type="JDBC"/>
   <dataSource type="POOLED">
    <property name="driver" value="${jdbc.driver}"/>
    <property name="url" value="${jdbc.url}"/>
    <property name="username" value="${jdbc.username}"/>
    <property name="password" value="${jdbc.password}"/>
   </dataSource>
  </environment>
 </environments>
</configuration>

編寫UserMapper接口

public interface UserMapper {
 List<User> userList();
}

編寫接口對應的Mapper.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="com.jh.mapper.UserMapper">
 <select id="userList" resultType="com.jh.domain.User">
  select * from mybatis.user
 </select>
</mapper>

註冊Mapper.xml文件

<mappers>
 <mapper resource="com/jh/mapper/UserMapper.xml"/>
</mappers>

編寫測試類

@Test
public void userList() throws IOException {
 String resource = "mybatis-config.xml";
 InputStream stream = Resources.getResourceAsStream(resource);
 SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(stream);
 
 SqlSession sqlSession = sqlSessionFactory.openSession(true);
 UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
 
 List<User> userList = userMapper.userList();
 userList.forEach(System.out::println);
 
 sqlSession.close();
}

輸出結果

User{id=1, name=’小王’, pwd=’123456′}

User{id=2, name=’張三’, pwd=’123456′}

User{id=3, name=’李四’, pwd=’123456′}

3、MyBatis-Spring學習

引入Spring之前需要瞭解mybatis-spring包中的一些重要類;

MyBatis-Spring中文官網:https://mybatis.org/spring/zh/index.html

什麼是 MyBatis-Spring?

MyBatis-Spring 會幫助你將 MyBatis 代碼無縫地整合到 Spring 中。

知識基礎

在開始使用 MyBatis-Spring 之前,你需要先熟悉 Spring 和 MyBatis 這兩個框架和有關它們的術語。這很重要

MyBatis-Spring 需要以下版本:

MyBatis-Spring MyBatis Spring Framework Spring Batch Java
2.0 3.5+ 5.0+ 4.0+ Java 8+
1.3 3.4+ 3.2.2+ 2.1+ Java 6+

使用 Maven 作為構建工具,僅需要在 pom.xml 中加入以下代碼即可:

<dependency>
 <groupId>org.mybatis</groupId>
 <artifactId>mybatis-spring</artifactId>
 <version>2.0.6</version>
</dependency>

和 Spring 一起使用 MyBatis,需要在 Spring 應用上下文中定義至少兩樣東西:一個 SqlSessionFactory 和至少一個數據映射器類。

在 MyBatis-Spring 中,可使用 SqlSessionFactoryBean來創建 SqlSessionFactory。 要配置這個工廠 bean,隻需要把下面代碼放在 Spring 的 XML 配置文件中:

<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
 <property name="dataSource" ref="dataSource" />
</bean>

註意:SqlSessionFactory 需要一個 DataSource(數據源)。這可以是任意的 DataSource,隻需要和配置其它 Spring 數據庫連接一樣配置它就可以瞭。常用第三方數據源:dbcp,c3p,druid

在基礎的 MyBatis 用法中,是通過 SqlSessionFactoryBuilder 來創建 SqlSessionFactory 的。而在 MyBatis-Spring 中,則使用 SqlSessionFactoryBean 來創建。

在 MyBatis 中,你可以使用 SqlSessionFactory 來創建 SqlSession。一旦你獲得一個 session 之後,你可以使用它來執行映射瞭的語句,提交或回滾連接,最後,當不再需要它的時候,你可以關閉 session。

SqlSessionFactory有一個唯一的必要屬性:用於 JDBC 的 DataSource。這可以是任意的 DataSource 對象,它的配置方法和其它 Spring 數據庫連接是一樣的。

一個常用的屬性是 configLocation,它用來指定 MyBatis 的 XML 配置文件路徑。它在需要修改 MyBatis 的基礎配置非常有用。通常,基礎配置指的是 < settings> 或 < typeAliases>元素。

需要註意的是,這個配置文件並不需要是一個完整的 MyBatis 配置。確切地說,任何環境配置(),數據源()和 MyBatis 的事務管理器()都會被忽略。SqlSessionFactoryBean 會創建它自有的 MyBatis 環境配置(Environment),並按要求設置自定義環境的值。

SqlSessionTemplate 是 MyBatis-Spring 的核心。作為 SqlSession 的一個實現,這意味著可以使用它無縫代替你代碼中已經在使用的 SqlSession

模板可以參與到 Spring 的事務管理中,並且由於其是線程安全的,可以供多個映射器類使用,你應該總是用 SqlSessionTemplate 來替換 MyBatis 默認的 DefaultSqlSession 實現。在同一應用程序中的不同類之間混雜使用可能會引起數據一致性的問題。

可以使用 SqlSessionFactory 作為構造方法的參數來創建 SqlSessionTemplate 對象。

<bean id="sqlSessionTemplate" class="org.mybatis.spring.SqlSessionTemplate">
 <!-- 隻能使用構造器註入sqLSessionFactory,因為它沒有set方法- -->
 <constructor-arg name="sqlSessionFactory" ref="sqlSessionFactory"/>
</bean>

現在,這個 bean 就可以直接註入到你的 DAO bean 中瞭。你需要在你的 bean 中添加一個SqlSessionTemplate 屬性,就像下面這樣:

public class UserMapperImpl implements UserMapper {
 private SqlSessionTemplate sessionTemplate;

 public void setSessionTemplate(SqlSessionTemplate sessionTemplate) {
  this.sessionTemplate = sessionTemplate;
 }

 @Override
 public List<User> userList() {
  UserMapper mapper = sessionTemplate.getMapper(UserMapper.class);
  return mapper.userList();
 }
}

按下面這樣,註入 SqlSessionTemplate:

<bean id="userMapper" class="com.jh.mapper.UserMapperImpl">
 <property name="sessionTemplate" ref="sqlSessionTemplate"/>
</bean>

4、實現整合方式一

編寫Spring配置文件applicationContext.xml

<?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:context="http://www.springframework.org/schema/context"
  xsi:schemaLocation="http://www.springframework.org/schema/beans 
  http://www.springframework.org/schema/beans/spring-beans.xsd 
  http://www.springframework.org/schema/context 
  https://www.springframework.org/schema/context/spring-context.xsd">
</beans>

配置數據源替換mybaits的數據源

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://127.0.0.1:3306/mybatis?useUnicode=true&characterEncoding=utf8&autoReconnect=true&failOverReadOnly=false
jdbc.username=root
jdbc.password=123456
<!-- 導入數據庫連接信息 -->
<context:property-placeholder location="classpath*:jdbc.properties"/>
<!-- 數據源:DataSource;使用Spring的數據源替換Mybatis的配置 c3p,dbcp druid spring-->
<bean id="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource">
 <property name="driverClassName" value="${jdbc.driver}"/>
 <property name="url" value="${jdbc.url}"/>
 <property name="username" value="${jdbc.username}"/>
 <property name="password" value="${jdbc.password}"/>
</bean>

配置SqlSessionFactory,關聯MyBatis

<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
 <property name="dataSource" ref="dataSource"/>
 <!-- 綁定MyBatis配置文件 -->
 <property name="configLocation" value="classpath:mybatis-config.xml"/>
 <!-- 註冊Mapper文件 -->
 <property name="mapperLocations" value="classpath*:com/jh/mapper/*.xml"/>
</bean>

註冊sqlSessionTemplate,關聯sqlSessionFactory;

<!-- SqlSessionTemplate:就是我們使用的sqlSession -->
<bean id="sqlSessionTemplate" class="org.mybatis.spring.SqlSessionTemplate">
 <!-- 隻能使用構造器註入sqLSessionFactory,因為它沒有set方法- -->
 <constructor-arg name="sqlSessionFactory" ref="sqlSessionFactory"/>
</bean>

增加Dao接口的實現類;私有化sqlSessionTemplate

public class UserMapperImpl implements UserMapper {
 private SqlSessionTemplate sessionTemplate;

 public void setSessionTemplate(SqlSessionTemplate sessionTemplate) {
  this.sessionTemplate = sessionTemplate;
 }

 @Override
 public List<User> userList() {
  UserMapper mapper = sessionTemplate.getMapper(UserMapper.class);
  return mapper.userList();
 }
}

註冊bean實現;

<!-- 註冊UserMapperImpl到Spring -->
<bean id="userMapper" class="com.jh.mapper.UserMapperImpl">
 <property name="sessionTemplate" ref="sqlSessionTemplate"/>
</bean>

測試;

@Test
public void userList() throws IOException {
 ApplicationContext context = new ClassPathXmlApplicationContext("applicationContext.xml");
 UserMapper userMapper = context.getBean("userMapper", UserMapper.class);
 List<User> userList = userMapper.userList();
 userList.forEach(System.out::println);
}

結果成功輸出!現在我們的Mybatis配置文件的狀態!發現都可以被Spring整合!

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

</configuration>

4、實現整合方式二

mybatis-spring1.2.3版以上的才有這個。

官方文檔截圖:

dao繼承Support類,直接利用 getSqlSession() 獲得,然後直接註入SqlSessionFactory。比起方式1,不需要管理SqlSessionTemplate,而且對事務的支持更加友好。可跟蹤源碼查看

具體實現:

修改上面寫的UserMapperImpl

public class UserMapperImpl extends SqlSessionDaoSupport implements UserMapper {
 @Override
 public List<User> userList() {
  return super.getSqlSession().getMapper(UserMapper.class).userList();
 }
}

修改applicationContext.xml的配置

<bean id="userMapper" class="com.jh.mapper.UserMapperImpl">
 <property name="sqlSessionFactory" ref="sqlSessionFactory"/>
</bean>

測試

@Test
public void userList() throws IOException {
 ApplicationContext context = new ClassPathXmlApplicationContext("applicationContext.xml");
 UserMapper userMapper = context.getBean("userMapper", UserMapper.class);
 List<User> userList = userMapper.userList();
 userList.forEach(System.out::println);
}

5、實現整合方式三

為瞭代替手工使用SqlSessionDaoSupport或SqlSessionTemplate編寫數據訪問對象(DAO)的代碼,使用動態代理實現,MapperFactoryBean出現瞭。

這個類 可以讓你直接註入數據映射器接口到你的 service 層 bean 中。當使用映射器時,你僅僅如調用你的DAO一樣調用它們就可以瞭,但是你不需要編寫任何 DAO 實現的代碼,因為 MyBatis-Spring 將會為你創建代理。

先查看官網的配置:

<bean id="userMapper" class="org.mybatis.spring.mapper.MapperFactoryBean">
 <property name="mapperInterface" value="org.mybatis.spring.sample.mapper.UserMapper" />
 <property name="sqlSessionFactory" ref="sqlSessionFactory" />
</bean>

org.mybatis.spring.sample.mapper.UserMapper是一個接口,我們創建一個MapperFactoryBean實例,然後註入這個接口和sqlSessionFactory(mybatis中提供的SqlSessionFactory接口,MapperFactoryBean會使用SqlSessionFactory創建SqlSession)這兩個屬性。

之後想使用這個UserMapper接口的話,直接通過spring註入這個bean,然後就可以直接使用瞭,spring內部會創建一個這個接口的動態代理。

當發現要使用多個MapperFactoryBean的時候,一個一個定義肯定非常麻煩,於是mybatis-spring提供瞭MapperScannerConfigurer這個類,它將會查找類路徑下的映射器並自動將它們創建成MapperFactoryBean

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

這段配置會掃描org.mybatis.spring.sample.mapper下的所有接口,然後創建各自接口的動態代理類。

具體代碼實現:

編寫Mapper接口

public interface UserMapper {
 List<User> userList();
}

編寫Service方法和對應實現類

public interface UserService {
 List<User> userList();
}
public class UserServiceImpl implements UserService {
 private UserMapper userMapper;

 public void setUserMapper(UserMapper userMapper) {
  this.userMapper = userMapper;
 }

 @Override
 public List<User> userList() {
  return null;
 }
}

編寫spring配置文件

<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
 <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/>
 <!-- 指定掃描的包,即mapper包 -->
 <property name="basePackage" value="com.jh.mapper"/>
</bean>

<!-- 註冊UserServiceImpl到Spring -->
<bean id="userService" class="com.jh.service.impl.UserServiceImpl">
 <!-- userMapper由MapperScannerConfigurer自動創建,並註入到UserServiceImpl -->
 <property name="userMapper" ref="userMapper"/>
</bean>

測試

@Test
public void userList() throws IOException {
 ApplicationContext context = new ClassPathXmlApplicationContext("applicationContext.xml");
 UserService userService = context.getBean("userService", UserService.class);
 List<User> userList = userService.userList();
 userList.forEach(System.out::println);
}

【總結】 :整合到spring以後可以完全不要mybatis的配置文件,除瞭這些方式可以實現整合之外,我們還可以使用註解來實現,這個等我們後面學習SpringBoot的時候還會測試整合!

到此這篇關於Spring整合MyBatis的三種方式的文章就介紹到這瞭,更多相關Spring整合MyBatis內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet!

推薦閱讀: