[SSM]MyBatis基础

一、MyBatis概述

1.1框架（framework）

1.2三层架构

1.3JDBC的不足

1.4了解MyBatis

二、MyBatis入门程序

2.1resources目录

2.2开发步骤

2.3从XML中构建SqlSessionFactory

2.4mybatis中有两个主要的配置文件

2.5关于第一个程序的细节

2.6关于mybatis的事务管理机制（深度剖析）

2.7单元测试

2.8关于mybatis集成日志组件，让我们调试起来更加方便

2.9MyBatis⼯具类SqlSessionUtil的封装

三、使用MyBatis完成CRUD

3.1什么是CRUD

3.2insert

3.3delete

3.4update

3.5select查询单条记录

3.6select查询所有记录

3.7关于SQL Mapper的namespace

四、MyBatis核心配置文件详解

一、MyBatis概述

1.1框架（framework）

Java常用框架：
- SSM三大框架：Spring+SpringMVC+MyBatis
- SpringBoot
- SpringCloud
框架其实就是对通用代码的封装，提前写好了一堆接口和类，我们可以在做项目的时候直接引用这些接口和类，基于这些现有的接口和类进行开发，可以大大提高开发效率。
框架一般都以jar包的形式存在。(jar包中有class文件以及各种配置文件等)

1.2三层架构

表现层(UI)：直接跟前端交互（一是接收前端的ajax请求，二是返回json数据给前端）。
业务逻辑层（BLL）：一使处理表现层转发过来的前端请求（具体业务），二是将持久化层获取的数据返回到表现层。
数据访问层（DAL）：直接完成数据库的CRUD，并将获得的数据返回到上一层（也就是业务逻辑层）。
Java的持久层框架：
- MyBatis
- Hibernate（实现了JPA规范）
- jOOQ
- Guzz
- Spring Data（实现了JPA规范）
- Active JDBC
- ......

1.3JDBC的不足

SQL语句写死在Java程序中，不灵活。改SQL的话就要改Java代码。违背了开闭原则OCP。
给?传值是繁琐的，不能自动化。
将结果集封装成Java对象是繁琐的，不能自动化。

1.4了解MyBatis

MyBatis本质上就是对JDBC的封装，通过MyBatis完成CRUD。
MyBatis在三层架构中复制持久化层，属于持久层框架。
ORM：对象关系映射
- O（Object）：Java虚拟机中的Java对象。
- R（Relational）：关系型数据库。
- M（Mapping）：将Java虚拟机中的Java对象映射到数据库表中一行记录，或是将数据库表中一行记录映射成Java虚拟机中的一个Java对象。
MyBatis属于半自动化ORM模型，Hibernate属于全自动化的ORM框架。
MyBatis框架特点：
- 支持定制化SQL、存储过程、基本映射以及高级映射。
- 避免了几乎所有的JDBC代码中手动设置参数以及获取结果集。
- 支持XML开发，也支持注解式开发。（为了保证sql语句的灵活，所以mybatis大部分是采用XML方式开发）
- 将接口和Java的POJOs映射成数据库中的记录。
- 体积小好学：两个jar包，两个XML配置文件。
- 完全做到SQL解耦合。
- 提供了基本映射标签、高级映射标签、XML标签，支持动态SQL的编写。
- ......

二、MyBatis入门程序

2.1resources目录

放到这个目录中的一般都是资源文件、配置文件。

直接放到resources目录下的资源等同于放到了类的根路径下。

2.2开发步骤

打包方式jar

<!--打包方式-->
    <packaging>jar</packaging>

引入依赖：

mybatis依赖

mysql依赖

<dependencies>
        <!--mybatis依赖-->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.11</version>
        </dependency>

        <!--mysql驱动依赖-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.29</version>
        </dependency>
    </dependencies>

编写mybatis核心配置文件：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/mybatis"/>
                <property name="username" value="root"/>
                <property name="password" value="030522"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <!--执行XxxMapper.xml文件的路径-->
        <!--resources属性自动会从类的根路径下开始查找资源-->
        <mapper resource="CarMapper.xml"/>
    </mappers>
</configuration>

编写XxxxMapper.xml文件
- 在这个文件中编写SQL语句，这个文件名和存放位置也不是固定的。

