使用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讲解,个人觉得讲得真挺好的！