MyBatis详解

MyBatis 详解

0. 学习准备

环境

• JDK 1.8
• MySQL 8.0
• maven 3.6.3
• IDEA

所需知识

• JDBC
• MySQL
• Java基础
• maven
• Junit

1. 简介

1.1 什么是Mybatis？

• MyBatis 是一款优秀的持久层框架。

• 它支持自定义 SQL、存储过程以及高级映射。

• MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。

• MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录。

• MyBatis 本是apache的一个开源项目，原名iBatis。2010年这个项目由apache software foundation 迁移到了 google code，并且改名为MyBatis 。

• 2013年11月迁移到 Github。

1.2 如何获取Mybatis？

• maven 仓库

<!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.6</version>
</dependency>

• Github：MyBatis3
• 中文文档：MyBatis中文文档

1.3 持久化

数据持久化：将程序的数据在瞬时的状态和持久的状态之间转化的过程。

需要持久化的原因：

1. 内存断电即失，但有些对象不能丢失。
2. 内存的价格太高。

1.4 持久层

层：如DAO层、Service层、Controller层等。层的界限十分明显。

持久层：完成持久化工作的代码块。

1.5 为什么需要MyBatis？

• 帮助程序员将数据存入数据库中。
• 方便。
• 简化代码，实现自动化。
• 不用MyBatis也可以，它只是更容易上手。
• 技术没有高低之分，使用技术的人亦然。

1.6 MyBatis的优点

• 简单易学：本身就很小且简单。没有任何第三方依赖，最简单安装只要两个jar文件+配置几个sql映射文件。易于学习，易于使用，通过文档和源代码，可以比较完全的掌握它的设计思路和实现。
• 灵活：mybatis不会对应用程序或者数据库的现有设计强加任何影响。 sql写在xml里，便于统一管理和优化。通过sql语句可以满足操作数据库的所有需求。
• 解除sql与程序代码的耦合：通过提供DAO层，将业务逻辑和数据访问逻辑分离，使系统的设计更清晰，更易维护，更易单元测试。sql和代码的分离，提高了可维护性。
• 提供映射标签，支持对象与数据库的orm字段关系映射。
• 提供对象关系映射标签，支持对象关系组建维护。
• 提供xml标签，支持编写动态sql。

2. 第一个MyBatis程序

思路：搭建环境 --> 导入MyBatis --> 编写代码 --> 测试

2.1 搭建环境

• 搭建数据库

create database mybatis;

use mybatis;

create table user(
	id int(20) primary key,
    name varchar(30) not null,
    pwd varchar(30) not null
)engine=innodb default charset=utf8;

insert into user values
(1, '刘季恒', '123456')，
(2, '周松雅', '654321')，
(3, '沈琉灵', '101010')

• 新建项目

1. 新建一个普通maven项目
2. 删除src目录
3. 导入maven依赖

<!--导入依赖-->
<dependencies>
    <!--mysql驱动-->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.23</version>
    </dependency>
    <!--mybatis-->
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.6</version>
    </dependency>
    <!--Junit-->
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.12</version>
    </dependency>
</dependencies>

2.2 创建模块

• 编写MyBatis核心配置文件

<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?useUnicode=true&amp;characterEncoding=utf8&amp;serverTimezone=GMT"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>

</configuration>

• 编写MyBatis工具类

package com.wmwx.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 MyBatisUtil {
    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 命令所需的所有方法。
    public static SqlSession getSqlSession(){
        return sqlSessionFactory.openSession();
    }
}

2.3 编写代码

• 实体类

package com.wmwx.pojo;
//实体类
public class User {
    private int id;
    private String name;
    private 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 + '\'' +
                ", pwd='" + pwd + '\'' +
                '}';
    }
}

• UserMapper接口

package com.wmwx.dao;

import com.wmwx.pojo.User;

import java.util.List;

public interface UserMapper {
    List<User> getUserList();
}

• 接口实现（由JDBC中的UserDao实现类转变为UserMapper配置文件）

<?xml version="1.0" encoding="UTF8" ?>
<!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">

<!--namespace 绑定一个对应的Dao/Mapper接口-->
<mapper namespace="com.wmwx.dao.UserMapper">
    <!--select 查询语句-->
    <select id="getUserList" resultType="com.wmwx.pojo.User">
        select * from mybatis.user
    </select>
</mapper>

2.4 测试

• 测试方法：使用Junit类

注意点：

1. 报错：org.apache.ibatis.binding.BindingException: Type interface com.wmwx.dao.UserDao is not known to the MapperRegistry.

   错误原因：每一个Mapper文件都需要在mybatis-config.xml中注册

   解决方案：

   <mappers>
       <mapper resource="com/wmwx/dao/UserMapper.xml" />
   </mappers>
   

2. 报错：could not find resource com/ wmwx/dao/UserMapper.xml

   错误原因：资源文件没有被导出

   解决方案：

   <!-- 在build中配置resources，来防止资源导出失败的问题-->
   <build>
       <resources>
           <resource>
               <directory>src/main/resources</directory>
               <filtering>true</filtering>
               <includes>
                   <include>**/*.properties</include>
                   <include>**/*.xml</include>
               </includes>
           </resource>
           <resource>
               <directory>src/main/java</directory>
               <filtering>true</filtering>
               <includes>
                   <include>**/*.properties</include>
                   <include>**/*.xml</include>
               </includes>
           </resource>
       </resources>
   </build>
   

测试代码：

package com.wmwx.dao;

import com.wmwx.pojo.User;
import com.wmwx.utils.MyBatisUtil;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;

import java.util.List;

public class UserMapperTest {
    @Test
    public void test(){
        //第一步：获取sqlSession对象
        SqlSession sqlSession = MyBatisUtil.getSqlSession();
        //第二步：获取userMapper对象
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        //第三步：执行SQL
        List<User> userList = userMapper.getUserList();
        for (User user : userList) {
            System.out.println(user);
        }
        //第四步：关闭sqlSession
        sqlSession.close();
    }
}

可能遇到的问题有：

1. 配置文件没有注册
2. 绑定接口错误
3. 方法名错误
4. 返回类型错误
5. maven导出资源问题

3. CRUD

3.1 namespace

namespace 中的包名要和 Dao/Mapper 接口的包名一致。

3.2 select

选择，即查询语句。

• id：就是对应的namespace中的方法名
• resultType：sql语句执行的返回值
• parameterType：参数类型

示例：

UserMapper接口

//根据id查询用户
User getUserById(int id);

UserMapper.xml

<select id="getUserById" resultType="com.wmwx.pojo.User" parameterType="int">
    select * from mybatis.user where id = #{id}
</select>

测试类：

@Test
public void getUserById(){
    SqlSession sqlSession = MyBatisUtil.getSqlSession();

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

    sqlSession.close();
}

输出结果：

User{id=2, name='周松雅', pwd='654321'}

3.3 insert

即插入语句。

示例：

UserMapper接口：

//增加一个用户
int insertUser(User user);

UserMapper.xml：

