使用Mybatis的一些基本配置及Mybatis與數據庫交互測試驗證

1、簡介

什么是MyBatis？
MyBatis 是一款優秀的持久層框架，它支持定制化 SQL、存儲過程以及高級映射。MyBatis 避免了幾乎所有的 JDBC 代碼和手動設置參數以及獲取結果集。MyBatis 可以使用簡單的 XML 或注解來配置和映射原生信息，將接口和 Java 的 POJOs(Plain Ordinary Java Object,普通的 Java對象)映射成數據庫中的記錄。

特點

• 簡單易學：本身就很小且簡單。沒有任何第三方依賴，最簡單安裝只要兩個jar文件+配置幾個sql映射文件易於學習，易於使用，通過文檔和源代碼，可以比較完全的掌握它的設計思路和實現。
• 靈活：mybatis不會對應用程序或者數據庫的現有設計強加任何影響。 sql寫在xml里，便於統一管理和優化。通過sql語句可以滿足操作數據庫的所有需求。
• 解除sql與程序代碼的耦合：通過提供DAO層，將業務邏輯和數據訪問邏輯分離，使系統的設計更清晰，更易維護，更易單元測試。sql和代碼的分離，提高了可維護性。
• 提供映射標簽，支持對象與數據庫的orm字段關系映射。
• 提供對象關系映射標簽，支持對象關系組建維護。
• 提供xml標簽，支持編寫動態sql。

學習視頻：【狂神JAVA】MyBatis

2、創建一個簡單的MyBatis小程序

本人配置

• jdk1.8.0_191 （jdk1.7以上均可）
• Maven 3.8.2
• MySQL 8.0.17 （mysql5.6以上均可）

軟件：IDEA(2021.2.1)

1.首先新建一個Maven項目

這里先給大家看一下我的文件夾配置（沒有的需要自己新建喔_{），后面可以根據這個文件夾配置來放置自己的文件。當然，在實際項目開發中，問我的這種放置方式不是正確的，我這樣放置，是便於自己理解O(∩_∩)O哈哈}

2.配置pom.xml

對應文件名稱 pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>org.example</groupId>
    <artifactId>Mybatis</artifactId>
    <version>1.0-SNAPSHOT</version>
    <properties>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
    </properties>
    <!--    導入依賴-->
    <dependencies>
<!--        數據庫依賴-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.25</version>
        </dependency>
<!--        Mybatis依賴-->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.2</version>
        </dependency>
<!--        測試包依賴-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
        </dependency>
    </dependencies>

    <!--在build中配置resources，來防止我們資源導出失敗的問題-->
    <build>
        <resources>
            <resource>
                <directory>src/main/resources</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
            </resource>
            <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>true</filtering>
            </resource>
        </resources>
    </build>
</project>

3.配置數據庫連接

對應文件名稱 mybatis-config.xml
這里的屬性driver、url、username、password可以在idea里，連接數據庫時需要填的一些配置信息，復制過來即可

<?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.cj.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis?serverTimezone=GMT"/>
                <property name="username" value="root"/>
                <property name="password" value="zhy123"/>
            </dataSource>
        </environment>
    </environments>

    <!--每一個mapper.xml都需要注冊-->
    <!--這里特別重要噢，如果你以后的項目有多個類似UserMapper.xml這樣的文件（主要是寫SQL語句的），都需要在這里注冊喔~-->
    <mappers>
        <mapper resource="mybatis/Interface/UserMapper.xml"></mapper>
    </mappers>

</configuration>

4.配置Mybatis

對應文件名稱 MybatisUtils.java

package mybatis.utils;

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

import java.io.IOException;
import java.io.InputStream;

//sqlSessionFactory --> sqlSession
public class MybatisUtils {

    private static SqlSessionFactory sqlSessionFactory;

    static {
        try {
            //使用mybatis第一步：獲取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();
    }

}

5.新建實體類User

對應文件名稱 User.java
在此之前，可以在mysql新建一個數據庫和一張表（我這里的數據庫名是mybatis,表名是user）

以下代碼可以通過jar包lombok的注解來簡化代碼，感興趣的小伙伴可以去了解lombok的使用。

package mybatis.dataType;

public class User {
    int id;
    String name;
    String pwd;

    public User() {
    }

    public User(int id, String name, String pwd) {
        this.id = id;
        this.name = name;
        this.pwd = pwd;
    }

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getPwd() {
        return pwd;
    }

    public void setPwd(String pwd) {
        this.pwd = pwd;
    }

    @Override
    public String toString() {
        return "User{" +
                "id=" + id +
                ", name='" + name + '\'' +
                ", password='" + pwd + '\'' +
                '}';
    }
}

6.接口代碼

對應文件名稱 Inter.java

package mybatis.Interface;

import mybatis.dataType.User;

import java.util.List;

public interface Inter {
    //查詢數據庫全部內容
    List<User> getUserList();

