前言

最近開始了SpringBoot相關知識的學習，作為為目前比較流行、用的比較廣的Spring框架，是每一個Java學習者及從業者都會接觸到一個知識點，作為Spring框架專案，肯定少不了與資料庫持久層的整合，我們在學習Java初始就被灌輸SSM框架(Spring、SpringMVC、Mybatis)，我們大概也只是知道Mybatis是與資料庫打交道的，但這也只是名詞上的理解，

Mybatis具體是什么？

MyBatis 是一款優秀的持久層框架，它支持自定義 SQL、存盤程序以及高級映射，MyBatis 免除了幾乎所有的 JDBC 代碼以及設定引數和獲取結果集的作業，MyBatis 可以通過簡單的 XML 或注解來配置和映射原始型別、介面和 Java POJO（Plain Old Java Objects，普通老式 Java 物件）為資料庫中的記錄，

，，，，，，

這里我就不廢話介紹了，詳細的看官方檔案地址：https://mybatis.org/mybatis-3/zh/index.html

到后來開始完整的學習Mybatis、到Spring、SpringMVC、再到SpringBoot都有它的身影，它的使用及配置越來越簡單方便，可能出現這種情況，學到SpringBoot整合Mybatis發現，為什么要這么操作？為什么要寫這個注解？為什么要添加掃描包配置？那么這篇文章就是將開始學習Mybatis到現在SpringBoot整合Mybatis的知識串起來，加深印象增加理解，

下面是我往期關于Mybatis知識點的博客，有興趣的可以看一下，

Mybatis開啟二級快取(全域快取)的方法
Spring學習之Spring與Mybatis的兩種整合方式
SpringBoot學習之整合Mybatis

首先我也是作為Java的一名初學者，下面文章也是按照從JDBC、Mybatis、Spring、SpringMVC、再到SpringBoot的思路撰寫，也是我自己的學習路線中Mybatis由繁到簡的程序，大致分為五個階段，可能后面幾個階段內容可以合并為一個階段，我為了體現Mybatis使用的方便簡化，從而作為一個階段，也可以幫助那些直接學習SpringBoot的同學理解整合Mybatis的遞程序序，如果其中有錯誤之處，也煩請各位大佬給予指正！感謝！

階段一：JDBC

我們在學習Mybatis之前，我們使用JDBC即資料庫連接驅動進行資料庫連接操作，

其大致操作步驟：

加載驅動 com.mysql.cj.jdbc.Driver
設定資料庫用戶名、密碼及URL
使用 DriverManager.getConnection(url, userName, passWord) 創建資料庫物件
創建執行Sql物件 connection.createStatement()
通過statement物件執行具體的Sql statement.executeQuery(sql)
最后關閉釋放連接

public static void main(String[] args) throws ClassNotFoundException, SQLException {
    // 1.加載驅動(固定寫法)
    Class.forName("com.mysql.cj.jdbc.Driver");// 注意加載新的驅動，舊的棄用了
    // 2.用戶資訊和url
    String url = "jdbc:mysql://localhost:3306/school?serverTimezone=UTC&useUnicode=true&characterEncoding=utf-8&useSSl=true";// 注意添加時區引數
    String userName = "root";
    String passWord = "970628";
    // 3.連接成功，資料庫物件
    Connection connection = DriverManager.getConnection(url, userName, passWord);
    // 4.執行sql的物件
    Statement statement = connection.createStatement();
    // 5.執行sql
    String sql= "SELECT * FROM student";
    ResultSet resultSet = statement.executeQuery(sql);
    while (resultSet.next()){
        System.out.println("name="+resultSet.getObject("name"));
    }
    // 6.釋放鏈接
    resultSet.close();
    statement.close();
    connection.close();
}

JDBC的一些問題：

資料庫鏈接創建、釋放頻繁造成系統資源浪費從而影響系統性能
Sql陳述句變動比較大，每次變動都需要改動Java代碼
每個一業務需要撰寫大量重復的JDBC代碼，不宜維護

階段二：Mybatis入門

Mybatis對jdbc的操作資料庫的程序進行封裝，使開發者只需要關注 SQL 本身，而不需要花費精力去處理例如注冊驅動、創建connection、創建statement、手動設定引數、結果集檢索等jdbc繁雜的程序代碼，