<!--insert 插入语句-->
<insert id="insertUser" parameterType="com.wmwx.pojo.User">
    <!--对象中的属性可以直接取出-->
    insert into mybatis.user (id, name, pwd) values (#{id}, #{name}, #{pwd})
</insert>

测试类：

@Test
public void insertUser(){
    SqlSession sqlSession = MyBatisUtil.getSqlSession();
    UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
    User user = new User(4, "吕沁", "197812");
    if(userMapper.insertUser(user) == 1){
        System.out.println("插入成功！");
    }

    //增删改需要提交事务
    sqlSession.commit();

    sqlSession.close();
}

输出结果：

插入成功！

3.4 update

即修改语句。

示例：

UserMapper接口：

//修改一个用户
int updateUserById(User user);

UserMapper.xml：

<!--update 修改语句-->
<update id="updateUserById" parameterType="com.wmwx.pojo.User">
    update mybatis.user set name=#{name}, pwd=#{pwd} where id=#{id}
</update>

测试类：

@Test
public void updateUserById(){
    SqlSession sqlSession = MyBatisUtil.getSqlSession();

    UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
    User user = new User(1, "刘季恒", "197699");
    if(userMapper.updateUserById(user) == 1){
        System.out.println("修改成功！");
    }

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

输出结果：

修改成功！

3.5 delete

即删除语句。

示例：

UserMapper接口：

//删除一个用户
int deleteUserById(int id);

UserMapper.xml：

<!--delete 删除语句-->
<delete id="deleteUserById" parameterType="int">
    delete from mybatis.user where id=#{id}
</delete>

测试类：

@Test
public void deleteUserById(){
    SqlSession sqlSession = MyBatisUtil.getSqlSession();
    UserMapper userMapper = sqlSession.getMapper(UserMapper.class);

    if(userMapper.deleteUserById(4)==1){
        System.out.println("删除成功！");
    }

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

输出结果：

删除成功！

3.6 传递Map类型参数

示例：

UserMapper接口：

//通过Map的方式增加一个用户
int insertUserMap(Map<String, Object> map);

UserMapper.xml：

<!--insert 插入语句-->
<insert id="insertUserMap" parameterType="map">
    <!--对象中的属性可以随意设置名称，只需与map中的key对应即可-->
    insert into mybatis.user (id, name, pwd) values (#{userId}, #{userName}, #{passWord})
</insert>

测试类：

@Test
public void insertUserMap(){
    SqlSession sqlSession = MyBatisUtil.getSqlSession();
    UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
    Map<String, Object> map = new HashMap<String, Object>();
    map.put("userId", 4);
    map.put("userName", "吕沁");
    map.put("passWord", "197812");
    if(userMapper.insertUserMap(map) == 1){
        System.out.println("插入成功！");
    }

    //增删改需要提交事务
    sqlSession.commit();

    sqlSession.close();
}

输出结果：

插入成功！

当实体类，或数据库中的表、字段，以及参数过多时，也可以使用Map来部分传参。

示例：

UserMapper接口：

//通过Map的方式修改一个用户
int updateUserByMap(Map<String, Object> map);

UserMapper.xml：

<!--update 修改语句-->
<update id="updateUserByMap" parameterType="map">
    update mybatis.user set name=#{userName} where id=#{userId}
</update>

测试类：

@Test
public void updateUserByMap(){
    SqlSession sqlSession = MyBatisUtil.getSqlSession();

    UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
    Map<String, Object> map = new HashMap<String, Object>();
    map.put("userId", 4);
    map.put("userName", "邓凌光");
    if(userMapper.updateUserByMap(map) == 1){
        System.out.println("修改成功！");
    }

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

输出结果：

修改成功！

注意事项：

• Map传递参数，直接在sql中取出key即可。
• 对象传递参数，直接在sql中取出对象的属性即可。
• 单个基本类型参数，可以直接在sql中取到。
• 多个参数时，可以使用Map，或使用注解。

3.7 模糊查询

使用模糊查询的方法有以下两种：

1. 执行 Java 代码时传递通配符 %

   示例：

   UserMapper接口：

   //模糊查询
   List<User> getUserLike(String value);
   

   UserMapper.xml：

   <!-- 模糊查询 -->
   <select id="getUserLike" resultType="com.wmwx.pojo.User">
       select * from mybatis.user where name like #{value}
   </select>
   

   测试类：

   @Test
   public void getUserLike(){
       SqlSession sqlSession = MyBatisUtil.getSqlSession();
   
       UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
   
       List<User> userList = userMapper.getUserLike("%周%");
       for (User user : userList) {
           System.out.println(user);
       }
   
       sqlSession.close();
   }
   

2. 在 sql 拼接中使用通配符

   示例：

   UserMapper接口：

   //模糊查询
   List<User> getUserLike(String value);
   

   UserMapper.xml：

   <!-- 模糊查询 -->
   <select id="getUserLike" resultType="com.wmwx.pojo.User">
       select * from mybatis.user where name like "%"#{value}"%"
   </select>
   

   测试类：

   @Test
   public void getUserLike(){
       SqlSession sqlSession = MyBatisUtil.getSqlSession();
   
       UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
   
       List<User> userList = userMapper.getUserLike("周");
       for (User user : userList) {
           System.out.println(user);
       }
   
       sqlSession.close();
   }
   

4. 配置解析

4.1 核心配置文件

properties（属性）
settings（设置）
typeAliases（类型别名）
typeHandlers（类型处理器）
objectFactory（对象工厂）
plugins（插件）
environments（环境配置）
environment（环境变量）
transactionManager（事务管理器）
dataSource（数据源）
databaseIdProvider（数据库厂商标识）
mappers（映射器）

4.2 environments（环境配置）

MyBatis 可以配置成适应多种环境，但每个 SqlSessionFactory 实例只能选择一种环境。

MyBatis 默认的事务管理器是 JDBC，默认使用连接池 POOLED。

4.3 properties（属性）

我们可以通过 properties 属性来实现引用配置文件。

这些属性可以在外部进行配置，并可以进行动态替换。既可以在典型的 Java 属性文件中配置这些属性，也可以在 properties 元素的子元素中设置。

1. 编写配置文件：

   db.properties：

   driver=com.mysql.cj.jdbc.Driver
   url=jdbc:mysql://localhost:3306/mybatis?useUnicode=true;characterEncoding=utf8;serverTimezone=GMT"
   username=root
   password=123456
   

2. 在核心配置文件中引入

   mybatis-config.xml：

   <!-- 引入外部配置文件 -->
   <properties resource="db.properties" />
   

3. 修改 property 键值对

   <property name="driver" value="${driver}"/>
   <property name="url" value="${url}"/>
   <property name="username" value="${username}"/>
   <property name="password" value="${password}"/>
   

注意：

• 可以直接引入外部配置文件，也可以在 properties 中增加一些属性配置
• 如果一个属性在不只一个地方进行了配置，那么，MyBatis 将按照下面的顺序来加载：
  • 首先读取在 properties 元素体内指定的属性。
  • 然后根据 properties 元素中的 resource 属性读取类路径下属性文件，或根据 url 属性指定的路径读取属性文件，并覆盖之前读取过的同名属性。
  • 最后读取作为方法参数传递的属性，并覆盖之前读取过的同名属性。

4.4 typeAliases（类型别名）

类型别名可为 Java 类型设置一个缩写名字。 它仅用于 XML 配置，意在降低冗余的全限定类名书写。

使用别名可以采用以下两种方式：

1. 使用 typeAlias 为具体的类指定别名

   示例：

   mybatis-config.xml：

   <!-- 可以给实体类起别名 -->
   <typeAliases>
       <typeAlias type="com.wmwx.pojo.User" alias="User" />
   </typeAliases>
   

2. 指定一个包名，MyBatis 会在包名下面搜索需要的 Java Bean

   示例：

   mybatis-config.xml：

   <!-- 可以指定包，MyBatis 会在包名下面搜索需要的 Java Bean -->
   <typeAliases>
       <package name="com.wmwx.pojo" />
   </typeAliases>
   

注意：

• 实体类较少时，推荐第一种方案；实体类较多时，推荐第二种方案。

• 使用第一种方式可以起自定义别名，使用第二种方式只能用类名。

• 使用第二种方式时，如果一定要起自定义别名，可在实体类上加注解。

  示例：

  User.java：

  //实体类
  @Alias("theUser")
  public class User {}
  

4.5 settings（设置）

设置会改变 MyBatis 的运行时行为。以下列举几个重要的设置：

设置名	描述	有效值	默认值
cacheEnabled	全局性地开启或关闭所有映射器配置文件中已配置的任何缓存。	true | false	true
lazyLoadingEnabled	延迟加载的全局开关。当开启时，所有关联对象都会延迟加载。 特定关联关系中可通过设置 fetchType 属性来覆盖该项的开关状态。	true | false	false
mapUnderscoreToCamelCase	是否开启驼峰命名自动映射，即从经典数据库列名 A_COLUMN 映射到经典 Java 属性名 aColumn。	true | false	False
logImpl	指定 MyBatis 所用日志的具体实现，未指定时将自动查找。	SLF4J | LOG4J | LOG4J2 | JDK_LOGGING | COMMONS_LOGGING | STDOUT_LOGGING | NO_LOGGING	未设置

4.6 其他配置

• typeHandlers（类型处理器）
• objectFactory（对象工厂）
• plugins（插件）
  • mybatis-generator-core
  • mybatis-plus
  • 通用 mapper

4.7 mappers（映射器）

MapperRegistry：注册并绑定 Mapper 文件。

• 方式一：使用相对于类路径的资源引用（推荐使用）

  示例：

  <!-- 每一个Mapper文件都需要在mybatis-config.xml中注册 -->
  <mappers>
      <mapper resource="com/wmwx/dao/UserMapper.xml" />
  </mappers>
  

• 方式二：使用映射器接口实现类的完全限定类名

  示例：

  <!-- 接口和配置文件必须同名，且必须在同一个包下 -->
  <mappers>
      <mapper class="com.wmwx.dao.UserMapper" />
  </mappers>
  

• 方式三：将包内的映射器接口实现全部注册为映射器

  示例：

  <!-- 接口和配置文件必须同名，且必须在同一个包下 -->
  <mappers>
      <mapper package="com.wmwx.dao" />
  </mappers>
  

注意：方式二和方式三中的 Mapper 接口和 Mapper 配置文件必须同名且在同一包下。

4.8 生命周期

生命周期是至关重要的，因为错误的使用会导致非常严重的并发问题。

SqlSessionFactoryBuilder：

• 这个类可以被实例化、使用和丢弃
• 一旦创建了 SqlSessionFactory，就不再需要它了
• 实例的最佳作用域是方法作用域（局部变量）

SqlSessionFactory：

• 可以想象为数据库连接池
• 一旦被创建就应该在应用的运行期间一直存在，没有任何理由丢弃它或重新创建另一个实例
• 最佳作用域是应用作用域，最简单的方式就是使用单例模式或者静态单例模式

SqlSession：

• 可以想象为连接到连接池的一个请求
• 实例不是线程安全的，因此是不能被共享的，所以它的最佳的作用域是请求或方法作用域
• 使用完后需立即关闭，否则资源会被占用

5. 解决属性名和字段名不一致的问题

5.1 遇到的问题

示例：

数据库字段名：id、name、pwd

User.java：

//实体类
public class User {
    private int id;
    private String name;
    private String password;	//与字段名不同
}

UserMapper.java：

public interface UserMapper {
    //根据id查询用户
    User getUserById(int id);
}

UserMapper.xml：

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

UserMapperTest.java：

@Test
public void getUserById(){
    SqlSession sqlSession = MyBatisUtil.getSqlSession();
    UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
    User user = userMapper.getUserById(2);
    System.out.println(user);
    sqlSession.close();
}

输出结果：

User{id=2, name='周松雅', password='null'}		//password 输出为 null

解决方法：

1. 起别名

   示例：

   UserMapper.xml：

   <select id="getUserById" resultType="User" parameterType="int">
       select id,name,pwd as password from mybatis.user where id = #{id}
   </select>
   

   输出结果：

   User{id=2, name='周松雅', password='654321'}
   

2. 使用 ResultMap

5.2 ResultMap

ResultMap 为结果集映射。

示例：

数据库：id	name	pwd
实体类：id	name	password

UserMapper.xml：

<!-- 结果集映射 -->
<resultMap id="UserMap" type="User">
    <!-- column为数据库中的字段，property为实体类中的属性 -->
    <result column="id" property="id" />
    <result column="name" property="name" />
    <result column="pwd" property="password" />
</resultMap>
<select id="getUserById" resultMap="UserMap" parameterType="int">
    select * from mybatis.user where id = #{id}
</select>

• ResultMap 元素是 MyBatis 中最重要最强大的元素。

• ResultMap 的设计思想是，对简单的语句做到零配置，对于复杂一点的语句，只需要描述语句之间的关系就行了。

• ResultMap 的优秀之处——完全可以不用显式地配置它们。

  示例：

  UserMapper.xml：

  <!-- 结果集映射 -->
  <resultMap id="UserMap" type="User">
      <!-- column为数据库中的字段，property为实体类中的属性 -->
      <!-- 只有pwd不同，就只显式地映射pwd即可 -->
      <result column="pwd" property="password" />
  </resultMap>
  <select id="getUserById" resultMap="UserMap" parameterType="int">
      select * from mybatis.user where id = #{id}
  </select>
  

• “如果这个世界总是这么简单就好了。”

6. 日志

6.1 日志工厂

如果一个数据库操作出现了异常，我们需要排错，此时日志就是最好的助手。

使用日志需要配置核心配置文件中的 setting 标签中的 logImpl。

• SLF4J
• LOG4J（需掌握）
• LOG4J2
• JDK_LOGGING
• COMMONS_LOGGING
• STDOUT_LOGGING（需掌握）
• NO_LOGGING

6.2 STDOUT_LOGGING

STDOUT_LOGGING：标准日志工厂

示例：

mybatis-config.xml：

<!-- 设置标准日志工厂 -->
<settings>
    <setting name="logImpl" value="STDOUT_LOGGING"/>
</settings>

输出结果（核心部分截取）：

Opening JDBC Connection
Created connection 2054757222.
Setting autocommit to false on JDBC Connection [com.mysql.cj.jdbc.ConnectionImpl@7a791b66]
==>  Preparing: select * from mybatis.user where id = ?
==> Parameters: 2(Integer)
<==    Columns: id, name, pwd
<==        Row: 2, 周松雅, 654321
<==      Total: 1
User{id=2, name='周松雅', password='654321'}
Resetting autocommit to true on JDBC Connection [com.mysql.cj.jdbc.ConnectionImpl@7a791b66]
Closing JDBC Connection [com.mysql.cj.jdbc.ConnectionImpl@7a791b66]
Returned connection 2054757222 to pool.

6.3 LOG4J

• Log4j是Apache的一个开源项目。
• 通过使用Log4j，我们可以控制日志信息输送的目的地是控制台、文件、GUI组件。
• 我们也可以控制每一条日志的输出格式。
• 通过定义每一条日志信息的级别，我们能够更加细致地控制日志的生成过程。
• 可以通过一个配置文件来灵活地进行配置，而不需要修改应用的代码。

环境配置：

1. 导入 LOG4J 的包

   <!-- https://mvnrepository.com/artifact/log4j/log4j -->
   <dependency>
       <groupId>log4j</groupId>
       <artifactId>log4j</artifactId>
       <version>1.2.17</version>
   </dependency>
   

2. 编写配置文件 log4j.properties

   #将等级为DEBUG的日志信息输出到console和file这两个目的地，console和file的定义在下面的代码
   log4j.rootLogger=DEBUG,console,file
   
   #控制台输出的相关设置
   log4j.appender.console = org.apache.log4j.ConsoleAppender
   log4j.appender.console.Target = System.out
   log4j.appender.console.Threshold=DEBUG
   log4j.appender.console.layout = org.apache.log4j.PatternLayout
   log4j.appender.console.layout.ConversionPattern=[%c]-%m%n
   
   #文件输出的相关设置
   log4j.appender.file = org.apache.log4j.RollingFileAppender
   log4j.appender.file.File=./log/wmwx.log
   log4j.appender.file.MaxFileSize=10mb
   log4j.appender.file.Threshold=DEBUG
   log4j.appender.file.layout=org.apache.log4j.PatternLayout
   log4j.appender.file.layout.ConversionPattern=[%p][%d{yy-MM-dd}][%c]%m%n
   
   #日志输出级别
   log4j.logger.org.mybatis=DEBUG
   log4j.logger.java.sql=DEBUG
   log4j.logger.java.sql.Statement=DEBUG
   log4j.logger.java.sql.ResultSet=DEBUG
   log4j.logger.java.sql.PreparedStatement=DEBUG
   

3. 在核心配置文件中配置日志工厂

   <!-- 设置日志工厂 -->
   <settings>
       <setting name="logImpl" value="LOG4J"/>
   </settings>
   

使用步骤：

1. 在需要使用 log4j 的类中导入包

   import org.apache.log4j.Logger;
   

2. 在类中创建静态的日志对象，参数为当前类的 class

   static Logger logger = Logger.getLogger(UserMapperTest.class);
   

3. 日志级别

   logger.info("info:进入了 TestLog4j() 方法");
   logger.debug("debug:进入了 TestLog4j() 方法");
   logger.error("error:进入了 TestLog4j() 方法");
   

7. 分页

思考：为什么要分页？

• 减少数据处理量

7.1 使用 limit 进行分页（推荐）

语法：

select * from tableName limit startIndex, pageSize;	/*查询范围：[startIndex, startIndex+pageSize-1]*/
select * from tableName limit pageSize;	/*查询范围：[0, pageSize-1]*/

实现步骤：

1. 接口

   UserMapper.java：

   //分页查询
   List<User> getUserByLimit(Map<String, Integer> map);
   

2. 配置文件

   UserMapper.xml：

   <!-- 分页查询 -->
   <select id="getUserByLimit" resultMap="UserMap" parameterType="map">
       select * from mybatis.user limit #{startIndex}, #{pageSize}
   </select>
   

3. 测试类

   UserMapperTest.java：

   @Test
   public void getUserByLimit(){
       SqlSession sqlSession = MyBatisUtil.getSqlSession();
   
       UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
   
       Map<String, Integer> map = new HashMap<String, Integer>();
       map.put("startIndex", 1);
       map.put("pageSize", 2);
       List<User> userList = userMapper.getUserByLimit(map);
       for (User user : userList) {
           System.out.println(user);
       }
       sqlSession.close();
   }
   

输出结果：

User{id=2, name='周松雅', password='654321'}
User{id=3, name='沈琉灵', password='101010'}

7.2 使用 RowBounds 分页（不推荐）

语法：

/*查询范围：[startIndex, startIndex+pageSize-1]*/
RowBounds rowBounds = new RowBounds(startIndex, pageSize);

实现步骤：

1. 接口

   UserMapper.java：

   //分页查询2：RowBounds 方式
   List<User> getUserByRowBounds();
   

2. 配置文件

   UserMapper.xml：

   <!-- 分页查询2：RowBounds 方式 -->
   <select id="getUserByRowBounds" resultMap="UserMap">
       select * from mybatis.user
   </select>
   

3. 测试类

   UserMapperTest.java：

   @Test
   public void getUserByRowBounds(){
       SqlSession sqlSession = MyBatisUtil.getSqlSession();
   
       //在java层通过RowBounds实现分页
       RowBounds rowBounds = new RowBounds(1, 2);
       List<User> userList = sqlSession.selectList("com.wmwx.dao.UserMapper.getUserByRowBounds", null, rowBounds);
   
       for (User user : userList) {
           System.out.println(user);
       }
       sqlSession.close();
   }
   

输出结果：

User{id=2, name='周松雅', password='654321'}
User{id=3, name='沈琉灵', password='101010'}

7.3 使用 PageHelper 分页（不推荐）

官网地址：PageHelper官网

官方文档：PageHelper官方文档

8. 注解

• 注解在接口上实现
• 注解的本质是通过反射机制实现的，底层是动态代理
• 使用注解来映射简单语句会使代码显得更加简洁
• 对于稍微复杂一点的语句，注解不仅力不从心，反而会让本就复杂的 SQL 语句更加混乱不堪

8.1 面向接口编程

使用步骤：

1. 接口

   UserMapper.java：

   @Select("select * from user")	//使用注解
   List<User> getUserList();
   

2. 核心配置文件

   mybatis-config.xml：

   <!-- 绑定接口 -->
   <mappers>
       <mapper class="com.wmwx.dao.UserMapper" />
   </mappers>
   

3. 测试类

   UserMapperTest.java：

   @Test
   public void getUserList(){
       SqlSession sqlSession = MyBatisUtil.getSqlSession();
       //底层主要应用反射
       UserMapper mapper = sqlSession.getMapper(UserMapper.class);
       List<User> userList = mapper.getUserList();
       for (User user : userList) {
           System.out.println(user);
       }
       sqlSession.close();
   }
   

输出结果：

User{id=1, name='刘季恒', password='null'}
User{id=2, name='周松雅', password='null'}
User{id=3, name='沈琉灵', password='null'}
User{id=4, name='邓凌光', password='null'}
User{id=5, name='周龙', password='null'}

8.2 CRUD

可以在工具类创建的时候实现自动提交事务：

MyBatisUtil.java：

public static SqlSession getSqlSession(){
    //设置自动提交事务为：真
    return sqlSessionFactory.openSession(true);
}

8.2.1 Select

接口：

UserMapper.java：

//方法存在多个参数时，所有的参数前面必须加上 @Param 注解
@Select("select * from user where id=#{id} and name=#{name}")
User getUserByIdAndName(@Param("id") int id, @Param("name") String name);

测试类：

UserMapperTest.java：

@Test
public void getUserByIdAndName(){
    SqlSession sqlSession = MyBatisUtil.getSqlSession();
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    User user = mapper.getUserByIdAndName(1, "刘季恒");
    System.out.println(user);
    sqlSession.close();
}

8.2.2 Insert

接口：

UserMapper.java：

@Insert("insert into user(id, name, pwd) values(#{id}, #{name}, #{password})")
int addUser(User user);

测试类：

UserMapperTest.java：

@Test
public void addUser(){
    SqlSession sqlSession = MyBatisUtil.getSqlSession();
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    User user = new User(6, "朱志", "abcdef");
    int n = mapper.addUser(user);
    System.out.println(n);
}

8.2.3 Update

接口：

UserMapper.java：

@Update("update user set pwd=#{password} where id=#{id}")
int updateUser(User user);

测试类：

UserMapperTest.java：

@Test
public void updateUser(){
    SqlSession sqlSession = MyBatisUtil.getSqlSession();
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    User user = new User(6, "朱志", "010101");
    int n = mapper.updateUser(user);
    System.out.println(n);
}

8.2.4 Delete

接口：

UserMapper.java：

@Delete("delete from user where id=#{uid}")
int deleteUser(@Param("uid") int id);

测试类：

UserMapperTest.java：

@Test
public void deleteUser(){
    SqlSession sqlSession = MyBatisUtil.getSqlSession();
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    int n = mapper.deleteUser(6);
    System.out.println(n);
}

8.3 注意事项

1. 接口必须要在核心配置文件中绑定
2. 多个参数时，基本类型需要加 @Param() 注解
3. sql 中引用的是 @Param() 中的属性名
4. ${} 会被 sql注入 ，但 **#{} **不会

9. Lombok

使用步骤：

1. 在 IDEA 中安装 Lombok 插件

2. 导入 Lombok 的依赖

   <!-- lombok -->
   <dependency>
       <groupId>org.projectlombok</groupId>
       <artifactId>lombok</artifactId>
       <version>1.18.20</version>
   </dependency>
   

3. 在对应位置添加注解

   示例：

   User.java：

   package com.wmwx.pojo;
   
   import lombok.AllArgsConstructor;
   import lombok.Data;
   import lombok.NoArgsConstructor;
   
   //实体类
   @Data                   //getter & setter
   @AllArgsConstructor     //有参构造
   @NoArgsConstructor      //无参构造
   public class User {
       private int id;
       private String name;
       private String password;
   }
   

10. 关联（Association）

10.1 测试环境搭建

步骤如下：

1. 建表

   sql 文件：

   CREATE TABLE `teacher` (
     `id` INT(10) NOT NULL,
     `name` VARCHAR(30) DEFAULT NULL,
     PRIMARY KEY (`id`)
   ) ENGINE=INNODB DEFAULT CHARSET=utf8;
   
   INSERT INTO teacher(`id`, `name`) VALUES (1, '邓玉'); 
   
   CREATE TABLE `student` (
     `id` INT(10) NOT NULL,
     `name` VARCHAR(30) DEFAULT NULL,
     `tid` INT(10) DEFAULT NULL,
     PRIMARY KEY (`id`),
     KEY `fktid` (`tid`),
     CONSTRAINT `fktid` FOREIGN KEY (`tid`) REFERENCES `teacher` (`id`)
   ) ENGINE=INNODB DEFAULT CHARSET=utf8;
   
   INSERT INTO `student` (`id`, `name`, `tid`) VALUES (1, '凌光', 1); 
   INSERT INTO `student` (`id`, `name`, `tid`) VALUES (2, '启锋', 1); 
   INSERT INTO `student` (`id`, `name`, `tid`) VALUES (3, '于跃', 1); 
   INSERT INTO `student` (`id`, `name`, `tid`) VALUES (4, '明琦', 1); 
   INSERT INTO `student` (`id`, `name`, `tid`) VALUES (5, '墨阳', 1);
   

2. 导入 lombok

   <!-- lombok -->
   <dependency>
       <groupId>org.projectlombok</groupId>
       <artifactId>lombok</artifactId>
       <version>1.18.20</version>
   </dependency>
   

3. 建立实体类

   Student.java：

   package com.wmwx.pojo;
   
   import lombok.Data;
   
   @Data
   public class Student {
       private int id;
       private String name;
       private Teacher teacher;
   }
   

   Teacher.java：

   package com.wmwx.pojo;
   
   import lombok.Data;
   
   @Data
   public class Teacher {
       private int id;
       private String name;
   }
   

4. 建立 Mapper 接口（StudentMapper.java、TeacherMapper.java）

5. 建立 Mapper 配置文件（StudentMapper.xml、TeacherMapper.xml）

6. 在核心配置文件中绑定 Mapper 接口

   mybatis-config.xml：

   <!-- 绑定接口 -->
   <mappers>
       <mapper class="com.wmwx.dao.StudentMapper" />
       <mapper class="com.wmwx.dao.TeacherMapper" />
   </mappers>
   

10.2 多对一查询

10.2.1 按查询嵌套方式处理

示例：

StudentMapper.java：

//查询所有的学生信息及老师信息
//子查询方式
List<Student> getStudentList1();

StudentMapper.xml：

<!--
        思路：
        1. 查询所有的学生信息
        2. 根据查询出学生的tid，对应寻找老师
    -->
<!-- 方式一：子查询 -->
<select id="getStudentList1" resultMap="StudentWithTeacher1">
    select * from student
</select>
<resultMap id="StudentWithTeacher1" type="Student">
    <result property="id" column="id" />
    <result property="name" column="name" />
    <!-- 复杂的属性需要单独处理 -->
    <association property="teacher" column="tid" javaType="Teacher" select="getTeacherById"/>
</resultMap>
<select id="getTeacherById" resultType="Teacher">
    select * from teacher where id=#{id}
</select>

测试类：

@Test
public void getStudentList1(){
    SqlSession sqlSession = MyBatisUtil.getSqlSession();
    StudentMapper mapper = sqlSession.getMapper(StudentMapper.class);
    List<Student> studentList = mapper.getStudentList1();
    for (Student student : studentList) {
        System.out.println(student);
    }
    sqlSession.close();
}

查询结果：

Student(id=1, name=凌光, teacher=Teacher(id=1, name=邓玉))
Student(id=2, name=启锋, teacher=Teacher(id=1, name=邓玉))
Student(id=3, name=明琦, teacher=Teacher(id=1, name=邓玉))
Student(id=4, name=于跃, teacher=Teacher(id=1, name=邓玉))
Student(id=5, name=墨阳, teacher=Teacher(id=1, name=邓玉))

10.2.2 按结果嵌套方式处理

示例：

StudentMapper.java：

//查询所有的学生信息及老师信息
//结果查询方式
List<Student> getStudentList2();

StudentMapper.xml：

<!--
        思路：
        1. 查询所有的学生信息
        2. 根据查询出学生的tid，对应寻找老师
    -->
<!-- 方式二：按照结果嵌套处理 -->
<resultMap id="StudentWithTeacher2" type="Student">
    <result property="id" column="sid" />
    <result property="name" column="sname" />
    <association property="teacher" javaType="Teacher">
        <result property="name" column="tname" />
    </association>
</resultMap>
<select id="getStudentList2" resultMap="StudentWithTeacher2">
    select s.id sid, s.name sname, t.name tname
    from student s, teacher t
    where s.tid = t.id
</select>

测试类：

@Test
public void getStudentList2(){
    SqlSession sqlSession = MyBatisUtil.getSqlSession();
    StudentMapper mapper = sqlSession.getMapper(StudentMapper.class);
    List<Student> studentList = mapper.getStudentList2();
    for (Student student : studentList) {
        System.out.println(student);
    }
    sqlSession.close();
}

输出结果：

Student(id=1, name=凌光, teacher=Teacher(id=0, name=邓玉))
Student(id=2, name=启锋, teacher=Teacher(id=0, name=邓玉))
Student(id=3, name=明琦, teacher=Teacher(id=0, name=邓玉))
Student(id=4, name=于跃, teacher=Teacher(id=0, name=邓玉))
Student(id=5, name=墨阳, teacher=Teacher(id=0, name=邓玉))

11. 集合（Collection）

11.1 测试环境搭建

建立实体类：

Student.java：

package com.wmwx.pojo;
import lombok.Data;
@Data
public class Student {
    private int id;
    private String name;
    private int tid;
}

Teacher.java：

package com.wmwx.pojo;
import lombok.Data;
import java.util.List;
@Data
public class Teacher {
    private int id;
    private String name;
    //一个老师拥有多个学生
    private List<Student> studentList;
}

11.2 一对多查询

11.2.1 按查询嵌套方式处理

示例：

TeacherMapper.java：

//根据id获取教师信息及对应的学生列表
Teacher getTeacherById2(@Param("tid") int id);

TeacherMapper.xml：

<!-- 按照子查询的方式 -->
<select id="getStudentByTeacherId" resultType="Student">
    select * from student where tid=#{tid}
</select>
<resultMap id="TeacherWithStudent2" type="Teacher">
    <result property="id" column="id" />
    <result property="name" column="name" />
    <collection property="studentList" javaType="ArrayList" ofType="Student" select="getStudentByTeacherId" column="id"/>
</resultMap>
<select id="getTeacherById2" resultMap="TeacherWithStudent2">
    select * from teacher where id=#{tid}
</select>

测试类：

@Test
public void getTeacherById2(){
    SqlSession sqlSession = MyBatisUtil.getSqlSession();
    TeacherMapper mapper = sqlSession.getMapper(TeacherMapper.class);
    Teacher teacher = mapper.getTeacherById2(1);
    System.out.println(teacher);
    sqlSession.close();
}

输出结果：

Teacher(id=1, name=邓玉, studentList=[Student(id=1, name=凌光, tid=1), Student(id=2, name=启锋, tid=1), Student(id=3, name=明琦, tid=1), Student(id=4, name=于跃, tid=1), Student(id=5, name=墨阳, tid=1)])

11.2.2 按结果嵌套方式处理

示例：

TeacherMapper.java：

//根据id获取教师信息及对应的学生列表
Teacher getTeacherById1(@Param("tid") int id);

TeacherMapper.xml：

<!-- 按照结果嵌套查询 -->
<resultMap id="TeacherWithStudent1" type="Teacher">
    <result property="id" column="tid" />
    <result property="name" column="tname" />
    <!-- 对于泛型 不使用javaType 改用ofType -->
    <collection property="studentList" ofType="Student">
        <result property="id" column="sid" />
        <result property="name" column="sname" />
        <result property="tid" column="tid" />
    </collection>
</resultMap>
<select id="getTeacherById1" resultMap="TeacherWithStudent1">
    select s.id sid, s.name sname, t.id tid, t.name tname
    from student s, teacher t
    where s.tid=t.id and t.id=#{tid}
</select>

测试类：

@Test
public void getTeacherById1(){
    SqlSession sqlSession = MyBatisUtil.getSqlSession();
    TeacherMapper mapper = sqlSession.getMapper(TeacherMapper.class);
    Teacher teacher = mapper.getTeacherById1(1);
    System.out.println(teacher);
    sqlSession.close();
}

输出结果：

Teacher(id=1, name=邓玉, studentList=[Student(id=1, name=凌光, tid=1), Student(id=2, name=启锋, tid=1), Student(id=3, name=明琦, tid=1), Student(id=4, name=于跃, tid=1), Student(id=5, name=墨阳, tid=1)])

12. 动态 SQL

动态 SQL：根据不同的条件，拼接不同的 SQL 语句。

动态 SQL 的标签如下：

• if
• choose (when, otherwise)
• trim (where, set)
• foreach

12.1 环境搭建

1. 编写 SQL 文件

   DROP TABLE IF EXISTS `blog`;
   
   CREATE TABLE `blog` (
     `id` varchar(50) NOT NULL COMMENT '博客id',
     `title` varchar(100) NOT NULL COMMENT '博客标题',
     `author` varchar(30) NOT NULL COMMENT '博客作者',
     `create_time` datetime NOT NULL COMMENT '创建时间',
     `views` int NOT NULL COMMENT '浏览量'
   ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
   
   INSERT INTO `blog` VALUES ('31a2f85f535344a1be14e1f4cc008786', 'Mybatis', '惟妙惟霄', '2021-05-19 00:58:16', '3000');
   INSERT INTO `blog` VALUES ('fed236c8d51f4fc983fe036f42365824', 'Java', '惟妙惟霄', '2021-05-19 00:58:16', '1000');
   INSERT INTO `blog` VALUES ('8826283b27624662872cf08c3e85861f', 'Spring', '妙霄', '2021-05-19 00:58:16', '9000');
   INSERT INTO `blog` VALUES ('89094f71bd0a48fdbd14d5c854e8ddbe', '分布式', '妙霄', '2021-05-19 00:58:16', '8000');
   

2. 编写核心配置文件

   mybatis-config.xml：

   <?xml version="1.0" encoding="UTF8" ?>
   <!DOCTYPE configuration
           PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
           "http://mybatis.org/dtd/mybatis-3-config.dtd">
   
   <!-- 核心配置文件 -->
   <configuration>
   
       <!-- 引入外部配置文件 -->
       <properties resource="db.properties" />
   
       <!-- 设置日志工厂 -->
       <settings>
           <setting name="logImpl" value="STDOUT_LOGGING"/>
           <!-- 自动转换下划线为驼峰命名 -->
           <setting name="mapUnderscoreToCamelCase" value="true"/>
       </settings>
   
       <!-- 别名 -->
       <typeAliases>
           <typeAlias type="com.wmwx.pojo.Blog" alias="Blog" />
       </typeAliases>
   
       <environments default="development">
           <environment id="development">
               <transactionManager type="JDBC"/>
               <dataSource type="POOLED">
                   <property name="driver" value="${driver}"/>
                   <property name="url" value="${url}"/>
                   <property name="username" value="${username}"/>
                   <property name="password" value="${password}"/>
               </dataSource>
           </environment>
       </environments>
   
       <!-- 绑定接口 -->
       <mappers>
           <mapper class="com.wmwx.dao.BlogMapper" />
       </mappers>
   
   </configuration>
   

3. 编写实体类

   Blog.java：

   package com.wmwx.pojo;
   
   import lombok.Data;
   
   import java.util.Date;
   
   @Data
   public class Blog {
       private String id;
       private String title;
       private String author;
       private Date createTime;
       private int views;
   }
   

4. 编写 Mapper 接口

   BlogMapper.java：

   package com.wmwx.dao;
   
   import com.wmwx.pojo.Blog;
   
   public interface BlogMapper {
       //插入数据
       int addBlog(Blog blog);
   }
   

5. 编写 Mapper.xml

   BlogMapper.xml：

   <?xml version="1.0" encoding="UTF8" ?>
   <!DOCTYPE mapper
           PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
           "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
   
   <mapper namespace="com.wmwx.dao.BlogMapper">
   
       <insert id="addBlog" parameterType="Blog">
           insert into blog values(#{id}, #{title}, #{author}, #{createTime}, #{views})
       </insert>
   
   </mapper>
   

6. 编写工具类

   IDUtil.java：

   package com.wmwx.utils;
   
   import org.junit.Test;
   
   import java.util.UUID;
   
   public class IDUtil {
       public static String getId(){
           return UUID.randomUUID().toString().replaceAll("-", "");
       }
   
       @Test
       public void testRandomId(){
           System.out.println(IDUtil.getId());
       }
   }
   

7. 编写测试类

   BlogTest.java：

   package com.wmwx.dao;
   
   import com.wmwx.pojo.Blog;
   import com.wmwx.utils.IDUtil;
   import com.wmwx.utils.MyBatisUtil;
   import org.apache.ibatis.session.SqlSession;
   import org.junit.Test;
   
   import java.util.Date;
   
   public class BlogTest {
       @Test
       public void addInitBlog(){
           SqlSession sqlSession = MyBatisUtil.getSqlSession();
           BlogMapper mapper = sqlSession.getMapper(BlogMapper.class);
           Blog blog = new Blog();
           blog.setId(IDUtil.getId());
           blog.setTitle("Mybatis");
           blog.setAuthor("惟妙惟霄");
           blog.setCreateTime(new Date());
           blog.setViews(9999);
   
           mapper.addBlog(blog);
   
           blog.setId(IDUtil.getId());
           blog.setTitle("Java");
           mapper.addBlog(blog);
   
           blog.setId(IDUtil.getId());
           blog.setTitle("Spring");
           mapper.addBlog(blog);
   
           blog.setId(IDUtil.getId());
           blog.setTitle("分布式");
           mapper.addBlog(blog);
   
           sqlSession.close();
       }
   }
   

12.2 IF

示例：

BlogMapper.java：

//借用IF语句查询博客
List<Blog> queryBlogWithIF(Map<String, Object> map);

BlogMapper.xml：

<select id="queryBlogWithIF" parameterType="map" resultType="Blog">
    select * from blog where 1=1
    <if test="title != null">
        and title=#{title}
    </if>
    <if test="author != null">
        and author=#{author}
    </if>
</select>

测试类：

@Test
public void queryBlogWithIF(){
    SqlSession sqlSession = MyBatisUtil.getSqlSession();
    BlogMapper mapper = sqlSession.getMapper(BlogMapper.class);
    HashMap<String, Object> map = new HashMap<String, Object>();
    //第一次输出：不加参数
    List<Blog> blogs = mapper.queryBlogWithIF(map);
    for (Blog blog : blogs) {
        System.out.println(blog);
    }
    //第二次输出：加一个参数
    map.put("author", "惟妙惟霄");
    blogs = mapper.queryBlogWithIF(map);
    for (Blog blog : blogs) {
        System.out.println(blog);
    }
    //第三次输出：加两个参数
    map.put("title", "Java");
    blogs = mapper.queryBlogWithIF(map);
    for (Blog blog : blogs) {
        System.out.println(blog);
    }

    sqlSession.close();
}

输出结果：

Blog(id=31a2f85f535344a1be14e1f4cc008786, title=Mybatis, author=惟妙惟霄, createTime=Wed May 19 00:58:16 CST 2021, views=3000)
Blog(id=fed236c8d51f4fc983fe036f42365824, title=Java, author=惟妙惟霄, createTime=Wed May 19 00:58:16 CST 2021, views=1000)
Blog(id=8826283b27624662872cf08c3e85861f, title=Spring, author=妙霄, createTime=Wed May 19 00:58:16 CST 2021, views=9000)
Blog(id=89094f71bd0a48fdbd14d5c854e8ddbe, title=分布式, author=妙霄, createTime=Wed May 19 00:58:16 CST 2021, views=8000)

Blog(id=31a2f85f535344a1be14e1f4cc008786, title=Mybatis, author=惟妙惟霄, createTime=Wed May 19 00:58:16 CST 2021, views=3000)
Blog(id=fed236c8d51f4fc983fe036f42365824, title=Java, author=惟妙惟霄, createTime=Wed May 19 00:58:16 CST 2021, views=1000)

Blog(id=fed236c8d51f4fc983fe036f42365824, title=Java, author=惟妙惟霄, createTime=Wed May 19 00:58:16 CST 2021, views=1000)

12.3 WHERE

where 元素只会在子元素返回任何内容的情况下才插入 WHERE 子句。而且，若子句的开头为 AND 或 OR，where 元素也会将它们去除。

示例：

BlogMapper.java：

//使用WHERE查询博客
List<Blog> queryBlogWithWHERE(Map<String, Object> map);

BlogMapper.xml：

<select id="queryBlogWithWHERE" parameterType="map" resultType="Blog">
    select * from blog
    <where>
        <if test="title != null">
            title=#{title}
        </if>
        <if test="author != null">
            and author=#{author}
        </if>
    </where>
</select>

测试类：

@Test
public void queryBlogWithWHERE(){
    SqlSession sqlSession = MyBatisUtil.getSqlSession();
    BlogMapper mapper = sqlSession.getMapper(BlogMapper.class);
    HashMap<String, Object> map = new HashMap<String, Object>();
    //不加参数
    List<Blog> blogs = mapper.queryBlogWithWHERE(map);
    for (Blog blog : blogs) {
        System.out.println(blog);
    }
    //加一个参数
    map.put("author", "惟妙惟霄");
    blogs = mapper.queryBlogWithWHERE(map);
    for (Blog blog : blogs) {
        System.out.println(blog);
    }
    //加第二个参数
    map.put("title", "Java");
    blogs = mapper.queryBlogWithWHERE(map);
    for (Blog blog : blogs) {
        System.out.println(blog);
    }

    sqlSession.close();
}

输出结果：

Blog(id=31a2f85f535344a1be14e1f4cc008786, title=Mybatis, author=惟妙惟霄, createTime=Wed May 19 00:58:16 CST 2021, views=3000)
Blog(id=fed236c8d51f4fc983fe036f42365824, title=Java, author=惟妙惟霄, createTime=Wed May 19 00:58:16 CST 2021, views=1000)
Blog(id=8826283b27624662872cf08c3e85861f, title=Spring, author=妙霄, createTime=Wed May 19 00:58:16 CST 2021, views=9000)
Blog(id=89094f71bd0a48fdbd14d5c854e8ddbe, title=分布式, author=妙霄, createTime=Wed May 19 00:58:16 CST 2021, views=8000)

Blog(id=31a2f85f535344a1be14e1f4cc008786, title=Mybatis, author=惟妙惟霄, createTime=Wed May 19 00:58:16 CST 2021, views=3000)
Blog(id=fed236c8d51f4fc983fe036f42365824, title=Java, author=惟妙惟霄, createTime=Wed May 19 00:58:16 CST 2021, views=1000)

Blog(id=fed236c8d51f4fc983fe036f42365824, title=Java, author=惟妙惟霄, createTime=Wed May 19 00:58:16 CST 2021, views=1000)

12.4 CHOOSE

有时候，我们不想使用所有的条件，而只是想从多个条件中选择一个使用。针对这种情况，MyBatis 提供了 choose 元素，它有点像 Java 中的 switch 语句。

示例：

BlogMapper.java：

//使用CHOOSE查询博客
List<Blog> queryBlogWithCHOOSE(Map<String, Object> map);

BlogMapper.xml：

<select id="queryBlogWithCHOOSE" parameterType="map" resultType="Blog">
    select * from blog
    <where>
        <choose>
            <when test="title != null">
                and title=#{title}
            </when>
            <when test="author != null">
                and author=#{author}
            </when>
            <otherwise>
                and views=#{views}
            </otherwise>
        </choose>
    </where>
</select>

测试类：

@Test
public void queryBlogWithCHOOSE(){
    SqlSession sqlSession = MyBatisUtil.getSqlSession();
    BlogMapper mapper = sqlSession.getMapper(BlogMapper.class);
    HashMap<String, Object> map = new HashMap<String, Object>();
    //不加参数
    List<Blog> blogs = mapper.queryBlogWithCHOOSE(map);
    for (Blog blog : blogs) {
        System.out.println(blog);
    }
    //加otherwise中的参数
    map.put("views", "9000");
    blogs = mapper.queryBlogWithCHOOSE(map);
    for (Blog blog : blogs) {
        System.out.println(blog);
    }
    //加when中的第二个参数
    map.put("author", "惟妙惟霄");
    blogs = mapper.queryBlogWithCHOOSE(map);
    for (Blog blog : blogs) {
        System.out.println(blog);
    }
    //加when中的第一个参数
    map.put("title", "Java");
    blogs = mapper.queryBlogWithCHOOSE(map);
    for (Blog blog : blogs) {
        System.out.println(blog);
    }

    sqlSession.close();
}

输出结果：

（无输出结果）

Blog(id=8826283b27624662872cf08c3e85861f, title=Spring, author=妙霄, createTime=Wed May 19 00:58:16 CST 2021, views=9000)

Blog(id=31a2f85f535344a1be14e1f4cc008786, title=Mybatis, author=惟妙惟霄, createTime=Wed May 19 00:58:16 CST 2021, views=3000)
Blog(id=fed236c8d51f4fc983fe036f42365824, title=Java, author=惟妙惟霄, createTime=Wed May 19 00:58:16 CST 2021, views=1000)

Blog(id=fed236c8d51f4fc983fe036f42365824, title=Java, author=惟妙惟霄, createTime=Wed May 19 00:58:16 CST 2021, views=1000)

12.5 SET

set 元素会动态地在行首插入 SET 关键字，并会删掉额外的逗号（这些逗号是在使用条件语句给列赋值时引入的）。

示例：

BlogMapper.java：

//使用SET更新博客
int updateBlogWithSET(Map<String, Object> map);

BlogMapper.xml：

<update id="updateBlogWithSET" parameterType="map">
    update blog
    <set>
        <if test="title != null">
            title=#{title},
        </if>
        <if test="author != null">
            author=#{author}
        </if>
    </set>
    where id=#{id}
</update>

测试类：

@Test
public void updateBlogWithSET(){
    SqlSession sqlSession = MyBatisUtil.getSqlSession();
    BlogMapper mapper = sqlSession.getMapper(BlogMapper.class);
    HashMap<String, Object> map = new HashMap<String, Object>();
    map.put("id", "31a2f85f535344a1be14e1f4cc008786");
    //只加一个参数
    map.put("author", "众妙门-妙霄");
    mapper.updateBlogWithSET(map);
    //加两个参数
    map.put("title", "学习MyBatis");
    mapper.updateBlogWithSET(map);

    sqlSession.close();
}

12.6 SQL 片段

有些时候，我们可能会将一些公共的 sql 语句抽取出来，方便复用。

使用步骤：

1. 使用 sql 标签提取公共部分

   <sql id="select-title-author">
       select * from blog where 1=1
       <if test="title != null">
           and title=#{title}
       </if>
       <if test="author != null">
           and author=#{author}
       </if>
   </sql>
   

2. 在需要使用的地方使用 include 标签

   <select id="queryBlogWithIF" parameterType="map" resultType="Blog">
       <include refid="select-title-author" />
   </select>
   

注意事项：

• 最好基于单表定义 SQL 片段
• 不要存在 where 标签

12.7 ForEach

foreach 元素的功能非常强大，它允许你指定一个集合，声明可以在元素体内使用的集合项（item）和索引（index）变量。它也允许你指定开头与结尾的字符串以及集合项迭代之间的分隔符。这个元素也不会错误地添加多余的分隔符。

示例：

BlogMapper.java：

//使用ForEach查询博客
List<Blog> queryBlogWithForEach(Map<String, Object> map);

BlogMapper.xml：

<select id="queryBlogWithForEach" parameterType="map" resultType="Blog">
    select * from blog
    <where>
        <if test="ids != null">
            id in
            <foreach collection="ids" item="id" open="(" close=")" separator=",">
                #{id}
            </foreach>
        </if>
    </where>
</select>

测试类：

@Test
public void queryBlogWithForEach(){
    SqlSession sqlSession = MyBatisUtil.getSqlSession();
    BlogMapper mapper = sqlSession.getMapper(BlogMapper.class);
    HashMap<String, Object> map = new HashMap<String, Object>();
    ArrayList<String> ids = new ArrayList<String>();
    ids.add("31a2f85f535344a1be14e1f4cc008786");
    ids.add("89094f71bd0a48fdbd14d5c854e8ddbe");
    map.put("ids", ids);
    List<Blog> blogs = mapper.queryBlogWithForEach(map);
    for (Blog blog : blogs) {
        System.out.println(blog);
    }
    sqlSession.close();
}

输出结果：

Blog(id=31a2f85f535344a1be14e1f4cc008786, title=学习MyBatis, author=众妙门-妙霄, createTime=Wed May 19 00:58:16 CST 2021, views=3000)
Blog(id=89094f71bd0a48fdbd14d5c854e8ddbe, title=分布式, author=妙霄, createTime=Wed May 19 00:58:16 CST 2021, views=8000)

13. 缓存

13.1 缓存

1. 什么是缓存 [ Cache ]？
   • 存在内存中的临时数据。
   • 将用户经常查询的数据放在缓存(内存)中，用户去查询数据就不用从磁盘上(关系型数据库数据文件)查询，改为从缓存中查询，从而提高查询效率，解决了高并发系统的性能问题。
2. 为什么使用缓存？
   • 减少和数据库的交互次数，减少系统开销，提高系统效率。
3. 什么样的数据能使用缓存?
   • 经常查询并且不经常改变的数据。

13.2 MyBatis 缓存

• MyBatis包含一个非常强大的查询缓存特性，它可以非常方便地定制和配置缓存。缓存可以极大的提升查询效率。
• MyBatis系统中默认定义了两级缓存：一级缓存和二级缓存
  • 默认情况下，只有一级缓存开启。(SqlSession 级别的缓存，也称为本地缓存)。
  • 二级缓存需要手动开启和配置，他是基于 namespace 级别的缓存。
  • 为了提高扩展性，MyBatis 定义了缓存接口 Cache。我们可以通过实现 Cache 接口来自定义二级缓存

13.3 一级缓存

• —级缓存也叫本地缓存：SqlSession
  • 与数据库同一次会话期间查询到的数据会放在本地缓存中。
  • 以后如果需要获取相同的数据，直接从缓存中拿，没必须再去查询数据库。

13.3.1 测试一级缓存

测试步骤：

1. 开启日志
2. 在 SqlSession 中查询两次相同的记录
3. 查看日志输出

示例：

UserMapper.java：

//根据id查询User
User queryUserById(int id);

UserMapper.xml：

<select id="queryUserById" resultType="User">
    select * from user where id = #{id}
</select>

UserMapperTest.java：

@Test
public void queryUserById(){
    SqlSession sqlSession = MyBatisUtil.getSqlSession();
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    System.out.println("=========================");
    System.out.println("========第一次输出========");
    User user1 = mapper.queryUserById(1);
    System.out.println(user1);
    System.out.println("=========================");
    System.out.println("========第二次输出========");
    User user2 = mapper.queryUserById(1);
    System.out.println(user2);
    sqlSession.close();
}

输出结果：

=========================
========第一次输出========
==>  Preparing: select * from user where id = ?
==> Parameters: 1(Integer)
<==    Columns: id, name, pwd
<==        Row: 1, 刘季恒, 197699
<==      Total: 1
User(id=1, name=刘季恒, pwd=197699)
=========================
========第二次输出========
User(id=1, name=刘季恒, pwd=197699)

13.3.2 缓存可能失效的原因

1. 查询不同的记录
2. 增删改操作
3. 查询不同的 Mapper.xml
4. 手动清理缓存

13.3.3 小结

• 一级缓存默认开启
• 一级缓存只在一次 SqlSession 中有效
• 一级缓存的本质是一个 Map

13.4 二级缓存

• 二级缓存也叫全局缓存，一级缓存作用域太低了，所以诞生了二级缓存。
• 基于 namespace 级别的缓存，一个名称空间，对应一个二级缓存。
• 工作机制
  • 一个会话查询一条数据，这个数据就会被放在当前会话的一级缓存中。
  • 如果当前会话关闭了，这个会话对应的一级缓存就没了。但是我们想要的是，会话关闭了，一级缓存中的数据被保存到二级缓存中。
  • 新的会话查询信息，就可以从二级缓存中获取内容。
  • 不同的 Mapper 查出的数据会放在自己**对应的缓存（map）**中。

使用步骤：

1. 显式地开启全局缓存

   mybatis-config.xml：

   <!-- 显式地开启全局缓存 -->
   <setting name="cacheEnabled" value="true"/>
   

2. 在 Mapper.xml 中开启缓存

   UserMapper.xml：

   <!-- 开启全局缓存 -->
   <cache
          eviction="FIFO"
          flushInterval="60000"
          size="512"
          readOnly="true"/>
   

小结：

• 实体类必须序列化，否则会报错！
• 只要开启了二级缓存，在同一个 Mapper 下就有效
• 所有的数据都会先放在一级缓存中
• 只有当会话提交，或者关闭的时候，才会提交到二级缓冲中

13.5 MyBatis 缓存原理

1. 先查询二级缓存
2. 若未找到，再查询一级缓存
3. 若未找到，则查询数据库，并存入一级缓存
4. 提交或关闭时，将一级缓存存入二级缓存
   MyBatis包含一个非常强大的查询缓存特性，它可以非常方便地定制和配置缓存。缓存可以极大的提升查询效率。

• MyBatis系统中默认定义了两级缓存：一级缓存和二级缓存
  • 默认情况下，只有一级缓存开启。(SqlSession 级别的缓存，也称为本地缓存)。
  • 二级缓存需要手动开启和配置，他是基于 namespace 级别的缓存。
  • 为了提高扩展性，MyBatis 定义了缓存接口 Cache。我们可以通过实现 Cache 接口来自定义二级缓存

13.3 一级缓存

• —级缓存也叫本地缓存：SqlSession
  • 与数据库同一次会话期间查询到的数据会放在本地缓存中。
  • 以后如果需要获取相同的数据，直接从缓存中拿，没必须再去查询数据库。

13.3.1 测试一级缓存

测试步骤：

1. 开启日志
2. 在 SqlSession 中查询两次相同的记录
3. 查看日志输出

示例：

UserMapper.java：

//根据id查询User
User queryUserById(int id);

UserMapper.xml：

<select id="queryUserById" resultType="User">
    select * from user where id = #{id}
</select>

UserMapperTest.java：

@Test
public void queryUserById(){
    SqlSession sqlSession = MyBatisUtil.getSqlSession();
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    System.out.println("=========================");
    System.out.println("========第一次输出========");
    User user1 = mapper.queryUserById(1);
    System.out.println(user1);
    System.out.println("=========================");
    System.out.println("========第二次输出========");
    User user2 = mapper.queryUserById(1);
    System.out.println(user2);
    sqlSession.close();
}

输出结果：

=========================
========第一次输出========
==>  Preparing: select * from user where id = ?
==> Parameters: 1(Integer)
<==    Columns: id, name, pwd
<==        Row: 1, 刘季恒, 197699
<==      Total: 1
User(id=1, name=刘季恒, pwd=197699)
=========================
========第二次输出========
User(id=1, name=刘季恒, pwd=197699)

13.3.2 缓存可能失效的原因

1. 查询不同的记录
2. 增删改操作
3. 查询不同的 Mapper.xml
4. 手动清理缓存

13.3.3 小结

• 一级缓存默认开启
• 一级缓存只在一次 SqlSession 中有效
• 一级缓存的本质是一个 Map

13.4 二级缓存

• 二级缓存也叫全局缓存，一级缓存作用域太低了，所以诞生了二级缓存。
• 基于 namespace 级别的缓存，一个名称空间，对应一个二级缓存。
• 工作机制
  • 一个会话查询一条数据，这个数据就会被放在当前会话的一级缓存中。
  • 如果当前会话关闭了，这个会话对应的一级缓存就没了。但是我们想要的是，会话关闭了，一级缓存中的数据被保存到二级缓存中。
  • 新的会话查询信息，就可以从二级缓存中获取内容。
  • 不同的 Mapper 查出的数据会放在自己**对应的缓存（map）**中。

使用步骤：

1. 显式地开启全局缓存

   mybatis-config.xml：

   <!-- 显式地开启全局缓存 -->
   <setting name="cacheEnabled" value="true"/>
   

2. 在 Mapper.xml 中开启缓存

   UserMapper.xml：

   <!-- 开启全局缓存 -->
   <cache
          eviction="FIFO"
          flushInterval="60000"
          size="512"
          readOnly="true"/>
   

小结：

• 实体类必须序列化，否则会报错！
• 只要开启了二级缓存，在同一个 Mapper 下就有效
• 所有的数据都会先放在一级缓存中
• 只有当会话提交，或者关闭的时候，才会提交到二级缓冲中

13.5 MyBatis 缓存原理

1. 先查询二级缓存
2. 若未找到，再查询一级缓存
3. 若未找到，则查询数据库，并存入一级缓存
4. 提交或关闭时，将一级缓存存入二级缓存