初識Mybatis

hresh發表於2020-03-30

什麼是 MyBatis?

MyBatis 是一款優秀的持久層框架,它支援自定義 SQL、儲存過程以及高階對映。MyBatis 免除了幾乎所有的 JDBC 程式碼以及設定引數和獲取結果集的工作。MyBatis 可以通過簡單的 XML 或註解來配置和對映原始型別、介面和 Java POJO(Plain Old Java Objects,普通老式 Java 物件)為資料庫中的記錄。

Mybatis 官方文件 : http://www.mybatis.org/mybatis-3/zh/index.html

GitHub : https://github.com/mybatis/mybatis-3

持久化

持久化是將程式資料在持久狀態和瞬時狀態轉換的機制。

  • 即把資料(如記憶體中的物件)儲存到可永久儲存的儲存裝置中(如磁碟)。持久化的主要應用是將記憶體中的物件儲存在資料庫中,或者儲存在磁碟檔案中、XML資料檔案中等等。
  • JDBC就是一種持久化機制。檔案IO也是一種持久化機制。
  • 在生活中 : 將鮮肉冷藏,吃的時候再解凍的方法也是。將水果做成罐頭的方法也是。

為什麼需要持久化服務?那是由於記憶體本身的缺陷引起的

  • 記憶體斷電後資料會丟失,但有一些物件是無論如何都不能丟失的,比如銀行賬號等,遺憾的是,人們還無法保證記憶體永不掉電。
  • 記憶體過於昂貴,與硬碟、光碟等外存相比,記憶體的價格要高2~3個數量級,而且維持成本也高,至少需要一直供電吧。所以即使物件不需要永久儲存,也會因為記憶體的容量限制不能一直呆在記憶體中,需要持久化來快取到外存。

持久層

什麼是持久層?

  • 完成持久化工作的程式碼塊 . ----> dao層 【DAO (Data Access Object) 資料訪問物件】
  • 大多數情況下特別是企業級應用,資料持久化往往也就意味著將記憶體中的資料儲存到磁碟上加以固化,而持久化的實現過程則大多通過各種關聯式資料庫來完成。
  • 不過這裡有一個字需要特別強調,也就是所謂的“層”。對於應用系統而言,資料持久功能大多是必不可少的組成部分。也就是說,我們的系統中,已經天然的具備了“持久層”概念?也許是,但也許實際情況並非如此。之所以要獨立出一個“持久層”的概念,而不是“持久模組”,“持久單元”,也就意味著,我們的系統架構中,應該有一個相對獨立的邏輯層面,專著於資料持久化邏輯的實現.
  • 與系統其他部分相對而言,這個層面應該具有一個較為清晰和嚴格的邏輯邊界。 【說白了就是用來運算元據庫存在的!】

為什麼需要 Mybatis

  • Mybatis就是幫助程式猿將資料存入資料庫中 , 和從資料庫中取資料 .
  • 傳統的jdbc操作 , 有很多重複程式碼塊 .比如 : 資料取出時的封裝 , 資料庫的建立連線等等… , 通過框架可以減少重複程式碼,提高開發效率 。
  • MyBatis 是一個半自動化的ORM框架 (Object Relationship Mapping) -->物件關係對映
  • 所有的事情,不用Mybatis依舊可以做到,只是用了它,所有實現會更加簡單!技術沒有高低之分,只有使用這個技術的人有高低之別
  • MyBatis的優點
  • 簡單易學:本身就很小且簡單。沒有任何第三方依賴,最簡單安裝只要兩個jar檔案+配置幾個sql對映檔案就可以了,易於學習,易於使用,通過文件和原始碼,可以比較完全的掌握它的設計思路和實現。
  • 靈活:mybatis 不會對應用程式或者資料庫的現有設計強加任何影響。 sql寫在xml裡,便於統一管理和優化。通過 sql 語句可以滿足運算元據庫的所有需求。
  • 解除 sql 與程式程式碼的耦合:通過提供 DAO 層,將業務邏輯和資料訪問邏輯分離,使系統的設計更清晰,更易維護,更易單元測試。sql 和程式碼的分離,提高了可維護性。
  • 提供 xml 標籤,支援編寫動態sql。

Mybatis 入門

資料庫環境

----新建資料庫
CREATE DATABASE `mybatis`;

USE `mybatis`;

