1、MyBatis简介

1.1、MyBatis历史

MyBatis最初是Apache的一个开源项目iBatis, 2010年6月这个项目由Apache Software Foundation迁移到了Google Code。随着开发团队转投Google Code旗下， iBatis3.x正式更名为MyBatis。代码于2013年11月迁移到Github。

iBatis一词来源于“internet”和“abatis”的组合，是一个基于Java的持久层框架。 iBatis提供的持久层框架
包括SQL Maps和Data Access Objects（DAO）。

1.2、MyBatis特性

MyBatis 是支持定制化 SQL、存储过程以及高级映射的优秀的持久层框架
MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集
MyBatis可以使用简单的XML或注解用于配置和原始映射，将接口和Java的POJO（Plain Old JavaObjects，普通的Java对象）映射成数据库中的记录
MyBatis 是一个半自动的ORM（Object Relation Mapping）框架

1.3、MyBatis下载

MyBatis下载地址：https://github.com/mybatis/mybatis-3

1.4、和其它持久化层技术对比

JDBC
- SQL 夹杂在Java代码中耦合度高，导致硬编码内伤
- 维护不易且实际开发需求中 SQL 有变化，频繁修改的情况多见
- 代码冗长，开发效率低
Hibernate 和 JPA
- 操作简便，开发效率高
- 程序中的长难复杂 SQL 需要绕过框架
- 内部自动生产的 SQL，不容易做特殊优化
- 基于全映射的全自动框架，大量字段的 POJO 进行部分映射时比较困难。
- 反射操作太多，导致数据库性能下降
MyBatis
轻量级，性能出色
SQL 和 Java 编码分开，功能边界清晰。Java代码专注业务、SQL语句专注数据
开发效率稍逊于HIbernate，但是完全能够接受

2、搭建MyBatis

2.1、开发环境

IDE：idea 2021.3
构建工具：maven 3.8.6
MySQL版本：MySQL 8
MyBatis版本：MyBatis 3.5.10

MySQL不同版本的注意事项
1、驱动类driver-class-name

MySQL 5版本使用jdbc5驱动，驱动类使用：com.mysql.jdbc.Driver

MySQL 8版本使用jdbc8驱动，驱动类使用：com.mysql.cj.jdbc.Driver

2、连接地址url
MySQL 5版本的url：
jdbc:mysql://localhost:3306/ssm
MySQL 8版本的url：
jdbc:mysql://localhost:3306/ssm?serverTimezone=UTC
否则运行测试用例报告如下错误：
java.sql.SQLException: The server time zone value 'ÖÐ¹ú±ê×¼Ê±¼ä' is unrecognized or
represents more

2.2、创建maven工程

1> 打包方式：jar

2> 引入依赖

pom.xml

<dependencies>
    <!-- Mybatis核心 -->
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.7</version>
    </dependency>
    <!-- junit测试 -->
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.12</version>
        <scope>test</scope>
    </dependency>
    <!-- MySQL驱动 -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.16</version>
    </dependency>
</dependencies>

2.3、创建MyBatis的核心配置文件

习惯上命名为mybatis-config.xml，这个文件名仅仅只是建议，并非强制要求(最好还是这样铭铭)。

将来整合Spring之后，这个配置文件可以省略，所以大家操作时可以直接复制、粘贴。

核心配置文件主要用于配置连接数据库的环境以及MyBatis的全局配置信息
核心配置文件存放的位置是src/main/resources目录下

后续直接在idea 创建文件模板，高效复用

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.cj.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/ssm?
                                            serverTimezone=UTC"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
    <!--引入映射文件-->
    <mappers>
        <package name="mappers/UserMapper.xml"/>
    </mappers>
</configuration>

2.4、创建mapper接口

MyBatis中的mapper接口相当于以前的dao。但是区别在于，mapper仅仅是接口，我们不需要提供实现类。

UserMapper.java

package pers.dhx_.mapper;

