Mybatis 学习笔记

Mybatis

简介

什么是 Mybatis

• Mybatis 是一款优秀的持久层框架
• 它支持自定义 SQL、存储过程以及高级映射。MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录。

持久化

数据持久化

• 持久化就是将程序的数据在持久状态和瞬时状态转化的过程
• 内存：断电即失
• 数据库（JDBC）、IO 文件 持久化

为什么要持久化

• 有一些对象，不能让他丢掉
• 内存太贵

持久层

Dao 层、Service 层、Controller 层

• 完成持久化工作的代码块
• 层界限十分明显

为什么要 Mybatis

• 帮助程序员将数据存入数据库
• 传统的 JDBC 代码太复杂
• 不用 Mybatis 也可以，技术没有高低之分
• Mybatis 优点：
  • 简单易学
  • 灵活
  • SQL 和 代码分离，提高了可维护性
  • 提供映射标签，支持对象与数据库的 orm 字段关系映射
  • 提供对象关系映射标签，支持对象关系组建维护
  • 提供 XML 标签，支持编写动态 SQL

第一个 Mybatis 程序

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

搭建环境

1. 创建一个普通的 maven 项目
2. 删除 src 目录（就可以把此工程当作父工程，然后创建子工程）
3. 导入 maven 依赖

<dependencies>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.47</version>
        </dependency>
        <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>
            <scope>test</scope>
        </dependency>
    </dependencies>

创建一个模块

编写 Mybatis 的核心配置文件

<?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.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&amp;useUnicode=true&amp;characterEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/jarvis/dao/UserMapper.xml"/>
    </mappers>
</configuration>

编写 Mybatis 工具类

package com.jarvis.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;

public class MybatisUtils {

    private static SqlSessionFactory sqlSessionFactory;

    static{
        try {
            String resource = "mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    public static SqlSession getSqlSession(){
        return sqlSessionFactory.openSession();
    }
}

编写代码

• 实体类
• Dao 接口

package com.jarvis.dao;

import com.jarvis.pojo.User;

import java.util.List;

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

• 接口实现类

<?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="com.jarvis.dao.UserMapper">
    <select id="getUserList" resultType="com.jarvis.pojo.User">
        select * from `user`;
    </select>
</mapper>

测试

• Junit 测试

package com.jarvis.dao;

import com.jarvis.pojo.User;
import com.jarvis.utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;

import java.util.List;

public class UserDaoTest {
    @Test
    public void test(){
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        UserMapper userDao = sqlSession.getMapper(UserMapper.class);
        List<User> userList = userDao.getUserList();
        for (User user : userList) {
            System.out.println(user);
        }
        sqlSession.close();
    }
}

CRUD

namespace

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

select、insert、update、delete

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

1. 编写接口
2. 编写对应 mapper 中的 sql 语句
3. 测试

编写接口

package com.jarvis.dao;

import com.jarvis.pojo.User;

import java.util.List;

public interface UserMapper {
    // 查询全部用户
    List<User> getUserList();

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

    // insert 一个用户
    void addUser(User user);

    // 修改用户
    void updateUser(User user);

    // 删除一个用户
    void deleteUser(int id);
}

编写对应 mapper 中的 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="com.jarvis.dao.UserMapper">
    <select id="getUserList" resultType="com.jarvis.pojo.User">
        select *
        from USER;
    </select>

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