----新建表
DROP TABLE if EXISTS `user`;
CREATE TABLE `user`(
    `id` INT(20NOT NULL AUTO_INCREMENT COMMENT '自增主鍵',
    `name` VARCHAR(30DEFAULT NULL COMMENT '姓名',
    `pwd` VARCHAR(30DEFAULT NULL COMMENT '密碼',
    PRIMARY KEY(`id`)
)ENGINE=INNODB DEFAULT charset=utf8;

---插入資料
INSERT into `user` (`name`,`pwd`VALUES
('hresh','123456'),
('hresh2','123456'),
('hresh3','123456')
複製程式碼

基本環境搭建

1、pom.xml

dependencies>
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>5.1.47</version>
</dependency>
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.4.6</version>
</dependency>
<dependency>
    <groupId>junit</groupId>
    <artifactId>junit</artifactId>
    <version>4.12</version>
</dependency>
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.10</version>
</dependency>
</dependencies>
複製程式碼

2、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="com.mysql.jdbc.Driver"/>
                <!--jdbc.url=jdbc:mysql://localhost:3306/oto?useUnicode=true&characterEncoding=utf8&serverTimezone=UTC-->
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useUnicode=true&amp;useSSL=true&amp;serverTimezone=UTC&amp;characterEncoding=utf-8"/>
                <property name="username" value="root"/>
                <property name="password" value="1234567"/>
            </dataSource>
        </environment>
    </environments>

    <mappers>
        <mapper resource="com/msdn/mapper/UserMapper.xml"/>
    </mappers>
</configuration>
複製程式碼

3、工具類:MybatisUtil.java

public class MybatisUtil {

    private static SqlSessionFactory sqlSessionFactory;

    static {
        String resource = "mybatis-config.xml";
        try {
            InputStream inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
    public static SqlSession getSqlSession(){
        return sqlSessionFactory.openSession();
    }
}
複製程式碼

每個基於 MyBatis 的應用都是以一個 SqlSessionFactory 的例項為核心的。SqlSessionFactory 的例項可以通過 SqlSessionFactoryBuilder 獲得。而 SqlSessionFactoryBuilder 則可以從 XML 配置檔案或一個預先配置的 Configuration 例項來構建出 SqlSessionFactory 例項。 接著再從 SqlSessionFactory 例項中獲得 SqlSession 的例項。SqlSession 提供了在資料庫執行 SQL 命令所需的所有方法 。

4、實體類:User.java

@Data
@AllArgsConstructor
public class User {
    private int id;
    private String name;
    private String pwd;
}
複製程式碼

5、介面類:UserMapper.java

public interface UserMapper {

    List<User> getUserList();
    User selectUser(int id);
    User getUser(Map<String,Object> map);
    List<User> getUserLike(String name);
    List<User> getUserLike2(String name);
    int updateUser(User user);
    int insertUser(User user);
    int deleteUser(User user);
}
複製程式碼

6、編寫 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="com.msdn.mapper.UserMapper">
    <select id="getUserList" resultType="com.msdn.bean.User">
        select * from mybatis.user
    </select>

    <select id="selectUser" parameterType="int" resultType="com.msdn.bean.User">
        select * from mybatis.user where id = #{id}
    </select>

    <select id="getUser" parameterType="map" resultType="com.msdn.bean.User">
        select * from mybatis.user where name = #{name}
    </select>

    <!--select * from mybatis.user where name like "%"#{name}"%"-->
    <select id="getUserLike" parameterType="String" resultType="com.msdn.bean.User">
        select * from mybatis.user where name like #{name}
    </select>

    <select id="getUserLike2" parameterType="String" resultType="com.msdn.bean.User">
        select * from mybatis.user where name like "%"#{name}"%"
    </select>

    <insert id="insertUser" parameterType="com.msdn.bean.User">
        insert into mybatis.user(name,pwd) values(#{name},#{pwd})
    </insert>

    <update id="updateUser" parameterType="com.msdn.bean.User">
        update mybatis.user set name = #{name} where id=#{id};
    </update>

    <delete id="deleteUser" parameterType="com.msdn.bean.User">
        delete from mybatis.user where id=#{id}
    </delete>
</mapper>
複製程式碼

7、測試類

public class UserTest {

    @Test
    public void getUser(){
        SqlSession sqlSession = MybatisUtil.getSqlSession();

        //方式一
        //方法一有很多優勢,首先它不依賴於字串字面值,會更安全一點
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        List<User> users = userMapper.getUserList();

        //方式二
//        List<User> users = sqlSession.selectList("com.msdn.mapper.UserMapper.getUserList");

        for (User user :
                users) {
            System.out.println(user);
        }

        sqlSession.close();
    }

    @Test
    public void getUser2(){
        SqlSession sqlSession = MybatisUtil.getSqlSession();

        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        Map<String, Object> map = new HashMap<String, Object>();

        map.put("name","hresh");
        map.put("id","2");
        User user = userMapper.getUser(map);

        System.out.println(user);

        sqlSession.close();
    }

    @Test
    public void getUserLike(){
        SqlSession sqlSession = MybatisUtil.getSqlSession();

        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        String name = "%hresh%";
//        List<User> users = userMapper.getUserLike(name);
        List<User> users = userMapper.getUserLike2("resh");
        for (User u :
                users) {
            System.out.println(u);
        }

        sqlSession.close();
    }

    @Test
    public void selectOne(){
        SqlSession sqlSession = MybatisUtil.getSqlSession();

        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        User user = userMapper.selectUser(2);
        System.out.println(user);

        sqlSession.close();
    }

    @Test
    public void insertOne(){
        SqlSession sqlSession = MybatisUtil.getSqlSession();

        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        User user = new User(11,"acorn","23455");
        int res = userMapper.insertUser(user);

        sqlSession.commit();
        sqlSession.close();
    }


    @Test
    public void updateOne(){
        SqlSession sqlSession = MybatisUtil.getSqlSession();

        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        User user = new User(3,"she","123453");
        userMapper.updateUser(user);

        sqlSession.commit();
        sqlSession.close();
    }

    @Test
    public void deleteOne(){
        SqlSession sqlSession = MybatisUtil.getSqlSession();

        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        User user = new User(3,"she","123453");
        userMapper.deleteUser(user);

        sqlSession.commit();
        sqlSession.close();
    }
}
複製程式碼

Mybatis 執行流程

作用域理解

  • SqlSessionFactoryBuilder 的作用在於建立 SqlSessionFactory,建立成功後,SqlSessionFactoryBuilder 就失去了作用,所以它只能存在於建立 SqlSessionFactory 的方法中,而不要讓其長期存在。因此 SqlSessionFactoryBuilder 例項的最佳作用域是方法作用域(也就是區域性方法變數)。
  • SqlSessionFactory 可以被認為是一個資料庫連線池,它的作用是建立 SqlSession 介面物件。因為 MyBatis 的本質就是 Java 對資料庫的操作,所以 SqlSessionFactory 的生命週期存在於整個 MyBatis 的應用之中,所以一旦建立了 SqlSessionFactory,就要長期儲存它,直至不再使用 MyBatis 應用,所以可以認為 SqlSessionFactory 的生命週期就等同於 MyBatis 的應用週期。
  • 由於 SqlSessionFactory 是一個對資料庫的連線池,所以它佔據著資料庫的連線資源。如果建立多個 SqlSessionFactory,那麼就存在多個資料庫連線池,這樣不利於對資料庫資源的控制,也會導致資料庫連線資源被消耗光,出現系統當機等情況,所以儘量避免發生這樣的情況。
  • 因此在一般的應用中我們往往希望 SqlSessionFactory 作為一個單例,讓它在應用中被共享。所以說 SqlSessionFactory 的最佳作用域是應用作用域。
  • 如果說 SqlSessionFactory 相當於資料庫連線池,那麼 SqlSession 就相當於一個資料庫連線(Connection 物件),你可以在一個事務裡面執行多條 SQL,然後通過它的 commit、rollback 等方法,提交或者回滾事務。所以它應該存活在一個業務請求中,處理完整個請求後,應該關閉這條連線,讓它歸還給 SqlSessionFactory,否則資料庫資源就很快被耗費精光,系統就會癱瘓,所以用 try…catch…finally… 語句來保證其正確關閉。
  • 所以 SqlSession 的最佳的作用域是請求或方法作用域。

注意事項

Maven靜態資源過濾問題

在 pom.xml 檔案中新增如下配置:

<resources>
    <resource>
        <directory>src/main/java</directory>
        <includes>
            <include>**/*.properties</include>
            <include>**/*.xml</include>
        </includes>
        <filtering>false</filtering>
    </resource>
    <resource>
        <directory>src/main/resources</directory>
        <includes>
            <include>**/*.properties</include>
            <include>**/*.xml</include>
        </includes>
        <filtering>false</filtering>
    </resource>
</resources>
複製程式碼

IDEA 連線 Mysql 資料庫

Mysql 依賴根據版本不同配置略有不同

Mysql 5.x

driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useUnicode=true&useSSL=true&serverTimezone=UTC&characterEncoding=utf-8
username=root
password=123456
複製程式碼

Mysql 8.x

driver=com.mysql.cj.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useUnicode=true&useSSL=true&serverTimezone=UTC&characterEncoding=utf-8&serverTimezone=Asia/Shanghai
username=root
password=123456
複製程式碼

需要更換 driver 物件,同時需要在 url 中指定時區。