import org.apache.ibatis.annotations.Insert;
import org.apache.ibatis.annotations.Param;
import pers.dhx_.pojo.User;

import java.util.List;
import java.util.Map;

/**
 * @author Dhx_
 * @className UserMapper
 * @description TODO
 * @date 2022/7/20 13:09
 */
public interface UserMapper {
    int insertUser(User user);


    void updateUser(User user);

    void deleteUser(Integer id);

    User getUserById();

    List<User> getAllUser();

    User checkLogin(String username, String password);

    User checkLoginByMap(Map<String,Object> map);

    User checkLoginByParam(@Param("username") String username, @Param("password")String password); 

}

2.5、创建MyBatis的映射文件

相关概念：ORM（Object Relationship Mapping）对象关系映射。
对象：Java的实体类对象
关系：关系型数据库
映射：二者之间的对应关系

Java概念	数据库概念
类	表
属性	字段
对象	记录、行、值

1、映射文件的命名规则：

表所对应的实体类的类名+Mapper.xml
例如：表t_user，映射的实体类为User，所对应的映射文件为UserMapper.xml

因此一个映射文件对应一个实体类，对应一张表的操作

MyBatis映射文件用于编写SQL，访问以及操作表中的数据

MyBatis映射文件存放的位置是src/main/resources/mappers目录下

2、 MyBatis中可以面向接口操作数据，要保证两个一致：

mapper接口的全类名和映射文件的命名空间（namespace）保持一致

mapper接口中方法的方法名和映射文件中编写SQL的标签的id属性保持一致

***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="${PACKAGE_NAME}.${NAME}">  
</mapper>

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="pers.dhx_.mapper.EmpMapper" >   <!--对应 相应的接口-->

<!--
    mapper 接口和映射文件一致
    1.mapper接口的全类名要和mapper保持一致
    2.接口中的方法名要和标签中的id 保持一致
-->
<!-- int   insertUser()   方法名要和id 一致-->