<?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="abc">
    <!--insert语句，id是这条sql语句的唯一标识，这个id就代表了这条sql语句-->
    <insert id="insertCar">
        insert into t_car(id,car_num,brand,guide_price,produce_time,car_type)
        values(null,'1003','丰田霸道',30.0,'2020-10-10','燃油车')
    </insert>

</mapper>

在mybatis-config.xml文件中指定XxxxMapper.xml文件的路径：<mapper resource="CarMapper.xml"/>
- 注意：resource属性会自动从类的根路径下开始查找资源。
编写mybatis程序。（使用mybatis的类库，编写mybatis程序，连接数据库，做crud）
- 在mybatis当中，负责执行SQL语句的那个对象是SqlSession。
- SqlSession是专门用来执行SQL语句的，是一个Java程序和数据库之间的一次会话。
- 要想先获取SqlSession对象，需要先获取SqlSessionFactory对象，通过SqlSessionFactory工厂来生产SqlSession对象。
- 要想获取SqlSessionFactory对象，需要先获取SqlSessionFactoryBuilder对象，通过SqlSessionFactoryBuilder对象的bulid方法，来获取一个SqlSessionFactory对象。
- mybatis核心包括：SqlSessionFactoryBuilder、SqlSessionFactory、SqlSession
- SqlSessionFactoryBuilder--->SqlSessionFactory--->SqlSession

2.3从XML中构建SqlSessionFactory

在mybatis中有一个很重要的对象SqlSessionFactory，SqlSessionFactory对象的创建需要XML（配置文件）。

2.4mybatis中有两个主要的配置文件

mybatis-config.xml，这个是核心配置文件，主要配置连接数据库的信息等。（只要一个）
XxxxMapper.xml，这个文件是专门用来编写SQL语句的配置文件。（一个表对应一个）

2.5关于第一个程序的细节

mybatis中的SQL语句的结尾";"可以省略。
Resources.getResourceAsStream
- 以后凡是遇到resource这个单词，大部分情况下，这种加载资源的方式就是从类的根路径下开始加载（查找）。
- 优点：采用这种方式，从类路径当中加载资源，项目的移植性很强。例如：项目从windows移植到linux，代码不需要修改，因为这个资源文件一直都在类路径当中。
InputStream is = new FileInputStream("d:\\mybatis-config.xml");
- 采用这种方式也可以。
- 缺点：可移植性太差，程序不够健壮，当移植到其它系统当中，可能导致路径失效，还需要修改java代码中的路径，违背了OCP原则。
InputStream is = ClassLoader.getSystemClassLoader().getResourceAsStream("mybatis-config.xml");
- ClassLoader.getSystemClassLoader() 获取系统的类加载器。
- 系统的类加载器中有一个方法：getResourceAsStream,它就是从类路径当中加载资源的。
- ```
InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
底层就是：InputStream is = ClassLoader.getSystemClassLoader().getResourceAsStream("mybatis-config.xml");
```
CarMapper.xml文件的名字和位置不是固定的。
- <mapper resource="CarMapper.xml"/> resource属性：这种方式是从类路径当中加载资源的。
- <mapper url="file:///d:/CarMapper.xml"/> url属性：这种方式是从绝对路径当中加载资源的。

2.6关于mybatis的事务管理机制（深度剖析）

在mybtais-config.xml文件中，可以通过<transactionManager type="JDBC">的配置进行mybatis事务的管理。
type属性的值包含两个（不包含大小写）：JDBC、MANAGED
在mybatis中提供了两种事务管理机制：JDBC事务管理机制、MANAGED事务管理机制

JDBC事务管理机制

mybatis框架自己管理事务，自己采用原生的JDBC代码去管理事务。

conn.setAutoCommit(false);//开启事务
//...业务处理...
conn.commit();//手动提交事务

使用JDBC事务管理器的话，底层创建的事务管理器对象:JdbcTransaction

SqlSession sqlSession = sqlSessionFactory.openSession(true);
表示没有开启事务，因为这种方式不会执行：conn.setAutoCommit(false);
在JDBC事务中，没有执行conn.setAutoCommit(false),那么autoCommit就是true。
如果autoCommit是true，就表示没有开启事务，只要执行任意一条DML语句就提交一次。