    <insert id="addUser" parameterType="com.jarvis.pojo.User">
        insert into USER (id, name, pwd)
        values (#{id}, #{name}, #{pwd});
    </insert>

    <update id="updateUser" parameterType="com.jarvis.pojo.User">
        update USER
        set name = #{name},
            pwd  = #{pwd}
        where id = #{id};
    </update>

    <delete id="deleteUser" parameterType="int">
        delete
        from USER
        where id = #{id};
    </delete>
</mapper>

测试

package com.jarvis.dao;

import com.jarvis.pojo.User;
import com.jarvis.utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;

import java.util.List;

public class UserDaoTest {
    @Test
    public void test() {
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        UserMapper userDao = sqlSession.getMapper(UserMapper.class);
        List<User> userList = userDao.getUserList();
        for (User user : userList) {
            System.out.println(user);
        }
        sqlSession.close();
    }

    @Test
    public void testGetUserById() {
        SqlSession sqlSession = MybatisUtils.getSqlSession();

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

        sqlSession.close();
    }

    // 增删改需要提交事务
    @Test
    public void testAddUser() {
        SqlSession sqlSession = MybatisUtils.getSqlSession();

        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        mapper.addUser(new User(5, "Aether", "213123"));
        // 提交事务
        sqlSession.commit();

        sqlSession.close();
    }

    @Test
    public void testUpdateUser() {
        SqlSession sqlSession = MybatisUtils.getSqlSession();

        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        mapper.updateUser(new User(4, "NewAether", "123123"));
        // 提交事务
        sqlSession.commit();

        sqlSession.close();
    }

    @Test
    public void testDeleteUser() {
        SqlSession sqlSession = MybatisUtils.getSqlSession();

        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        mapper.deleteUser(2);
        sqlSession.commit();

        sqlSession.close();
    }
}

万能的 Map

Insert

    // 万能的 Map
    void addUser_Map(Map<String, Object> map);

	<insert id="addUser_Map" parameterType="map">
        insert into USER (id, name, pwd)
        values (#{userId}, #{userName}, #{userPwd});
    </insert>

    @Test
    public void testAddUser_Map(){
        SqlSession sqlSession = MybatisUtils.getSqlSession();

        UserMapper mapper = sqlSession.getMapper(UserMapper.class);

        Map<String, Object> map = new HashMap<>();
        map.put("userId", 9);
        map.put("userName", "Hello");
        map.put("userPwd", "222333");

        mapper.addUser_Map(map);
        sqlSession.commit();

        sqlSession.close();
    }

Map 传递参数，直接在 SQL 中取 key 即可 【parameterType=“map”】
对象传递参数，直接在 SQL 中取对象的属性即可 【parameterType=“Object”】
只有一个基本类型的参数情况下，可以直接在 SQL 中取到
多个参数用 Map 或者 注解

模糊查询怎么写

Java 代码执行的时候，传递通配符 %
在 SQL 拼接中使用通配符（会被 SQL 注入）

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

    <select id="getUserLike" resultType="com.jarvis.pojo.User">
        select *
        from USER
        where name like #{value};
    </select>

<!--    <select id="getUserLike" resultType="com.jarvis.pojo.User">-->
<!--        select *-->
<!--        from USER-->
<!--        where name like "%"#{value}"%";-->
<!--    </select>-->

	@Test
    public void testGetUserLike(){
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        List<User> userList = mapper.getUserLike("H%");
        System.out.println(userList);
        sqlSession.close();
    }

配置解析

核心配置文件

• mybatis-config.xml
• Mybatis的配置文件包含了会深深影响MyBatis行为的设置和属性信息

	configuration（配置）
    properties（属性）
    settings（设置）
    typeAliases（类型别名）
    typeHandlers（类型处理器）
    objectFactory（对象工厂）
    plugins（插件）
    environments（环境配置）
    environment（环境变量）
    transactionManager（事务管理器）: type="[JDBC|MANAGED]" 有两种	默认 JDBC
    dataSource（数据源）：type="[UNPOOLED|POOLED|JNDI] 有三种	默认 POOLED
    databaseIdProvider（数据库厂商标识）
    mappers（映射器）

环境配置（environments）

MyBatis 可以配置成适应多种环境
不过要记住：尽管可以配置多个环境，但每个 SqlSessionFactory 实例只能选择一种环境。
学会使用配置多套运行环境

属性（properties）

1. 我们可以通过 properties 属性来引用配置文件
2. 这些属性可以在外部进行配置，并可以进行动态替换。你既可以在典型的 Java 属性文件中配置这些属性，也可以在 properties 元素的子元素中设置【db.properties】

• 编写一个配置文件

driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8
username=root
password=123456

• 在核心配置文件中引入
  

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>
	<!--引入外部配置文件-->
	
    <properties resource="db.properties"/>

    <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 resource="com/jarvis/dao/UserMapper.xml"/>
    </mappers>
</configuration>

• 可以直接引入外部文件
• 可以在其中增加一些属性配置
• 如果一个属性在不只一个地方进行了配置，那么，MyBatis 将按照下面的顺序来加载：

1. 首先读取在 properties 元素体内指定的属性。
2. 然后根据 properties 元素中的 resource 属性读取类路径下属性文件，或根据 url 属性指定的路径读取属性文件，并覆盖之前读取过的同名属性。
3. 最后读取作为方法参数传递的属性，并覆盖之前读取过的同名属性。

类型别名（typeAliases）

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

	<typeAliases>
        <typeAlias type="com.jarvis.pojo.User" alias="User"/>
    </typeAliases>

也可以指定一个包名，MyBatis 会在包名下面搜索需要的 Java Bean
扫描实体类的包，它的默认别名就为这个类的类名（首字母小写）

	<typeAliases>
        <package name="com.jarvis.pojo"/>
    </typeAliases>

在实体类比较少的时候使用第一种
实体类较多则使用第二种
区别：

• 第一种可以自定义别名；第二种如果想要自定义，则需要在实体类上增加注解

设置（settings）

这是 MyBatis 中极为重要的调整设置，它们会改变 MyBatis 的运行时行为。 下表描述了设置中各项设置的含义、默认值等。

其他配置

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

映射器（mappers）

MapperRegistry：注册绑定 Mapper 文件

1. 方式一（推荐使用）：

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

2. 方式二：使用 class 文件绑定注册

    <mappers>
        <mapper class="com.jarvis.dao.UserMapper"/>
    </mappers>

注意点：

• 接口和它的 Mapper 配置文件必须同名
• 接口和它的 Mapper 配置文件必须在同一个包下

3. 方式三：使用扫描包进行绑定注册

    <mappers>
        <package name="com.jarvis.dao"/>
    </mappers>

注意点：

• 接口和它的 Mapper 配置文件必须同名
• 接口和它的 Mapper 配置文件必须在同一个包下

生命周期和作用域

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

SqlSessionFactoryBuilder：

• 一旦创建了 SqlSessionFactory，就不再需要它了
• 局部变量

SqlSessionFactory:

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

SqlSession：

• 连接到连接池的一个请求
• SqlSession 的实例不是线程安全的，因此是不能被共享的，所以它的最佳的作用域是请求或方法作用域
• 用完之后赶紧关闭，否则资源被占用
  

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

问题

数据库中的字段

新建一个项目，拷贝之前的，测试实体类字段不一致的情况

public class User {
    private int id;
    private String name;
    private String password;
}

测试出现问题

// select * from USER where id = #{id}
// 类型处理器
// select id,name,pwd from USER where id = #{id}

解决方案：

1. 起别名

    <select id="getUserById" parameterType="int" resultType="com.jarvis.pojo.User">
        select id,name,pwd as password from USER where id = #{id}
    </select>

resultMap

结果集映射

id	name	pwd
id	name	password

	<!--结果集映射-->
	<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">
        select * from USER where id = #{id}
    </select>

• resultMap 元素是 MyBatis 中最重要最强大的元素
• ResultMap 的设计思想是，对简单的语句做到零配置，对于复杂一点的语句，只需要描述语句之间的关系就行了
• 完全可以不用显式地配置它们

日志

日志工厂

如果一个数据库操作出现了异常，我们需要排错，日志就是最好的帮手
曾经：sout、debug
现在：日志工厂

• SLF4J
• LOG4J【掌握】
• LOG4J2
• JDK_LOGGING
• COMMONS_LOGGING
• STDOUT_LOGGING【掌握】
• NO_LOGGING

在 Mybatis 中具体使用哪个日志实现，在设置中设定

STDOUT_LOGGING 标准日志输出

在 Mybatis 核心配置文件中，配置日志

    <settings>
        <setting name="logImpl" value="STDOUT_LOGGING"/>
    </settings>

Log4j

什么是 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/jarvis.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. 配置 log4j 为日志实现

    <settings>
        <setting name="logImpl" value="LOG4J"/>
    </settings>

4. log4j 的使用
   

• 简单使用

5. 在要使用 Log4j 的类中，导入包 import org.apache.log4j.Logger;
6. 日志对象，参数为当前类的 class

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

7. 日志级别

   @Test
   public void testLog4j(){
       logger.info("info:进入了testLog4j");
       logger.debug("debug:进入了testLog4j");
       logger.error("error:进入了testLog4j");
   }
   

分页

为什么要分页？

减少数据的处理量

使用 limit 分页

SELECT * FROM user limit 0,2

使用 Mybatis 分页：

1. 接口

    // limit
    List<User> getUserByLimit(Map<String, Integer> map);

2. mapper.xml

    <select id="getUserByLimit" parameterType="map" resultType="user" resultMap="UserMap">
        select * from user limit #{startIndex},#{pageSize};
    </select>

3. 测试

    @Test
    public void testLimit() {
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        Map<String, Integer> map = new HashMap<>();
        map.put("startIndex", 0);
        map.put("pageSize", 2);
        List<User> userByLimit = mapper.getUserByLimit(map);
        System.out.println(userByLimit);
        sqlSession.close();
    }

RowBounds 分页

不使用 SQL 分页：

1. 接口

    // limit by rowBounds
   List<User> getUserByRowBounds();

2. mapper.xml

    <select id="getUserByRowBounds" resultMap="UserMap">
        select * from user;
    </select>

3. 测试

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

分页插件

PageHelper 了解即可

使用注解开发

1. 注解在接口上实现

    @Select("select id,name,pwd as password from user")
    List<User> getUsers();

2. 需要在核心配置文件中绑定接口

    <mappers>
        <mapper class="com.jarvis.dao.UserMapper"/>
    </mappers>

3. 测试

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

本质：反射机制实现
底层：动态代理

• Mybatis 执行流程
  

CRUD

可以在工具类创建的时候设置自动提交事务

	public static SqlSession getSqlSession(){
        return sqlSessionFactory.openSession(true);
    }

编写接口，添加注解

public interface UserMapper {

    @Select("select id,name,pwd as password from user")
    List<User> getUsers();

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

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

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

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

注意：必须将接口注册绑定到我们的核心配置文件中

关于 @Param() 注解

• 基本类型的参数或 String 类型，需要加上
• 引用类型不需要加
• 如果只有一个基本类型，可以忽略，但建议都加上
• 我们在 SQL 中引用的就是这里 @Param() 中设定的属性名

Lombok

使用步骤：

1. 在 IDEA 中安装 Lombok 插件
2. 在项目中导入 Lombok 的 jar 包

@Getter and @Setter
@FieldNameConstants
@ToString
@EqualsAndHashCode
@AllArgsConstructor, @RequiredArgsConstructor and @NoArgsConstructor
@Log, @Log4j, @Log4j2, @Slf4j, @XSlf4j, @CommonsLog, @JBossLog, @Flogger, @CustomLog
@Data
@Builder
@SuperBuilder
@Singular
@Delegate
@Value
@Accessors
@Wither
@With
@SneakyThrows

• @Data：无参构造，get，set，toString()，hashCode()，equals()
• @AllArgsConstructor：有参构造
• @NoArgsConstructor：无参构造
• @ToString
• @EqualsAndHashCode
• @Getter
• @Setter

多对一处理

多个学生对应一个老师
对于学生而言：多个学生，关联一个老师（关联）（多对一）
对于老师而言：一个老师，有很多学生（集合）（一对多）

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);

测试环境搭建

1. 导入 Lombok
2. 新建实体类 Student 和 Teacher
3. 建立 Mapper 接口
4. 建立 Mapper.xml 文件
5. 在核心配置文件中绑定注册 Mapper 接口 或者 文件
6. 测试查询是否成功

实体类：

package com.jarvis.pojo;

import lombok.Data;

@Data
public class Student {
    private int id;
    private String name;
    // 学生需要关联一个老师
    private Teacher teacher;
}

package com.jarvis.pojo;

import lombok.Data;

@Data
public class Teacher {
    private int id;
    private String name;
}

按照查询嵌套处理（子查询）

1. 查询所有学生信息
2. 根据查询出来的学生的 tid，寻找对应的老师

    <select id="getStudent" resultMap="StudentTeacher">
        select * from student;
    </select>
    
    <resultMap id="StudentTeacher" type="Student">
        <result property="id" column="id"/>
        <result property="name" column="name"/>
        <association property="teacher" column="tid" javaType="Teacher" select="getTeacher"/>
    </resultMap>

    <select id="getTeacher" resultType="Teacher">
        select * from teacher where id = #{id}
    </select>

按照结果嵌套处理

	<select id="getStudent2" resultMap="StudentTeacher2">
        select s.id sid, s.name sname, t.name tname
        from student s, teacher t
        where s.tid = t.id
    </select>

    <resultMap id="StudentTeacher2" type="Student">
        <result property="id" column="sid"/>
        <result property="name" column="sname"/>
        <association property="teacher" javaType="Teacher">
            <result property="name" column="tname"/>
        </association>
    </resultMap>

回顾 MySQL 多对一查询方式：

• 子查询
• 联表查询

一对多处理

实体类：

package com.jarvis.pojo;

import lombok.Data;

@Data
public class Student {
    private int id;
    private String name;
    private int tid;
}

package com.jarvis.pojo;

import lombok.Data;

import java.util.List;

@Data
public class Teacher {
    private int id;
    private String name;
    // 一个老师有多个学生
    private List<Student> students;
}

按照结果嵌套处理

    <select id="getTeacher" resultMap="TeacherStudent">
        select s.id sid, s.name sname, t.name tname, t.id tid
        from student s ,teacher t
        where s.tid = t.id and t.id = #{tid}
    </select>
    
    <resultMap id="TeacherStudent" type="Teacher">
        <result property="id" column="tid"/>
        <result property="name" column="tname"/>
        <collection property="students" ofType="Student">
            <result property="id" column="sid"/>
            <result property="name" column="sname"/>
            <result property="tid" column="tid"/>
        </collection>
    </resultMap>

按照查询嵌套处理（子查询）

    <select id="getTeacher2" resultMap="TeacherStudent2">
        select * from teacher where id = #{tid}
    </select>

    <resultMap id="TeacherStudent2" type="Teacher">
        <collection property="students" ofType="Student" select="getStudentByTeacherId" column="id"/>
    </resultMap>
    
    <select id="getStudentByTeacherId" resultType="Student">
        select * from student where tid = #{tid}
    </select>

小结：

1. 关联 - association（多对一）
2. 集合 - collection（一对多）
3. javaType 用来指定实体类中的属性类型
4. ofType 用来指定映射到 List 或者集合中的 Pojo 类型，泛型中的约束类型

注意点：

1. 保证 SQL 可读性，尽量保证通俗易懂
2. 注意一对多和多对一中属性名和字段问题
3. 如果问题不好排查错误，可以使用日志，建议使用 Log4j

动态 SQL

什么是动态 SQL？
动态 SQL 就是根据不同的条件生成不同的 SQL 语句

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

搭建环境

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(30) NOT NULL COMMENT '浏览量'
)ENGINE=INNODB DEFAULT CHARSET=utf8

创建一个基础工程：

1. 导包
2. 编写配置文件
3. 编写实体类

@Data
public class Blog {
    private String id;
    private String name;
    private String author;
    private Date createTime;
    private int views;
}

4. 编写实体类对应的 Mapper 接口 和 Mapper.xml 文件

IF

<select id="queryBlogIf" 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>

choose (when, otherwise)

Java 中的 switch 语句，上面的先符合了就直接 Query 出来

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

trim (where, set)

where：自动去除 and 和 or

    <select id="queryBlogIf" 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>

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

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

trim

所谓的动态 SQL 本质还是 SQL语句，只是我们可以在 SQL 层面，去执行逻辑代码

SQL 片段

有的时候我们可能会将一些功能的部分抽取出来，方便复用

1. 使用 sql 标签抽取公共部分
2. 在需要使用的地方用 include 标签引用即可

    <sql id="if-title-author">
        <if test="title != null">
            title = #{title}
        </if>
        <if test="author != null">
            and author = #{author}
        </if>
    </sql>

    <select id="queryBlogIf" parameterType="map" resultType="Blog">
        select * from blog
        <where>
            <include refid="if-title-author"></include>
        </where>
    </select>

注意事项：

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

foreach

    <select id="queryBlogForeach" parameterType="map" resultType="Blog">
        select * from blog
        <where>
            <foreach collection="ids" item="id" open="and (" close=")" separator="or">
                id = #{id}
            </foreach>
        </where>
    </select>

    @Test
    public void testQueryBlogForeach(){
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        BlogMapper mapper = sqlSession.getMapper(BlogMapper.class);
        HashMap map = new HashMap();
        List<Integer> ids = new ArrayList<>();
        ids.add(1);
        ids.add(2);
        ids.add(3);
        map.put("ids", ids);
        List<Blog> blogs = mapper.queryBlogForeach(map);
        for (Blog blog : blogs) {
            System.out.println(blog);
        }
        sqlSession.close();
    }

动态 SQL 就是在拼接 SQL 语句，我们只要保证 SQL 的正确性，按照 SQL 的格式，去排列组合

建议：

• 现在 MySQL 中写出完整的 SQL，再对应的去修改成动态 SQL 实现通用

缓存

查询：连接数据库，耗资源
一次查询的结果，给它暂存在一个可以直接取到的地方（缓存）
再次查询相同数据的时候，直接走缓存，就不走数据库了

一级缓存

一级缓存也叫本地缓存：SqlSession

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

public class MyTest {
    @Test
    public void testQueryUsers(){
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        User user = mapper.queryUserById(1);
        System.out.println(user);
        User user2 = mapper.queryUserById(1);
        System.out.println(user2);

        System.out.println(user == user2);

        sqlSession.close();
    }
}

缓存失效的情况：

• 增删改可能会改变原来的数据，所以必定刷新缓存
• 查询不同的数据
• 查询不同的 Mapper.xml
• 手动清理缓存

增删改

    @Test
    public void testQueryUsers(){
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        User user = mapper.queryUserById(1);
        System.out.println(user);

        mapper.updateUser(new User(3, "zzzz", "222222"));

        System.out.println("====================");

        User user2 = mapper.queryUserById(1);
        System.out.println(user2);

        System.out.println(user == user2);

        sqlSession.close();
    }

手动清理缓存 sqlSession.clearCache()

    @Test
    public void testQueryUsers(){
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        User user = mapper.queryUserById(1);
        System.out.println(user);

//        mapper.updateUser(new User(3, "zzzz", "222222"));

        sqlSession.clearCache();// 手动清理

        System.out.println("====================");

        User user2 = mapper.queryUserById(1);
        System.out.println(user2);

        System.out.println(user == user2);

        sqlSession.close();
    }

小结：一级缓存默认是开启的，只在 SqlSession 中有效，也就是拿到连接（getSqlSession()）到关闭连接（sqlSession.close()）这个区间

二级缓存

1. 开启全局缓存

<setting name="cacheEnabled" value="true"/>

2. 在要使用二级缓存的 Mapper 中开启

<cache/>
<!--也可以自定义一些参数-->
<cache eviction="FIFO" flushInterval="60000" size="512" readOnly="true"/>

3. 测试
4. 问题：

<!--如果 <cache/> 中不设置 readOnly="true"，则需要将实体类序列化，否则报错（SQl 写在注释中则不报错），此时 user == user2 为 false-->
<!--如果 <cache readOnly="true"/>，则无需将实体类序列化，此时 user == user2 为 true（SQL 写在注释中则为 false）-->

这边关于 SQL 写在注释中 与 缓存之间的关系还不太清楚，只是测试了结果😶

测试

注意：这里 SQL 写在 UserMapper.xml 中

public interface UserMapper {
    User queryUserById(@Param("id") int id);
}

<?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="com.jarvis.dao.UserMapper">

    <cache eviction="FIFO" flushInterval="60000" size="512" readOnly="true"/>

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

    @Test
    public void testQueryUsers(){
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        SqlSession sqlSession2 = MybatisUtils.getSqlSession();

        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        User user = mapper.queryUserById(1);
        System.out.println(user);

        sqlSession.close();

        UserMapper mapper2 = sqlSession2.getMapper(UserMapper.class);
        User user2 = mapper2.queryUserById(1);
        System.out.println(user2);

        System.out.println(user == user2);

        sqlSession2.close();
    }

注意：使用注释写 SQL ，第一次查询出的结果在第一个 SqlSession.close() 后不会被保存至二级缓存

public interface UserMapper {
    @Select("select * from user where id = #{id}")
    User queryUserById(@Param("id") int id);
}

<?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="com.jarvis.dao.UserMapper">

    <cache eviction="FIFO" flushInterval="60000" size="512" readOnly="true"/>

</mapper>

public class MyTest {
    @Test
    public void testQueryUsers(){
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        SqlSession sqlSession2 = MybatisUtils.getSqlSession();

        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        User user = mapper.queryUserById(1);
        System.out.println(user);

        sqlSession.close();

        UserMapper mapper2 = sqlSession2.getMapper(UserMapper.class);
        User user2 = mapper2.queryUserById(1);
        System.out.println(user2);

        System.out.println(user == user2);

        sqlSession2.close();
    }

}

小结（SQL 写在Mapper.xml 而非 注释中）：

1. 只要开启了二级缓存，在同一个 Mapper 下就有效
2. 所有的数据都会先放在一级缓存
3. 只有当会话提交或者关闭的时候，才会被保存到二级缓存

缓存原理

1. 第一次查询先看二级缓存中有没有
2. 再看一级缓存中有没有
3. 如果都没有，则查询数据库

测试

@Test
    public void testQueryUsers(){
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        SqlSession sqlSession2 = MybatisUtils.getSqlSession();

        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        User user1 = mapper.queryUserById(1);
        System.out.println(user1);

        sqlSession.close();

        UserMapper mapper2 = sqlSession2.getMapper(UserMapper.class);
        User user2 = mapper2.queryUserById(1);// 二级缓存中取
        System.out.println(user2);

        User user3 = mapper2.queryUserById(3);
        System.out.println(user3);// 缓存中没有，打开 JDBC 连接

        User user4 = mapper2.queryUserById(3);// 一级缓存中取
        System.out.println(user4);

        sqlSession2.close();
    }

自定义缓存 ehcache

跳过了，用 Redis

完结

Mybatis 官网：https://mybatis.org/mybatis-3/zh/index.html