    //通過id查找指定用戶
    User getUserById(Integer id);

    //插入一個用戶
    void addUser(User user);

    //更新一個用戶信息
    void updateUser(User user);

    //刪除一個用戶
    void deleteUser(Integer id);
}

7.接口實現類

對應文件名稱 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">
<!--namespace綁定一個對應的mapper接口-->
<mapper namespace="mybatis.Interface.Inter">
<!--查詢全部用戶信息-->
    <select id="getUserList" resultType="mybatis.dataType.User">
        select * from mybatis.user
    </select>
<!--通過一個id查詢用戶信息-->
    <select id="getUserById" resultType="mybatis.dataType.User">
        select * from mybatis.user where id=#{id}
    </select>
<!--插入一個用戶信息-->
    <insert id="addUser" parameterType="mybatis.dataType.User">
        insert into mybatis.user(id,name,pwd) values (#{id},#{name},#{pwd})
    </insert>
<!--更新一個用戶信息-->
    <update id="updateUser" parameterType="mybatis.dataType.User">
        update mybatis.user set name=#{name},pwd=#{pwd} where id=#{id}
    </update>
<!--刪除一個查用戶信息-->
    <delete id="deleteUser" parameterType="java.lang.Integer">
        delete from mybatis.user where id=#{id}
    </delete>
</mapper>

8.Test測試類驗證

對應文件名稱 test.java
測試的時候，是點側邊欄的這個按鍵運行：

注：測試只是用來驗證代碼是否正確，數據庫交互能否成功，正式項目開發中，按需所取即可

package mybatis;

import mybatis.Interface.Inter;
import mybatis.dataType.User;
import mybatis.utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;

import java.util.List;

public class test {

    //查詢全部用戶信息，這種寫法有處理異常，比較建議
    @Test
    public void test(){
        // 獲得sqlsession對象
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        try{
            // 1.執行 getmapper
            Inter userDao = sqlSession.getMapper(Inter.class);
            List<User> userList = userDao.getUserList();
            // method 2
            // List<User> userList = sqlSession.selectList("com.hou.dao.UserDao.getUserList");
            for(User user: userList){
                System.out.println(user);
            }
        }catch(Exception e){
            e.printStackTrace();
        }finally{
            //關閉
            sqlSession.close();
        }

    }

    //查詢全部用戶信息
    @Test
    public void getUserList(){
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        Inter mapper = sqlSession.getMapper(Inter.class);
        List<User> user = mapper.getUserList();
        System.out.println(user);
        sqlSession.close();
    }

    //通過一個id查詢用戶信息
    @Test
    public void getUserById(){
        SqlSession sqlSession = MybatisUtils.getSqlSession();

        Inter mapper = sqlSession.getMapper(Inter.class);
        User user = mapper.getUserById(1);
        System.out.println(user);
        sqlSession.close();
    }

    //增刪改需要提交事務

    //插入一個用戶信息
    @Test
    public void addUser(){
        SqlSession sqlSession = MybatisUtils.getSqlSession();

        Inter mapper = sqlSession.getMapper(Inter.class);
        mapper.addUser(new User(8,"周八","888"));

        //提交事務
        sqlSession.commit();
        sqlSession.close();
    }

    //更新一個用戶信息
    @Test
    public void updateUser(){
        SqlSession sqlSession = MybatisUtils.getSqlSession();

        Inter mapper = sqlSession.getMapper(Inter.class);
        mapper.updateUser(new User(8,"hello","123"));

        //提交事務
        sqlSession.commit();
        sqlSession.close();
    }

    //刪除一個查用戶信息
    @Test
    public void deleteUser(){
        SqlSession sqlSession = MybatisUtils.getSqlSession();

        Inter mapper = sqlSession.getMapper(Inter.class);
        mapper.deleteUser(8);

        //提交事務
        sqlSession.commit();
        sqlSession.close();
    }
}

這里的代碼，我是已經全部驗證成功了的，如果報錯的話，請查看下面幾條提示：

▸是否將文件mybatis-config.xml里的屬性配置成自己的，如driver、url、username、password；
▸是否將文件UserMapper.xml里的中文注釋刪除；
▸檢查一下SQL語句是否可以在數據庫中運行；
▸依賴包是否成功導入；
▸數據庫的數據是否提前已經寫好；
▸檢查文件pom.xml里的導入依賴包配置，mysql的版本號是否與自己的一致，我的是mysql版本8的；
...

暫時想到的是這些，如果是剛入門的新手，建議是先看懂我的代碼，然后復制看能不能運行，再去新建一個項目，模仿着來操作代碼，個人覺得這樣入門的比較快；

噢，對了，還可以先去看看前面設有鏈接的學習視頻，B站里的up主狂神的Mybatis講解,個人覺得講得真挺好的！