<!--    <update id="updateUser">-->
<!--        update t_user set username='root_update'   where id=2;-->
<!--    </update>-->
<!--    <delete id="deleteUser">-->
<!--        delete from t_user where username='admin';-->
<!--    </delete>-->

    <select id="getUserById" resultType="pers.dhx_.pojo.User" >
        select *from t_user where id=3;
    </select>
    <select id="getAllUser" resultType="User" >
        select *from t_user ;
    </select>

    <select id="checkLogin" resultType="User">
     <!--   select *from t_user where username='${username}' and password='${pwd}' ;-->
        select *from t_user where username=#{arg0} and password=#{arg1} ;
    </select>
    <!--  这两个属性只能设置一个
        resultType表示查询结果返回的类型    注意要写全类名
      resultMap：自定义映射， 处理一对一或一对多的映射关系-->
    <select id="checkLoginByMap" resultType="User">
        <!--   select *from t_user where username='${username}' and password='${pwd}' ;-->
        select *from t_user where username= #{username} and password=#{password} ;
    </select>

    <insert id="insertUser">
        insert into t_user values(null,#{username},#{password},#{age},#{gender},#{email});
    </insert>


<!--    User checkLoginByParam(@Param("username") String username, @Param("password")String password);-->
        <select id="checkLoginByParam" resultType="User">
            select *from t_user where username=#{username} and password=#{password};
        </select>
</mapper>

2.6、通过junit测试功能

@Test
public void test1() throws Exception
{
    //获取核心配置文件的输入流
    InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
    //获取SqlSessionFactoryBuilder对象
    SqlSessionFactoryBuilder sqlSessionFactoryBuilder=new SqlSessionFactoryBuilder();
    //获取SqlSessionFactory对象
    SqlSessionFactory sqlSessionFactory=sqlSessionFactoryBuilder.build(is);
    // 获取Sql 的会话对象  -- > SqlSession ， 是mybatis提供操作数据库的核心对象
    SqlSession sqlSession = sqlSessionFactory.openSession(true);  // 将参数设置为true ， 就是开启了自动提交
    //通过sqlSession获取UserMapper的代理实现对象 ,这个方法的底层 用的是代理模式， 实现的Mapper接口的一个代理实现类,重写了接口的方法（通过映射文件）
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    //        sqlSession.commit(); // 提交事务
    sqlSession.close(); // 关闭会话
}
@Test
public void TestSQlSession() throws IOException {
    SqlSession sqlSession = SqlSessionUtil.getSqlSession(); 
    var mapper = sqlSession.getMapper(UserMapper.class);
    mapper.insertUser(new User("Aymy","pwd",42,"女","645634532@qw.com"));
    sqlSession.close();
}


@Test
public void updateTest() throws IOException {
    //      获取核心配置文件的输入流
    InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
    //      获取SqlSessionFactoryBuilder对象
    SqlSessionFactoryBuilder sqlSessionFactoryBuilder=new SqlSessionFactoryBuilder();
    //      获取SqlSessionFactory对象
    SqlSessionFactory sqlSessionFactory=sqlSessionFactoryBuilder.build(is);
    //        获取Sql 的会话对象  -- > SqlSession ， 是mybatis提供操作数据库的核心对象
    SqlSession sqlSession = sqlSessionFactory.openSession(true);  // 将参数设置为true ， 就是开启了自动提交
    /* 通过sql 以及唯一标识找到SQL并执行， 唯一标识是 namespace.sqlID*/
    var mapper = sqlSession.getMapper(UserMapper.class);
    mapper.updateUser(new User("Aymy","pwd",42,"女","645634532@qw.com"));
    //        sqlSession.commit();  //提交事务
    sqlSession.close();
}

@Test
public void deleteTest() throws IOException {
    //      获取核心配置文件的输入流
    InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
    //      获取SqlSessionFactoryBuilder对象
    SqlSessionFactoryBuilder sqlSessionFactoryBuilder=new SqlSessionFactoryBuilder();
    //      获取SqlSessionFactory对象
    SqlSessionFactory sqlSessionFactory=sqlSessionFactoryBuilder.build(is);
    //        获取Sql 的会话对象  -- > SqlSession ， 是mybatis提供操作数据库的核心对象
    SqlSession sqlSession = sqlSessionFactory.openSession(true);  // 将参数设置为true ， 就是开启了自动提交
    /* 通过sql 以及唯一标识找到SQL并执行， 唯一标识是 namespace.sqlID*/
    var mapper = sqlSession.getMapper(UserMapper.class);
    mapper.deleteUser(13);
    //        sqlSession.commit();  //提交事务
    sqlSession.close();
}
@Test
public void selectTest1() throws IOException {
    var is = Resources.getResourceAsStream("mybatis-config.xml");
    SqlSession sqlSession= (new SqlSessionFactoryBuilder()).build(is).openSession(true);
    var mapper = sqlSession.getMapper(UserMapper.class);
    System.out.println(mapper.getUserById());

}

@Test
public void checkLoginTest() throws IOException {
    var is = Resources.getResourceAsStream("mybatis-config.xml");
    SqlSession sqlSession= (new SqlSessionFactoryBuilder()).build(is).openSession(true);
    var mapper = sqlSession.getMapper(UserMapper.class);
    System.out.println(mapper.checkLoginByParam("admin1", "123456"));
}
@Test
public void checkLoginByMapTest() throws IOException {
    Map<String,Object> map=new HashMap<>();
    var is = Resources.getResourceAsStream("mybatis-config.xml");
    SqlSession sqlSession= (new SqlSessionFactoryBuilder()).build(is).openSession(true);
    var mapper = sqlSession.getMapper(UserMapper.class);

    map.put("admin1","123456");
    map.put("root","23423");
    System.out.println(mapper.checkLoginByMap(map));
}

@Test
public void InsertMuch() throws IOException {
    var sqlSession = SqlSessionUtil.getSqlSession();
    var mapper = sqlSession.getMapper(UserMapper.class);
    int times=50;
    while(times--!=0)
    {
        String username= MyStringUtil.genericRandomLetter(3);
        String password= MyStringUtil.genericRandomLetter(3)+MyStringUtil.genericRandomNumber(5);
        int age= Integer.parseInt(MyStringUtil.genericRandomNumber(2));
        String email=MyStringUtil.genericRandomNumber(10)+"@qq.com";
        mapper.insertUser(new User(username,password,age,"男",email));
    }
}

可以发现上方又很多的重复代码：构造SqlSession

注意点：

当SQLSessionFactory.openSession(boolean b)；参数为true 是， SqlSession会自动提交事务，不需要手动提交

也就是可以省略sqlSession.commit();

SqlSessionUtil.java

用于快速生成SqlSession

public class SqlSessionUtil {
    public  static SqlSession getSqlSession() throws IOException {
        var resourceAsStream = Resources.getResourceAsStream("mybatis-config.xml");
        return new SqlSessionFactoryBuilder().build(resourceAsStream).openSession(true);
    }
}

MyStringUtil.java

用于生成字符串和数字，写入数据库表

public class MyStringUtil {

    public static String genericRandomNumber(int size)
    {
        StringBuffer res=new StringBuffer("");
        while(size--!=0)
        {
            res.append((char)(Math.random()*100%10+48));
        }
        return res.toString();
    }
    public static String genericRandomLetter(int size)
    {
        StringBuffer res=new StringBuffer("");
        if(size==3)
            res.append((char)(Math.random()*100%26+97));
        while(size--!=0)
        {
            res.append((char)(Math.random()*100%26+65));
        }
        return res.toString().toLowerCase(Locale.ROOT);
    }
}

2.7、加入log4j日志功能

1>加入依赖

<!-- log4j日志 -->
<dependency>
    <groupId>log4j</groupId>
    <artifactId>log4j</artifactId>
    <version>1.2.17</version>
</dependency>

2>加入log4j的配置文件

log4j的配置文件名为log4j.xml，存放的位置是src/main/resources目录下

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
    <appender name="STDOUT" class="org.apache.log4j.ConsoleAppender">
        <param name="Encoding" value="UTF-8" />
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern" value="%-5p %d{MM-dd HH:mm:ss,SSS}
%m (%F:%L) \n" />
        </layout>
    </appender>
    <logger name="java.sql">
        <level value="debug" />
    </logger>
    <logger name="org.apache.ibatis">
        <level value="info" />
    </logger>
    <root>
        <level value="debug" />
        <appender-ref ref="STDOUT" />
    </root>
</log4j:configuration>

日志的级别
FATAL(致命)>ERROR(错误)>WARN(警告)>INFO(信息)>DEBUG(调试)

从左到右打印的内容越来越详细

3、核心配置文件详解

核心配置文件中的标签必须按照固定的顺序(标签的书写顺序)：
properties?,settings?,typeAliases?,typeHandlers?,objectFactory?,objectWrapperFactory?,refl
ectorFactory?,plugins?,environments?,databaseIdProvider?,mappers?

<?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"/>  <!--引入properties 文件 ,就可以在当前文件中使用 ${key} 访问properties 中的value-->
    <typeAliases>  <!--就是起别名,默认的别名就是类名，并且不区分大小写-->
        <typeAlias type="pers.dhx_.mapper.EmpMapper" alias="UserMapper"/>
<!--        <typeAlias type="pers.dhx_.pojo.User" alias="User"/>-->
<!--        通过包来设置类型别名，指定包下所有的类型都会拥有默认的别名，并且不区分大小写-->
        <package name="pers.dhx_.pojo"/>
    </typeAliases>
<!--设置连接数据库的环境-->
    <environments default="development">
            <!-- environment：配置某个具体的环境
            属性：id：表示连接数据库的环境的唯一标识，不能重复-->
        <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>
                <!--
                dataSource：配置数据源
                属性：
                type：设置数据源的类型
                type="POOLED|UNPOOLED|JNDI"
                POOLED：表示使用数据库连接池缓存数据库连接
                UNPOOLED：表示不使用数据库连接池
                JNDI：表示使用上下文中的数据源
                -->
        </environment>
    </environments>
    
    <!--引入映射文件-->
    <mappers>
        <package name="pers.dhx_.mapper"/>
!--<mapper resource="mappers/UserMapper.xml"/>-->
<!--以包为单位引入映射文件
要求：
1、mapper接口所在的包要和映射文件所在的包一致
2、mapper接口要和映射文件的名字一致-->
    </mappers>
</configuration>

jdbc.properties

注意末尾不用写；

jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/ssm?useUnicode=true&characterEncoding=utf8&serverTimezone=UTC
jdbc.username=root
jdbc.password=****

mybatis使用package方式映射mapper报错

在初学mybatis通过junit测试功能时系统一直报

Mapped Statements collection does not contain value for pers.dhx_.DAO.UserMapper.insertUser

大概意思是mybatis无法找到UserMapper的映射文件

也就是识别UserMapper.xml过程中出问题了

测试的代码如下:

@Test
public void test1() throws Exception{
    InputStream is = Resources.getResourceAsStream("mybatis-config.xml");

    SqlSessionFactoryBuilder sqlSessionFactoryBuilder=new SqlSessionFactoryBuilder();

    SqlSessionFactory sqlSessionFactory=sqlSessionFactoryBuilder.build(is);

    SqlSession sqlSession = sqlSessionFactory.openSession(true);  // 将参数设置为true ， 就是开启了自动提交

    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    System.out.println(mapper.insertUser());
    sqlSession.close(); // 关闭会话
}

原本是将UserMapper.xml放在resources目录下

UerMapper.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="pers.dhx_.mapper.UserMapper" >   <!--对应 相应的接口-->

<!--
    mapper 接口和映射文件一致
    1.mapper接口的全类名要和mapper保持一致
    2.接口中的方法名要和标签中的id 保持一致
-->
<!-- int   insertUser()   方法名要和id 一致-->
    <insert id="insertUser">
        insert into t_user values(null,'admin1','123456',23,'男','12345@qq.com')
    </insert>
</mapper>

后来查阅资料发现错误原因是，如果使用package标签映射mapper文件， resources目录和java目录中的 xml文件要与接口对应

看图就明白了

教程里面的老师没有说这个，但是也应该注意

其他映射mapper的方法

mapper标签使用resource映射

mybatis-config.xml

resource

<?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/ssm?serverTimezone=UTC"/>
                <property name="username" value="root"/>
                <property name="password" value="${password}"/>
            </dataSource>
        </environment>
    </environments>
    <!--引入映射文件-->
    <mappers> 
        <mapper resource="pers/dhx_/mapper/UserMapper.xml"/>
    </mappers> 
</configuration>

附上resources目录

mapper标签使用class映射

class 注意要写全类名

需要注意的是这里需要在接口的方法上面写上对应的注解

UserMapper.java

package pers.dhx_.mapper;

import org.apache.ibatis.annotations.Insert;

/**
 * @author Dhx_
 * @className UserMapper
 * @description TODO
 * @date 2022/7/20 15:09
 */
public interface UserMapper {
    @Insert(value = "insert into t_user values(null,'admin','123456',23,'男','12345@qq.com')")
    int insertUser();
}

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.cj.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/ssm?serverTimezone=UTC"/>
                <property name="username" value="root"/>
                <property name="password" value="${password}"/>
            </dataSource>
        </environment>
    </environments>
    <!--引入映射文件-->
    <mappers>
        <mapper class="pers.dhx_.mapper.UserMapper"/>
    </mappers>
</configuration>

mapper标签使用url映射

其实就是使用绝对路径

一般情况下不会使用这种方式，了解即可

<configuration> 
    <mappers> 
        <mapper url="file:///C:/User/lenovo/Desktop/mappers/UserMapper" /> 
    </mappers> 
</configuration>