MANAGED事务管理器
- mybatis不再负责事务的管理，事务的管理交给其它容器类执行，例如：spring。
- 对于目前只有mybatis的情况下，如果配置MANAGED，那么事务就没有人管，没有人管说明事务根本没有开启。
重点：只要autoCommit是true，就表示没有开启事务。只要autoCommit是false，就表示开启了事务。

2.7单元测试

package com.hhb.junit.service;

/**
 * 数学业务类
 */
public class MathService {
    /**
     * 求和的业务方法
     *
     * @param a
     * @param b
     * @return
     */
    public int sum(int a, int b) {
        return a + b;
    }

    /**
     * 相减的业务方法
     *
     * @param a
     * @param b
     * @return
     */
    public int sub(int a, int b) {
        return a - b;
    }
}

package com.hhb.junit.service;

import org.junit.Assert;
import org.junit.Test;

/**
 * 单元测试类
 */
public class MathServiceTest {//名字规范：类名+Test

    //单元测试方法一般一个业务方法对应一个测试方法
    //测试方法规范：public void testXxxx(){}
    //测试方法的方法名：以test开始，testXxx
    //@Test注解非常重要，被这个注解标注的方法就是一个单元测试方法
    @Test
    public void testSum() {
        //单元测试中有两个重要的概念
        //一个是实际值（被测试的业务方法的真正执行结果）
        //一个是期望值（执行了这个业务方法之后，期望的执行结果是多少）
        MathService mathService = new MathService();
        //获取实际值
        int actual = mathService.sum(1, 2);
        //期望值
        int expected = 3;
        //加断言进行测试
        Assert.assertEquals(expected, actual);
    }

    @Test
    public void testSub() {
        int actual = new MathService().sub(10, 5);
        int expected = 5;
        Assert.assertEquals(expected, actual);
    }
}

2.8关于mybatis集成日志组件，让我们调试起来更加方便

mybatis常见的集成的日志组件有哪些？
- SLF4J（沙拉风）：沙拉风是一个日志标准，其中有一个框架叫做logback，它实现了沙拉风规范。
- LOG4J
- LOG4J2
- STDOUT_LOGGING
- ...
- 注意：log4j log4j2 logback都是同一个作者开发的。
STDOUT_LOGGING是标准日志，mybatis已经实现了这种标准日志，mybatis框架本身已经实现了这种标准，只要开启即可。
- 在mybatis-config.xml文件中使用settings标签进行配置开启
```
<settings>
    <setting name="logImpl" value="STDOUT_LOGGING"/>
</settings>
```
- 这个标签在编写的时候要注意，它应该出现在environments标签之前。
- 这种实现是可以的，可以看到一些信息，比如：连接对象什么时候创建、什么时候关闭、sql语句是怎样的。但是没有详细的日期、线程名称等，如果想要使用更加丰富的配置，可以集成第三方的log组件。

集成logback日志框架

logback日志框架实现了slf4j规范

第一步：引入logback的依赖。

<dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-classic</artifactId>
    <version>1.2.3</version>
</dependency>

第二步：引入logback所必须的xml配置文件

这个配置文件的名字必须叫做:logback.xml或者logback-test.xml，不能是其它的名字。
这个配置文件必须放到类的根路径下，不能在其它位置。
主要配置日志输出相关的级别以及日志具体的格式。

<?xml version="1.0" encoding="UTF-8"?>

<configuration debug="false">
    <!-- 控制台输出 -->
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <!--格式化输出：%d表示日期，%thread表示线程名，%-5level：级别从左显示5个字符宽度%msg：日志消息，%n是换行符-->
            <pattern>[%thread] %-5level %logger{50} - %msg%n</pattern>
        </encoder>
    </appender>

    <!--mybatis log configure-->
    <logger name="com.apache.ibatis" level="TRACE"/>
    <logger name="java.sql.Connection" level="DEBUG"/>
    <logger name="java.sql.Statement" level="DEBUG"/>
    <logger name="java.sql.PreparedStatement" level="DEBUG"/>

    <!-- 日志输出级别,logback日志级别包括五个：TRACE < DEBUG < INFO < WARN < ERROR -->
    <root level="DEBUG">
        <appender-ref ref="STDOUT"/>
        <appender-ref ref="FILE"/>
    </root>

</configuration>