其大致步驟：

首先匯入MyBatis jar包
建立 mybatis-config.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>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="https://www.cnblogs.com/tioxy/p/com.mysql.cj.jdbc.Driver"/>
                <property name="url" value="https://www.cnblogs.com/tioxy/p/jdbc:mysql://localhost:3306/school?serverTimezone=UTC&useUnicode=true&characterEncoding=utf-8&useSSL=True"/>
                <property name="username" value="https://www.cnblogs.com/tioxy/p/root"/>
                <property name="password" value="https://www.cnblogs.com/tioxy/p/970628"/>
            </dataSource>
        </environment>
    </environments>
</configuration>

通過mybatis環境等配置資訊構造SqlSessionFactory即會話工廠，階段一中創建資料庫連接等操作都交給sqlSessionFactory來操作
由會話工廠創建sqlSession即會話，操作資料庫需要通過sqlSession進行，類似于我們階段一中statement物件

public class MybatisUtils {
    private static SqlSessionFactory sqlSessionFactory;

    static {
        try {
            // 獲取sqlSessionFactory物件
            String resource="mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    // 既然有了 SqlSessionFactory，顧名思義，我們可以從中獲得 SqlSession 的實體，
    // SqlSession 提供了在資料庫執行 SQL 命令所需的所有方法，你可以通過 SqlSession 實體來直接執行已映射的 SQL 陳述句
    public static SqlSession getSqlSession(){
        return sqlSessionFactory.openSession();
    }
}

創建POJO對應的Mapper介面及對應的Mapper.xml檔案，我們在階段一需要寫Mapper的實作類，需要大量的JDBC操作代碼，這里我們通過Mapper.xml檔案實作，滿足SqlSession的呼叫，

public interface StudentMapper {
    // 查詢全部學生
    List<Student> getStudentList();

    // 根據id查詢學生
    Student getStudentById(int id);

    // 插入一個學生
    int addUser(Student student);

}

<?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要與dao下的Mapper名稱一一對應-->
<mapper namespace="com.tioxy.dao.StudentMapper">
    <!--id對應的是Mapper介面中對應的方法-->
    <!--resultType是SQL陳述句的回傳值-->
    <!--parameterType引數型別-->
    <select id="getStudentList" resultType="com.tioxy.pojo.Student">
        select * from school.student
    </select>

    <select id="getStudentById" resultType="com.tioxy.pojo.Student" parameterType="int">
        select * from school.student where id = #{id}
    </select>
    
    <insert id="addUser" parameterType="com.tioxy.pojo.Student" >
        insert into school.student (id,name,password,sex,birthd,address,email) values (#{id},#{name},#{password},#{sex},#{birthd},#{address},#{email});
    </insert>
</mapper>

在核心組態檔中注冊Mapper,目的需要告訴 MyBatis 到哪里去找到這些執行Sql陳述句


<!--每一個Mapper.xml檔案都需要在mybatis核心組態檔中注冊-->
<mappers>
    <mapper resource="com/tioxy/dao/StudentMapper.xml"/>
</mappers>

通過 sqlSession.getMapper()獲取介面對應的執行方法及結果
關閉連接

public void test(){

    // 第一步，獲取sqlSession物件
    SqlSession sqlSession= MybatisUtils.getSqlSession();
    try {
        // 方式一，getMapper
        StudentMapper mapper = sqlSession.getMapper(StudentMapper.class);
        List<Student> studentList = mapper.getStudentList();
        for (Student student : studentList) {
            System.out.println(student);
        }
    }catch (Exception e){
        e.printStackTrace();
    }finally {
        // 關閉sqlSession
        sqlSession.close();
    }
}

階段三：Spring中整合MyBatis

MyBatis-Spring 會幫助你將 MyBatis 代碼無縫地整合到 Spring 中，它將允許 MyBatis 參與到 Spring 的事務管理之中，創建映射器 mapper 和 SqlSession 并注入到 bean 中，以及將 Mybatis 的例外轉換為 Spring 的 DataAccessException，最終，可以做到應用代碼不依賴于 MyBatis，Spring 或 MyBatis-Spring，

大致步驟如下:

匯入 mybatis-spring 依賴包
在Spring xml檔案中通過Spring的資料源 DriverManagerDataSource 替換階段二中Mybatis的資料源

<!--DataSources:使用Spring的資料源替換Mybatis的配置
    這里使用Spring提供的JDBC
    -->
<bean id="dataSource" >
    <property name="driverClassName" value="https://www.cnblogs.com/tioxy/p/com.mysql.cj.jdbc.Driver"/>
    <property name="url" value="https://www.cnblogs.com/tioxy/p/jdbc:mysql://localhost:3306/school?serverTimezone=UTC&useUnicode=true&characterEncoding=utf-8&useSSL=True"/>
    <property name="username" value="https://www.cnblogs.com/tioxy/p/root"/>
    <property name="password" value="https://www.cnblogs.com/tioxy/p/970628"/>
</bean>

構建 SqlSessionFactoryBean ,在第二階段Mybatis入門的學習中，需要構建 SqlSessionFactory 通過 SqlSessionFactory 構建 SqlSession 進行資料庫的操作CURD，我們這里使用SqlSessionFactoryBean來創建 SqlSessionFactory，在Spring 的 XML 配置如下

<bean id="sqlSessionFactory" >
    <property name="dataSource" ref="dataSource" />
</bean>

同階段二撰寫POJO類及Mapper介面及Mapper.xml檔案并在組態檔中注冊Mapper
與基礎的 MyBatis 不同的是，需要創建Mapper介面的實作類，并繼承 SqlSessionDaoSupport，目的是不需要管理SqlSession，而且對事務的支持更加友好

import com.tioxy.pojo.User;
import org.mybatis.spring.support.SqlSessionDaoSupport;

import java.util.List;

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

注冊實作類的bean，并關聯 sqlSessionFactory

<bean id="userMapper2" >
    <property name="sqlSessionFactory" ref="sqlSessionFactory"/>
</bean>

通過 ApplicationContext 的 getBean()方法獲取介面并執行方法并回傳結果，

public void selectUserTest() throws IOException {
    ApplicationContext context = new ClassPathXmlApplicationContext("applicationContext.xml");
    UserMapper userMapper = context.getBean("userMapper2", UserMapper.class);
    for (User user : userMapper.selectUser()) {
        System.out.println(user);
    }
}

其中第5步，原理是內置使用了 SqlSessionTemplate ,SqlSessionTemplate 是 MyBatis-Spring 的核心，作為 SqlSession 的一個實作，這意味著可以使用它無縫代替你代碼中已經在使用的 SqlSession，SqlSessionTemplate 是執行緒安全的，可以被多個 DAO 或映射器所共享使用，構建 SqlSessionTemplate 是 Spring學習之Spring與Mybatis的兩種整合方式中的第一種整合方式，本文章使用第二種方式，

總的來說，就是 Mybatis 的操作被Spring接管，通過一個個Spring Bean來實作持久層操作，

階段四：SSM中整合MyBatis

其實有的小伙伴在這一階段已經開始使用注解方式進行Mybatis操作，我這里為了說明Mybatis的整個演程序序，使用配置方式說明

在這一階段與第三階段中使用Mybatis并沒有很大的差別,前四步與第三階段相同，其最大的改進是在Spring注冊bean MapperScannerConfigurer,其最大的作用是通過反射的方式自動的幫我們構造Mapper的實作類，省去我們手動撰寫，

<!--配置dao介面掃描包，動態的實作Dao介面可以注入到Spring容器中-->
    <bean >
        <!--注入 sqlSessionFactory-->
        <property name="sqlSessionFactoryBeanName" value="https://www.cnblogs.com/tioxy/p/sqlSessionFactory"/>
        <!--要掃描的包-->
        <property name="basePackage" value="https://www.cnblogs.com/tioxy/p/com.tioxy.mapper"/>
    </bean>

接下來就是通過Service層呼叫來實作具體的業務，

所以這一階段與階段三并沒有太大的差別與提升，可能有的小伙伴說，這一階段使用階段三也是可以的，的確如此，其實對于我來說，可能這一階段使用了 MapperScannerConfigurer,算作上一階段的簡化，所以拿出作為階段四，同理，我將使用注解的方式作為第四階段的簡化，所以放作下一階段五，

階段五：SpringBoot整合MyBatis

在這一階段使用注解進行開發，大大簡化了各項配置，使得更加專注于業務及Sql的操作，避免了大量繁瑣的配置，

大致步驟：

匯入mybatis的啟動器 mybatis-spring-boot-starter

<dependency>
    <groupId>org.mybatis.spring.boot</groupId>
    <artifactId>mybatis-spring-boot-starter</artifactId>
    <version>2.1.3</version>
</dependency>

在 application.yaml 檔案中配置資料源,同前幾階段在xml中配置資料源一樣

spring:
  datasource:
    username: root
    password: 970628
    url: jdbc:mysql://localhost:3306/school?serverTimezone=UTC&useUnicode=true&characterEncoding=utf-8
    driver-class-name: com.mysql.cj.jdbc.Driver

撰寫POJO類及Mapper介面及Mapper.xml檔案并在組態檔中添加Mapper.xml的掃描配置

# 整合Mybatis
mybatis:
  # 別名
  type-aliases-package: com.tioxy.pojo
  # 原來dao與mapper.xml在同一路徑，現在不在同一路徑需要設定下面的引數，目的就是告訴*.xml檔案的路徑
  mapper-locations: classpath:mybatis/mapper/*.xml

在前階段的構建 SqlSessionFactoryBean 以及 SqlSession 全都由Spring幫我們實作，所以這里我們省去了這幾項配置，只需在Mapper介面上添加@Mapper 注解，表示了這是一個 mybatis 的mapper 類，由Spring幫我們設定，而且也省去了階段四種使用 MapperScannerConfigurer 來創建Mapper對應的介面

這里我使用Mapper.xml撰寫SQL陳述句，也可以使用注解方式，兩種方式都可以，看個人喜好，我選擇xml檔案的原因是撰寫SQL陳述句靈活、擴展性好

如果使用注解方式撰寫Sql，則不需要Mapper.xml檔案，也不要設定Mapper.xml的掃描配置，直接在介面的方法中使用 @Select、@Insert等注解

@Mapper
@Repository
public interface UserMapper {
    /**
     * 查詢所有的用戶
     * @return
     */
    @Select("select * from User")
    List<User> queryUserList();
}

這里面 @Repository，是告訴Spring，這是一個Spring組件，類似于 @Controller、@Service一樣

如果不想在每個方法中都加上 @Mapper 注解，可以直接在SpringBoot主啟動類上添加 @MapperScan注解

@SpringBootApplication
@MapperScan("com.tioxy.mapper")
public class SpringBootMybatisApplication {

    public static void main(String[] args) {
        SpringApplication.run(SpringBootMybatisApplication.class, args);
    }
}

最后就是通過 @Autowired 自動裝配，獲取介面的各個業務方法進行持久層操作

總結

通過一個個階段的演進，從一開始JDBC，手動創建資料庫連接，創建 statement 執行Sql，這種方式，頻繁打開關閉資料庫，且Sql與Java代碼耦合度高，修改Sql需要修改Java代碼，很不方便，于是通過Mybatis進行封裝，在單獨的xml檔案種統一撰寫Sql，大大簡化了操作，Mybatis在不同階段隨著Spring的演進，也在逐漸簡化了各種繁瑣的配置，以及到最后的SpringBoot中，不再需要手動創建 SqlSessionFactoryBean、SqlSession 以及Mapper的實作類，通過注解操作，使得更加專注于業務及Sql的撰寫，當然在Java的體系中，持久化框架不只是Mybatis，還有Hibernate、TopLink、dbutils、Spring Data，其大致原理相似，這就需要根據實際開發及個人習慣進行選擇，

撰寫不易，轉載請注明出處
如有不當之處，感謝指正！

轉載請註明出處，本文鏈接：https://www.uj5u.com/houduan/115573.html

標籤：Java

上一篇：可笑，你竟然不知道 Java 如何生成 UUID

下一篇：Java IO流的簡單使用通俗易懂超詳細【內含案例】

淺談Mybatis持久化框架在Spring、SSM、SpringBoot整合的演進及簡化程序

前言

階段一：JDBC

階段二：Mybatis入門

階段三：Spring中整合MyBatis

階段四：SSM中整合MyBatis

階段五：SpringBoot整合MyBatis

總結