MyBatis基础学习笔记

学习来源:尚硅谷

学习时间:2022年6月3日端午节,2023年6月24日端午节复习

1 MyBatis简介

1.1 历史

MyBatis最初是Apache的一个开源项目iBatis, 2010年6月这个项目由Apache Software Foundation迁移到了Google Code。

随着开发团队转投Google Code旗下, iBatis3.x正式更名为MyBatis

代码于2013年11月迁移到Github。iBatis一词来源于“internet”和“abatis”的组合,是一个基于Java的持久层框架。 iBatis提供的持久层框架包括SQL Maps和Data Access Objects(DAO)。

1.2 特性

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

1.3 与其它持久层框架对比

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

2 搭建MyBatis

2.1 创建maven工程

创建一个空的工程MyBatisDemo。然后再新建一个基于maven的module。

设置打包方式为jar:

1
2
3
4
<groupId>com.hongyi</groupId>
<artifactId>mybatis_demo1</artifactId>
<version>1.0-SNAPSHOT</version>
<packaging>jar</packaging>

引入依赖:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.9</version>
</dependency>

<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.13.2</version>
<scope>test</scope>
</dependency>

<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.22</version>
</dependency>

2.2 核心配置文件

习惯上命名为mybatis-config.xml,这个文件名仅仅只是建议,并非强制要求。将来整合Spring之后,这个配置文件可以省略,所以大家操作时可以直接复制、粘贴。

核心配置文件主要用于配置连接数据库的环境以及MyBatis的全局配置信息。

核心配置文件存放的位置是src/main/resources目录下。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
<?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="123456"/>
</dataSource>
</environment>
</environments>
<!--引入映射文件-->
<mappers>
<mapper resource="mappers/UserMapper.xml"/>
</mappers>
</configuration>

2.3 mapper接口

在数据库test下新建表t_user

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

User实体类,位于pojo包下

1
2
3
4
5
6
7
8
9
@Data
public class User {
private Integer id;
private String username;
private String password;
private Integer age;
private String sex;
private String email;
}

UserMapper接口,位于mapper包下

1
2
3
public interface UserMapper {
int insertUser();
}

2.4 映射文件

相关概念:ORMObject Relationship Mapping)对象关系映射。

  • 对象:Java的实体类对象
  • 关系:关系型数据库
  • 映射:二者之间的对应关系
Java概念 数据库概念
属性 字段/列
对象 记录/行
  • 映射文件的命名规则和存放位置:

    • 表所对应的实体类的类名+Mapper.xml
    • 例如:表t_user,映射的实体类为User,所对应的映射文件为UserMapper.xml,因此一个映射文件对应一个实体类,对应一张表的操作。
    • MyBatis映射文件用于编写SQL,访问以及操作表中的数据
    • MyBatis映射文件存放的位置是src/main/resources/mappers目录下
  • MyBatis中可以面向接口操作数据,要保证两个一致:
    • mapper接口的全类名和映射文件的命名空间(namespace)保持一致
    • mapper接口中方法的方法名和映射文件中编写SQL的标签的id属性保持一致
1
2
3
4
5
6
7
8
9
10
11
12
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<!--这里的namespace和接口的全类名保持一致-->
<mapper namespace="com.hongyi.mapper.UserMapper">
<!--int insertUser();-->
<!--这里的id和接口中的方法名保持一致-->
<insert id="insertUser">
insert into t_user values(null,'张三','123',23,'女')
</insert>
</mapper>

项目结构:

image-20230624111718298

2.5 测试增删改查功能

测试功能——增

在测试集上新建com.hongyi.test.MybatisTest.java

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
public class MybatisTest {
@Test
public void test0() throws IOException {
// 加载核心配置文件:读取MyBatis的核心配置文件
InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
// 获取SqlSessionFactoryBuilder
SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
// 获取SqlSessionFactory:通过核心配置文件所对应的字节输入流创建工厂类SqlSessionFactory,生产SqlSession对象
SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(inputStream);
// 获取SqlSession:此时通过SqlSession对象所操作的sql都必须手动提交或回滚事务
SqlSession sqlSession = sqlSessionFactory.openSession();
// 获取mapper接口的实现对象:通过代理模式创建UserMapper接口的代理实现类对象
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
// 测试功能:调用UserMapper接口中的方法,就可以根据UserMapper的全类名匹配元素文件,通过调用的方法名匹配 映射文件中的SQL标签,并执行标签中的SQL语句
int result = mapper.insertUser();
// 提交事务
sqlSession.commit();
System.out.println("result: " + result);
}
}
  • SqlSession:代表Java程序和数据库之间的会话。(HttpSession是Java程序和浏览器之间的会话)
  • SqlSessionFactory:是“生产”SqlSession的“工厂”。
  • 工厂模式:如果创建某一个对象,使用的过程基本固定,那么我们就可以把创建这个对象的相关代码封装到一个“工厂类”中,以后都使用这个工厂类来“生产”我们需要的对象。

优化1

将事务提交设置为自动提交:

1
SqlSession sqlSession = sqlSessionFactory.openSession(true);

优化2——加入log4j日志功能

  • 加入依赖
1
2
3
4
5
6
<!-- log4j日志 --> 
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
  • 添加log4j.xml配置文件
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
<?xml version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
<appender name="STDOUT" class="org.apache.log4j.ConsoleAppender">
<param name="Encoding" value="UTF-8" />
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%-5p %d{MM-dd HH:mm:ss,SSS} %m (%F:%L) \n" />
</layout>
</appender>
<logger name="java.sql">
<level value="debug" />
</logger>
<logger name="org.apache.ibatis">
<level value="info" />
</logger>
<root>
<level value="debug" />
<appender-ref ref="STDOUT" />
</root>
</log4j:configuration>

注:IDEA配置xml文件头报错:URI is not registered (Settings | Languages & Frameworks | Schemas and DTDs)解决方法

  • 日志的级别:

FATAL(致命)>ERROR(错误)>WARN(警告)>INFO(信息)>DEBUG(调试)

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

打印内容:

1
2
3
4
DEBUG 06-04 11:41:45,873 ==>  Preparing: insert into t_user values(null, '张三', '123' ,23, '女', '123456@163.com') (BaseJdbcLogger.java:137) 
DEBUG 06-04 11:41:45,912 ==> Parameters: (BaseJdbcLogger.java:137)
DEBUG 06-04 11:41:45,914 <== Updates: 1 (BaseJdbcLogger.java:137)
result: 1

测试功能——修改和删除数据

1
2
3
4
5
6
public interface UserMapper {
// 修改
void updateUser();
// 删除
void deleteUser();
}
1
2
3
4
5
6
7
8
9
10
11
12
13
<?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.hongyi.mapper.UserMapper">
<update id="updateUser">
update t_user set username='李四' where id = 8
</update>

<delete id="deleteUser">
delete from t_user where id = 8
</delete>
</mapper>

测试类略

测试功能——查询数据

  • 查询功能的标签必须设置resultTyperesultMap,其作用是告知Mybatis将得到的结果集封装成java中的哪个对象,即用于设置实体类和数据库表的映射关系。
    • resultType属性:设置默认的映射关系,例如数据库的字段名和类对象的属性名一致的时候
    • resultMap属性:设置自定义的映射关系,用于一对多或多对一或字段名和属性名不一致的情况
  • 代码片段如下:
1
2
3
4
5
public interface UserMapper {
User getUserById();

List<User> getAllUser();
}
1
2
3
4
5
6
7
<select id="getUserById" resultType="com.hongyi.pojo.User">
select * from t_user where id = 1
</select>

<select id="getAllUser" resultType="com.hongyi.pojo.User">
select * from t_user
</select>
1
2
3
4
5
6
7
User user = mapper.getUserById();
System.out.println(user);

List<User> users = mapper.getAllUser();
for (User u : users) {
System.out.println(u);
}

3 核心配置文件

3.1 详解

要求:了解即可。

核心配置文件中的标签必须按照固定的顺序:

properties?,settings?,typeAliases?,typeHandlers?,objectFactory?,objectWrapperFactory?,reflectorFactory?,plugins?,environments?,databaseIdProvider?,mappers?

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
<?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文件,此时就可以${属性名}的方式访问属性值-->
<properties resource="jdbc.properties"></properties>
<settings>
<!--将表中字段的下划线自动转换为驼峰-->
<setting name="mapUnderscoreToCamelCase" value="true"/>
<!--开启延迟加载-->
<setting name="lazyLoadingEnabled" value="true"/></settings>
<typeAliases>
<!--typeAlias:
设置某个具体的类型的别名
属性:
type:需要设置别名的类型的全类名
alias:设置此类型的别名,若不设置此属性,该类型拥有默认的别名,即类名且不区分大小 写 若设置此属性,此时该类型的别名只能使用alias所设置的值
-->
<!--<typeAlias type="com.atguigu.mybatis.bean.User"></typeAlias>-->
<!--<typeAlias type="com.atguigu.mybatis.bean.User" alias="abc"> </typeAlias>-->
<!--以包为单位,设置改包下所有的类型都拥有默认的别名,即类名且不区分大小写-->
<package name="com.atguigu.mybatis.bean"/>
</typeAliases>
<!--
environments:设置多个连接数据库的环境
属性:
default:设置默认使用的环境的id
-->
<environments default="development">
<!--
environment:设置具体的连接数据库的环境信息
属性:
id:设置环境的唯一标识,可通过environments标签中的default设置某一个环境的id, 表示默认使用的环境
-->
<environment id="development">
<!--
transactionManager:设置事务管理方式
属性:
type:设置事务管理方式,type="JDBC|MANAGED"
type="JDBC":设置当前环境的事务管理都必须手动处理
type="MANAGED":设置事务被管理,例如spring中的AOP
-->
<transactionManager type="JDBC"/>
<!--
dataSource:设置数据源
属性:
type:设置数据源的类型,type="POOLED|UNPOOLED|JNDI"
type="POOLED":使用数据库连接池,即会将创建的连接进行缓存,下次使用可以从缓存中直接获取,不需要重新创建
type="UNPOOLED":不使用数据库连接池,即每次使用连接都需要重新创建
type="JNDI":调用上下文中的数据源
-->
<dataSource type="POOLED">
<!--设置驱动类的全类名-->
<property name="driver" value="${jdbc.driver}"/>
<!--设置连接数据库的连接地址-->
<property name="url" value="${jdbc.url}"/>
<!--设置连接数据库的用户名-->
<property name="username" value="${jdbc.username}"/>
<!--设置连接数据库的密码-->
<property name="password" value="${jdbc.password}"/>
</dataSource>
</environment>
</environments>
<!--引入映射文件-->
<mappers>
<mapper resource="UserMapper.xml"/>
<!--以包为单位,将包下所有的映射文件引入核心配置文件 注意:此方式必须保证mapper接口和mapper映射文件必须在相同的包下 -->
<package name="com.atguigu.mybatis.mapper"/>
</mappers>
</configuration>

例如在resources新建jdbc.properties

1
2
3
4
jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/test?characterEncoding=utf8
jdbc.username=root
jdbc.password=12345678

3.2 封装工具

封装SqlSessionUtils工具类并测试功能。

新建utils.SqlSessionUtils.java

1
2
3
4
5
6
7
8
9
10
11
12
13
public class SqlSessionUtils {
public static SqlSession getSqlSession() {
SqlSession sqlSession = null;
try {
InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
sqlSession = sqlSessionFactory.openSession(true);
} catch (IOException e) {
e.printStackTrace();
}
return sqlSession;
}
}

测试:

1
2
3
4
5
6
7
8
@Test
public void test0() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
ParameterMapper mapper = sqlSession.getMapper(ParameterMapper.class);
List<User> users = mapper.getAllUser();
// 方法引用
users.forEach(System.out::println);
}

4 MyBatis获取参数值的两种方式

Mapper接口中的某些方法需要参数,例如根据用户名查询用户,此时,用户名即为方法的参数:

1
User getUserByUsername(String username);

因此,需要MyBatis根据传入的参数username来生成SQL语句。

4.1 概述

MyBatis获取参数值的两种方式:${}#{}

  • ${}的本质就是字符串拼接,#{}的本质就是占位符赋值
  • ${}使用字符串拼接的方式拼接sql,若为字符串类型或日期类型的字段进行赋值时,需要手动加单引号
  • #{}使用占位符赋值的方式拼接sql,此时为字符串类型或日期类型的字段进行赋值时,可以自动添加单引号(但也导致了一些特殊sql不能使用这种方式,参见[[#6.1 模糊查询]])
  • 经验:能用#{}的地方就尽量用#{},只有特殊sql执行时才使用${}

4.2 单个字面量类型的参数

若mapper接口中的方法参数为单个的字面量类型,此时可以使用${}#{}任意的名称获取参数的值,注意${}需要手动加单引号

  • 根据用户名查询用户
1
2
3
public interface ParameterMapper {
User getUserByUsername(String username);
}
1
2
3
4
5
<select id="getUserByUsername" resultType="User">
<!-- 这里的username只是一个占位符,可以取任何名字,但建议见名知意 -->
<!-- select * from t_user where username = #{username} -->
select * from t_user where username = '${username}'
</select>
  • ${}的情况

image-20220604161742009

  • #{}的情况

image-20220604161712124

4.3 多个字面量类型的参数

若mapper接口中的方法参数为多个时:

此时MyBatis会自动将这些参数按位置顺序放在一个map集合中:

  • arg0,arg1...为键,以参数为值;
  • param1,param2...为键,以参数为值;
  • 两种方式都可以使用。

因此只需要通过${}#{}访问map集合的就可以获取相对应的,注意${}仍然需要手动加单引号

代码示例

1
2
3
4
5
public interface ParameterMapper {

User checkLogin(String username, String password);

}
1
2
3
4
<select id="checkLogin" resultType="User">
<!-- select * from t_user where username = #{arg0} and password = #{arg1} -->
select * from t_user where username = #{param1} and password=#{param2}
</select>
1
2
3
4
5
6
7
@Test
public void test2() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
ParameterMapper mapper = sqlSession.getMapper(ParameterMapper.class);
User user = mapper.checkLogin("Mark", "123456");
System.out.println(user);
}

4.4 map集合类型的参数

若mapper接口中的方法需要的参数为多个时,此时可以手动创建map集合,将这些数据放在map中。

只需要通过${}#{}访问map集合的键就可以获取相对应的值,注意${}需要手动加单引号。

这里的键就是自己来设置,而不是mybatis来自动设置的。

代码示例

1
2
3
4
5
public interface ParameterMapper {

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

}
1
2
3
<select id="checkLoginByMap" resultType="User">
select * from t_user where username = #{username} and password = #{password}
</select>
1
2
3
4
5
6
7
8
9
10
@Test
public void test3() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
ParameterMapper mapper = sqlSession.getMapper(ParameterMapper.class);
Map<String, Object> map = new HashMap<>();
map.put("username", "Mark");
map.put("password", "123456");
User user = mapper.checkLoginByMap(map);
System.out.println(user);
}

注意,SQL语句中的username等名字必须和map.put()的键相同。

4.5 实体类类型的参数

若mapper接口中的方法参数为实体类对象时:

此时可以使用${}#{},通过访问实体类对象中的属性名获取属性值,注意${}需要手动加单引号。

代码示例

1
2
3
4
5
public interface ParameterMapper {

int insertUser(User user);

}
1
2
3
<insert id="insertUser">
insert into t_user values(null, #{username}, #{password}, #{age}, #{sex}, #{email})
</insert>

注意,这里的username等名字必须和类中属性名保持一致。

1
2
3
4
5
6
7
8
9
10
11
12
13
@Test
public void test4() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
ParameterMapper mapper = sqlSession.getMapper(ParameterMapper.class);
User user = new User();
user.setUsername("Hongyi");
user.setAge(24);
user.setSex("男");
user.setEmail("12345678@qq.com");
user.setPassword("12345678");
int i = mapper.insertUser(user);
System.out.println(i);
}

控制台输出:

1
2
3
DEBUG 06-04 16:39:02,483 ==>  Preparing: insert into t_user values(null, ?, ?, ?, ?, ?) (BaseJdbcLogger.java:137) 
DEBUG 06-04 16:39:02,520 ==> Parameters: Hongyi(String), 12345678(String), 24(Integer), 男(String), 12345678@qq.com(String) (BaseJdbcLogger.java:137)
DEBUG 06-04 16:39:02,531 <== Updates: 1 (BaseJdbcLogger.java:137)

4.6 使用@Param标识参数

可以通过@Param注解标识mapper接口中的方法参数:

此时,会将这些参数放在map集合中,以@Param注解的value属性值为键,以参数为值;未指定value属性时,默认以param1,param2...为键,以参数为值;只需要通过${}#{}访问map集合的键就可以获取相对应的值,注意${}需要手动加单引号。

代码示例

1
2
3
4
5
public interface ParameterMapper {

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

}
1
2
3
<select id="checkLoginByParam" resultType="User">
select * from t_user where username = #{a} and password = #{b}
</select>
1
2
3
4
5
6
7
@Test
public void test5() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
ParameterMapper mapper = sqlSession.getMapper(ParameterMapper.class);
User user = mapper.checkLoginByParam("Mark", "123456");
System.out.println(user);
}

建议

  • 第1,2,3种情况全部使用第5种情况(@Param)解决。

  • 第4种情况单独解决。

  • 因此可只归结为使用实体类属性和使用@Param注解两种情况

5 MyBatis的查询功能

5.1 查询一个实体类对象或一个list集合

  • 若查询出的数据只有一条:
    • 可以通过实体类对象接收
    • 可以通过list集合接收
    • 可以通过map集合接收(5.3小节
  • 若查询出的数据有多条:
    • 可以通过list接收,但不能通过实体类对象来接收
    • 可以通过map的list来接收(5.4小节
    • 可以在mapper接口的方法上添加@MapKey注解,此时就可以将每条数据转换的map集合作为,以某个字段为,放在同一个map集合中(5.4小节

代码示例

1
2
3
4
5
6
7
8
9
10
11
public interface SelectMapper {
/**
* 根据id查询用户
*/
User getUserById(@Param("id") Integer id);

/**
* 查询所有用户信息
*/
List<User> getAllUser();
}
1
2
3
4
5
6
7
8
9
10
<mapper namespace="com.hongyi.mapper.SelectMapper">
<!--User getUserById(@Param("id") Integer id);-->
<select id="getUserById" resultType="User">
select * from t_user where id = #{id}
</select>

<select id="getAllUser" resultType="User">
select * from t_user
</select>
</mapper>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
public class SelectMapperTest {
@Test
public void test0() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
SelectMapper mapper = sqlSession.getMapper(SelectMapper.class);
User user = mapper.getUserById(1);
System.out.println(user);
}

@Test
public void test1() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
SelectMapper mapper = sqlSession.getMapper(SelectMapper.class);
List<User> users = mapper.getAllUser();
users.forEach(System.out::println);
}
}

5.2 查询单个数据

在MyBatis中,对于Java中常用的类型都设置了类型别名

  • java.lang.Integer—>int|integer
  • int—>_int|_integer
  • Map—>map,List—>list

代码示例

1
2
3
4
/**
* 查询用户信息的总记录数
*/
Integer getCount();
1
2
3
<select id="getCount" resultType="java.lang.Integer">
select count(*) from t_user
</select>

注:这里的resultType也可以写成:intInteger

1
2
3
4
5
6
7
@Test
public void test2() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
SelectMapper mapper = sqlSession.getMapper(SelectMapper.class);
Integer count = mapper.getCount();
System.out.println(count); // 4
}

5.3 查询一条数据为map集合

代码示例

1
2
3
4
/**
* 根据id查询用户信息为一个map集合
*/
Map<String, Object> getUserByIdToMap(@Param("id") Integer id);
1
2
3
<select id="getUserByIdToMap" resultType="map">
select * from t_user where id = #{id}
</select>

注意这里的resultType

1
2
3
4
5
6
7
@Test
public void test3() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
SelectMapper mapper = sqlSession.getMapper(SelectMapper.class);
Map<String, Object> map = mapper.getUserByIdToMap(1);
System.out.println(map);
}

打印结果:

1
{password=123456, sex=男, id=1, age=24, email=123456@qq.com, username=Mark}

5.4 查询多条数据为map集合

  • 方式一:将表中的数据以map集合的方式查询,一条数据对应一个map;若有多条数据,就会产生多个map集合,此时可以将这些map放在一个list集合中获取

代码示例

1
2
3
4
/**
* 查询所有用户为map
*/
List<Map<String, Object>> getAllUserToMap();
1
2
3
<select id="getAllUserToMap" resultType="map">
select * from t_user
</select>
1
2
3
4
5
6
7
@Test
public void test4() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
SelectMapper mapper = sqlSession.getMapper(SelectMapper.class);
List<Map<String, Object>> list = mapper.getAllUserToMap();
list.forEach(System.out::println);
}

打印结果:

1
2
3
4
{password=123456, sex=男, id=1, age=24, email=123456@qq.com, username=Mark}
{password=123, sex=女, id=6, age=23, email=123456@163.com, username=张三}
{password=123, sex=女, id=7, age=23, email=123456@163.com, username=张三}
{password=12345678, sex=男, id=9, age=24, email=12345678@qq.com, username=Hongyi}
  • 方式二:将表中的数据以map集合的方式查询,一条数据对应一个map;若有多条数据,就会产生多个map集合,并且最终要以一个map的方式返回数据,此时需要通过@MapKey注解设置map集合的键,值是每条数据所对应的map集合

代码示例

1
2
3
4
5
/**
* 查询所有用户为map
*/
@MapKey("id")
Map<String, Object> getAllUserToMap();
1
2
3
<select id="getAllUserToMap" resultType="map">
select * from t_user
</select>
1
2
3
4
5
6
7
@Test
public void test4() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
SelectMapper mapper = sqlSession.getMapper(SelectMapper.class);
Map<String, Object> map = mapper.getAllUserToMap();
System.out.println(map);
}

打印结果:

1
{1={password=123456, sex=男, id=1, age=24, email=123456@qq.com, username=Mark}, 6={password=123, sex=女, id=6, age=23, email=123456@163.com, username=张三}, 7={password=123, sex=女, id=7, age=23, email=123456@163.com, username=张三}, 9={password=12345678, sex=男, id=9, age=24, email=12345678@qq.com, username=Hongyi}}

6 特殊SQL的执行

6.1 模糊查询

使用#{}时,执行模糊查询会使用?进行占位,在单引号中会被解析为字符串,因此占位符失效:

image-20220605113253725

  • 方法一:使用${}
1
2
3
4
/**
* 根据用户名模糊查询用户信息
*/
List<User> getUserByLike(@Param("username") String username);
1
2
3
<select id="getUserByLike" resultType="User">
select * from t_user where username like '%${username}%'
</select>
1
2
3
4
5
6
7
8
@Test
public void test0() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
SQLMapper mapper = sqlSession.getMapper(SQLMapper.class);
// 传的是字符串,#{}会自动添加单引号
List<User> list = mapper.getUserByLike("三");
list.forEach(System.out::println);
}
  • 方法二:使用#{}concat进行字符串拼接
1
2
3
4
<select id="getUserByLike" resultType="User">
<!-- select * from t_user where username like '%${username}%' -->
select * from t_user where username like concat('%', #{username}, '%')
</select>
  • 方法三:使用双引号拼接(常用
1
2
3
<select id="getUserByLike" resultType="User">
select * from t_user where username like "%"#{username}"%"
</select>

6.2 批量删除

只能够使用${},因为#{}会自动对字符串添加单引号,导致sql语句不正确。

1
2
3
4
/**
* 批量删除
*/
int deleteMore(@Param("ids") String ids);
1
2
3
<delete id="deleteMore">
delete from t_user where id in(${ids})
</delete>
1
2
3
4
5
6
7
8
@Test
public void test1() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
SQLMapper mapper = sqlSession.getMapper(SQLMapper.class);
// 传的是字符串,#{}会自动添加单引号
int result = mapper.deleteMore("1, 2, 3");
System.out.println(result);
}

6.3 动态设置表名

只能够使用${},因为#{}会自动对字符串添加单引号,导致sql语句不正确。

1
2
3
4
/**
* 查询指定表中的数据
*/
List<User> getUserByTableName(@Param("tableName") String tableName);
1
2
3
<select id="getUserByTableName" resultType="User">
select * from ${tableName}
</select>
1
2
3
4
5
6
7
8
@Test
public void test2() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
SQLMapper mapper = sqlSession.getMapper(SQLMapper.class);
// 传的是字符串,#{}会自动添加单引号
List<User> list = mapper.getUserByTableName("t_user");
list.forEach(System.out::println);
}

6.4 获取自增的主键

insert标签的两个属性:

  • useGeneratedKeys:设置使用自增的主键
  • keyProperty:因为增删改有统一的返回值是受影响的行数,因此只能将获取的自增的主键放在传输的参数user对象的某个属性中 ,例如就将其赋值给User的id属性。

代码示例

1
2
3
4
/**
* 添加用户信息
*/
void insertUser(User user);
1
2
3
<insert id="insertUser" useGeneratedKeys="true" keyProperty="id">
insert into t_user values(null, #{username}, #{password}, #{age}, #{sex}, #{email})
</insert>
1
2
3
4
5
6
7
8
9
@Test
public void test3() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
SQLMapper mapper = sqlSession.getMapper(SQLMapper.class);
User user = new User(null, "Kisugi", "123", 24, "男", "123@123.com");
mapper.insertUser(user);
// 打印获取到的主键
System.out.println(user.getId());
}

7 自定义映射resultMap

7.1 准备工作

新建表

新建两张表:t_empt_dept,表结构如下:

image-20220605122146502

image-20220605122154149

实体类

1
2
3
4
5
6
7
8
9
10
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Emp {
private Integer eid;
private String empName;
private Integer age;
private String sex;
private String email;
}
1
2
3
4
5
6
7
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Dept {
private Integer did;
private String deptName;
}

注意:按照开发经验,数据库中的字段名称采用下划线规则,而类中属性名称采用驼峰规则,所以二者映射并不一致。

7.2 处理字段和属性的映射关系

若字段名和实体类中的属性名不一致,则可以通过resultMap设置自定义映射。

  • 方法一:给字段起一个别名,保持和属性名的一致
1
2
3
4
/**
* 查询所有员工信息
*/
List<Emp> getAllEmp();
1
2
3
<select id="getAllEmp" resultType="Emp">
select eid,emp_name empName, age, sex, email from t_emp
</select>
1
2
3
4
5
6
7
@Test
public void test0() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);
List<Emp> list = mapper.getAllEmp();
list.forEach(System.out::println);
}
  • 方法二:可以在MyBatis的核心配置文件中设置一个全局配置信息mapUnderscoreToCamelCase,可以在查询表中数据时,自动将_类型的字段名转换为驼峰
1
2
3
4
<!-- 设置mybatis的全局配置 -->
<settings>
<setting name="mapUnderscoreToCamelCase" value="true"/>
</settings>
  • 方法三:可以通过resultMap设置自定义映射,此时需要设置所有的字段,这种方法最常用
    • resultMap:设置自定义映射,属性有下
      • id:表示自定义映射的唯一标识
      • type:查询的数据要映射的实体类的类型
    • 子标签和对应属性如下:
      • id:设置主键的映射关系
      • result:设置普通字段的映射关系
      • association:设置多对一的映射关系(详见7.3.2
      • collection:设置一对多的映射关系 (详见7.4.1
        • property:设置映射关系中实体类中的属性名
        • column:设置映射关系中表中的字段名
1
2
3
4
5
6
7
8
9
10
11
<resultMap id="empResultMap" type="Emp">
<id property="eid" column="eid"/>
<result property="empName" column="emp_name"/>
<result property="password" column="password"/>
<result property="age" column="age"/>
<result property="sex" column="sex"/>
</resultMap>

<select id="getAllEmp" resultMap="empResultMap">
select * from t_emp
</select>

7.3 多对一映射处理

多个员工对应一个部门

需求:查询员工信息以及员工所对应的部门信息

1
2
3
4
5
6
7
8
9
public class Emp {
private Integer eid;
private String empName;
private Integer age;
private String sex;
private String email;
// 部门信息
private Dept dept;
}

7.3.1 级联方式处理映射关系

该方法不常用。

1
2
3
4
/**
* 查询员工信息以及员工所对应的部门信息
*/
Emp getEmpAndDept(@Param("eid") Integer eid);
1
2
3
4
5
6
7
8
9
10
11
12
13
<resultMap id="empAndDeptResultMapOne" type="Emp">
<id property="eid" column="eid"/>
<result property="empName" column="emp_name"/>
<result property="password" column="password"/>
<result property="age" column="age"/>
<result property="sex" column="sex"/>
<result property="dept.did" column="did"/>
<result property="dept.deptName" column="dept_name"/>
</resultMap>

<select id="getEmpAndDept" resultMap="empAndDeptResultMapOne">
select * from t_emp left join t_dept on t_emp.did = t_dept.did where t_emp.eid = #{eid}
</select>
1
2
3
4
5
6
7
@Test
public void test1() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);
Emp emp = mapper.getEmpAndDept(1);
System.out.println(emp);
}

打印结果:

1
Emp(eid=1, empName=张三, age=24, sex=男, email=123@123.com, dept=Dept(did=1, deptName=A))

7.3.2 association处理映射关系

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
<resultMap id="empAndDeptResultMapTwo" type="Emp">
<id property="eid" column="eid"/>
<result property="empName" column="emp_name"/>
<result property="password" column="password"/>
<result property="age" column="age"/>
<result property="sex" column="sex"/>
<association property="dept" javaType="Dept">
<id property="did" column="did"/>
<result property="deptName" column="dept_name"/>
</association>
</resultMap>

<select id="getEmpAndDept" resultMap="empAndDeptResultMapTwo">
select * from t_emp left join t_dept on t_emp.did = t_dept.did where t_emp.eid = #{eid}
</select>

注:javaType是属性dept的类型,association相当于resultMap的套娃形式

7.3.3 分步查询

这种方法最常用。

  • 首先查询员工信息
1
2
3
4
/**
* 分步查询,第一步:查询员工信息
*/
Emp getEmpAndDeptByStepOne(@Param("eid") Integer eid);
1
2
3
4
5
6
7
8
9
10
11
12
<resultMap id="empAndDeptByStepResultMap" type="Emp">
<id property="eid" column="eid"/>
<result property="empName" column="emp_name"/>
<result property="password" column="password"/>
<result property="age" column="age"/>
<result property="sex" column="sex"/>
<association property="dept" select="com.hongyi.mapper.DeptMapper.getEmpAndDeptByStepTwo" column="did"/>
</resultMap>

<select id="getEmpAndDeptByStepOne" resultMap="empAndDeptByStepResultMap">
select * from t_emp where eid = #{eid}
</select>

注意:

  1. select:设置分步查询,查询某个属性的值的sql的标识(namespace.sqlId)
  2. column:将sql以及查询结果中的某个字段设置为分步查询的条件
  • 第二步:通过员工信息查询部门信息(在Dept的mapper接口中)
1
2
3
4
/**
* 分步查询,第二步:通过did查询员工的部门信息
*/
Dept getEmpAndDeptByStepTwo(@Param("did") Integer did);
1
2
3
<select id="getEmpAndDeptByStepTwo" resultType="Dept">
select * from t_dept where did = #{did}
</select>
  • 测试方法:
1
2
3
4
5
6
7
@Test
public void test2() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);
Emp emp = mapper.getEmpAndDeptByStepOne(1);
System.out.println(emp);
}

执行结果:可以看到连续执行了两条sql语句

image-20220605150800527

  • 分步查询优点:可以实现延迟加载,但是必须在核心配置文件中设置全局配置信息

    • lazyLoadingEnabled:延迟加载的全局开关。当开启时,所有关联对象都会延迟加载

    • aggressiveLazyLoading:当开启时,任何方法的调用都会加载该对象的所有属性。 否则,每个属性会按需加载

此时就可以实现按需加载,获取的数据是什么,就只会执行相应的sql。此时可通过association和collection中的fetchType属性设置当前的分步查询是否使用延迟加载,fetchType=”lazy(延迟加载)|eager(立即加载)”

1
2
3
4
<settings>
<!-- 开启延迟加载 -->
<setting name="lazyLoadingEnables" value="true"/>
</settings>
1
2
3
4
5
6
7
8
@Test
public void test2() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);
Emp emp = mapper.getEmpAndDeptByStepOne(1);
// 只获取与emp相关的属性,不获取与dept的属性,例如打印员工的姓名
System.out.println(emp.getEmpName());
}

打印结果:

image-20220605171048919

发现只执行了一条sql语句,即第一步查询,第二步查询并未执行。

以上是在全局开启延迟加载,手动单独关闭或开启延迟加载可以如下操作,即利用fetchType=”lazy(延迟加载)|eager(立即加载)”。

1
2
3
4
5
<association
property="dept"
select="com.hongyi.mapper.DeptMapper.getEmpAndDeptByStepTwo"
column="did"
fetchType="eager"/>

执行结果:

image-20220605171353204

发现两条sql均执行了

7.4 一对多映射处理

一个部门对应多个员工。

需求:根据部门id查询部门以及部门中的员工信息

1
2
3
4
5
public class Dept {
private Integer did;
private String deptName;
private List<Emp> emps;
}

7.4.1 利用collection

  • collection:处理一对多的映射关系
  • ofType:设置collection标签所处理的集合属性中存储数据的类型,例如根据部门id查询到多个EMP员工,将其放入集合中
1
2
3
4
/**
* 根据部门id查询部门以及部门中的员工信息
*/
Dept getDeptAndEmp(@Param("did") Integer did);
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
<resultMap id="deptAndEmpResultMap" type="Dept">
<id property="did" column="did"/>
<result property="deptName" column="dept_name"/>
<collection property="emps" ofType="Emp">
<id property="eid" column="eid"/>
<result property="empName" column="emp_name"/>
<result property="password" column="password"/>
<result property="age" column="age"/>
<result property="sex" column="sex"/>
</collection>
</resultMap>

<select id="getDeptAndEmp" resultMap="deptAndEmpResultMap">
select * from t_dept left join t_emp on t_dept.did = t_emp.did where t_dept.did = #{did}
</select>
1
2
3
4
5
6
7
@Test
public void test3() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
DeptMapper mapper = sqlSession.getMapper(DeptMapper.class);
Dept dept = mapper.getDeptAndEmp(1);
System.out.println(dept);
}

打印结果:

1
Dept(did=1, deptName=A, emps=[Emp(eid=1, empName=张三, age=24, sex=男, email=null, dept=null), Emp(eid=2, empName=李四, age=24, sex=男, email=null, dept=null)])

7.4.2 分步查询

  • 首先查询部门
1
2
3
4
/**
* 第一步:分步查询部门信息
*/
Dept getDeptAndEmpByStepOne(@Param("did") Integer did);
1
2
3
4
5
6
7
8
9
10
11
<resultMap id="deptAndEmpByStepResultMap" type="Dept">
<id property="did" column="did"/>
<result property="deptName" column="dept_name"/>
<collection property="emps"
select="com.hongyi.mapper.EmpMapper.getDeptAndEmpByStepTwo"
column="did"/>
</resultMap>

<select id="getDeptAndEmpByStepOne" resultMap="deptAndEmpByStepResultMap">
select * from t_dept where did = #{did}
</select>
  • 第二步:通过did查询员工信息
1
2
3
4
/**
* 第二步:根据did查询员工信息
*/
List<Emp> getDeptAndEmpByStepTwo(@Param("did") Integer did);
1
2
3
<select id="getDeptAndEmpByStepTwo" resultType="Emp">
select * from t_emp where did = #{did}
</select>
  • 测试
1
2
3
4
5
6
7
@Test
public void test4() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
DeptMapper mapper = sqlSession.getMapper(DeptMapper.class);
Dept dept = mapper.getDeptAndEmpByStepOne(1);
System.out.println(dept);
}

执行结果:

image-20220605173645655

8 动态SQL

Mybatis框架的动态SQL技术是一种根据特定条件动态拼装SQL语句的功能,它存在的意义是为了解决拼接SQL语句字符串时的痛点问题(多条件查询)。

8.1 if标签

if标签可通过test属性的表达式进行判断,若表达式的结果为true,则标签中的内容会执行(拼接到SQL语句中);反之标签中的内容不会执行。

代码示例

1
2
3
4
/**
* 多条件查询
*/
List<Emp> getEmpByCondition(Emp emp);
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
<select id="getEmpByCondition" resultType="Emp">
<!--注意1=1的作用-->
select * from t_emp where 1 = 1
<if test="empName != null and empName != ''">
and emp_name = #{empName}
</if>
<if test="age != null and age!= ''">
and age = #{age}
</if>
<if test="sex != null and sex!= ''">
and sex = #{sex}
</if>
<if test="email != null and email!= ''">
and email = #{email}
</if>
</select>
1
2
3
4
5
6
7
8
@Test
public void test0() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
DynamicSQLMapper mapper = sqlSession.getMapper(DynamicSQLMapper.class);
Emp emp = new Emp(null, "", null, "男", "123@123.com");
List<Emp> emps = mapper.getEmpByCondition(emp);
emps.forEach(System.out::println);
}

发现姓名和年龄并不符合条件查询的条件,因此在执行SQL时会去掉这两个条件。

执行结果如下:

image-20220606112843652

可以看到只对符合条件的sex和email进行查询。

8.2 where标签

  • 当where标签中有内容时,会自动生成where关键字,并且将内容前多余的and或or去掉。
  • 当where标签中没有内容时,此时where标签没有任何效果。

  • where和if一般结合使用:

    • 若where标签中的if条件都不满足,则where标签没有任何功能,即不会添加where关键字
    • 若where标签中的if条件满足,则where标签会自动添加where关键字,并将条件最前方多余的and去掉
    • 注意:where标签不能去掉每个条件最后多余的and

代码示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
<select id="getEmpByCondition2" resultType="Emp">
select * from t_emp
<where>
<if test="empName != null and empName != ''">
and emp_name = #{empName}
</if>
<if test="age != null and age!= ''">
and age = #{age}
</if>
<if test="sex != null and sex!= ''">
and sex = #{sex}
</if>
<if test="email != null and email!= ''">
and email = #{email}
</if>
</where>
</select>
1
2
3
4
5
6
7
8
@Test
public void test0() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
DynamicSQLMapper mapper = sqlSession.getMapper(DynamicSQLMapper.class);
Emp emp = new Emp(null, "", 24, "", "123@123.com");
List<Emp> emps = mapper.getEmpByCondition2(emp);
emps.forEach(System.out::println);
}

执行结果:

1
2
3
4
5
6
7
8
DEBUG 06-06 11:33:18,866 ==>  Preparing: select * from t_emp WHERE age = ? and email = ? (BaseJdbcLogger.java:137) 
DEBUG 06-06 11:33:18,896 ==> Parameters: 24(Integer), 123@123.com(String) (BaseJdbcLogger.java:137)
DEBUG 06-06 11:33:18,925 <== Total: 5 (BaseJdbcLogger.java:137)
Emp(eid=1, empName=张三, age=24, sex=男, email=123@123.com, dept=null)
Emp(eid=2, empName=李四, age=24, sex=男, email=123@123.com, dept=null)
Emp(eid=3, empName=王五, age=24, sex=男, email=123@123.com, dept=null)
Emp(eid=4, empName=赵六, age=24, sex=女, email=123@123.com, dept=null)
Emp(eid=5, empName=田七, age=24, sex=男, email=123@123.com, dept=null)

8.3 trim标签

  • trim用于去掉或添加标签中的内容:
  • 常用属性:
    • prefix:在trim标签中的内容的前面添加某些内容
    • prefixOverrides:在trim标签中的内容的前面去掉某些内容
    • suffix:在trim标签中的内容的后面添加某些内容
    • suffixOverrides:在trim标签中的内容的后面去掉某些内容

代码示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
<select id="getEmpByCondition3" resultType="Emp">
select * from t_emp
<trim prefix="where" suffixOverrides="and|or">
<if test="empName != null and empName != ''">
emp_name = #{empName} and
</if>
<if test="age != null and age!= ''">
age = #{age} or
</if>
<if test="sex != null and sex!= ''">
sex = #{sex} and
</if>
<if test="email != null and email!= ''">
email = #{email}
</if>
</trim>
</select>

8.4 choose|when|otherwise标签

choose、when、otherwise相当于if...else if..else

代码略

8.5 foreach标签

代码略

8.6 SQL标签

sql片段(标签),可以记录一段公共sql片段,在使用的地方通过include标签进行引入。

代码示例

1
2
3
4
5
<sql id="empColumns"> 
eid,ename,age,sex,did
</sql>
<!--使用-->
select <include refid="empColumns"></include> from t_emp

9 MyBatis缓存

缓存机制只对查询功能有效。

9.1 一级缓存

一级缓存是SqlSession级别的,通过同一个SqlSession查询的数据会被缓存,下次查询相同的数据,就会从缓存中直接获取,不会从数据库重新访问。

代码演示1

1
2
3
4
5
6
7
8
9
@Test
public void test0() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
CacheMapper mapper = sqlSession.getMapper(CacheMapper.class);
Emp emp1 = mapper.getEmpByEid(1);
System.out.println(emp1);
Emp emp2 = mapper.getEmpByEid(1);
System.out.println(emp2);
}

执行结果:

1
2
3
4
5
DEBUG 06-06 15:44:32,474 ==>  Preparing: select * from t_emp where eid = ? (BaseJdbcLogger.java:137) 
DEBUG 06-06 15:44:32,519 ==> Parameters: 1(Integer) (BaseJdbcLogger.java:137)
DEBUG 06-06 15:44:32,551 <== Total: 1 (BaseJdbcLogger.java:137)
Emp(eid=1, empName=张三, age=24, sex=男, email=123@123.com, dept=null)
Emp(eid=1, empName=张三, age=24, sex=男, email=123@123.com, dept=null)

发现只执行了一次sql,原因:第二次是直接从缓存中取得的数据,而不是执行sql从数据库中取得数据。

代码演示2

1
2
3
4
5
6
7
8
9
10
@Test
public void test0() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
CacheMapper mapper1 = sqlSession.getMapper(CacheMapper.class);
Emp emp1 = mapper1.getEmpByEid(1);
System.out.println(emp1);
CacheMapper mapper2 = sqlSession.getMapper(CacheMapper.class);
Emp emp2 = mapper2.getEmpByEid(1);
System.out.println(emp2);
}

执行结果:

1
2
3
4
5
DEBUG 06-06 15:47:33,176 ==>  Preparing: select * from t_emp where eid = ? (BaseJdbcLogger.java:137) 
DEBUG 06-06 15:47:33,213 ==> Parameters: 1(Integer) (BaseJdbcLogger.java:137)
DEBUG 06-06 15:47:33,251 <== Total: 1 (BaseJdbcLogger.java:137)
Emp(eid=1, empName=张三, age=24, sex=男, email=123@123.com, dept=null)
Emp(eid=1, empName=张三, age=24, sex=男, email=123@123.com, dept=null)

发现在同一个SQLSession中查询的数据时会被缓存的。

代码演示3

1
2
3
4
5
6
7
8
9
10
11
@Test
public void test0() {
SqlSession sqlSession1 = SqlSessionUtils.getSqlSession();
CacheMapper mapper1 = sqlSession1.getMapper(CacheMapper.class);
Emp emp1 = mapper1.getEmpByEid(1);
System.out.println(emp1);
SqlSession sqlSession2 = SqlSessionUtils.getSqlSession();
CacheMapper mapper2 = sqlSession2.getMapper(CacheMapper.class);
Emp emp2 = mapper2.getEmpByEid(1);
System.out.println(emp2);
}

执行结果:

1
2
3
4
5
6
7
8
DEBUG 06-06 15:49:09,032 ==>  Preparing: select * from t_emp where eid = ? (BaseJdbcLogger.java:137) 
DEBUG 06-06 15:49:09,076 ==> Parameters: 1(Integer) (BaseJdbcLogger.java:137)
DEBUG 06-06 15:49:09,118 <== Total: 1 (BaseJdbcLogger.java:137)
Emp(eid=1, empName=张三, age=24, sex=男, email=123@123.com, dept=null)
DEBUG 06-06 15:49:09,247 ==> Preparing: select * from t_emp where eid = ? (BaseJdbcLogger.java:137)
DEBUG 06-06 15:49:09,248 ==> Parameters: 1(Integer) (BaseJdbcLogger.java:137)
DEBUG 06-06 15:49:09,250 <== Total: 1 (BaseJdbcLogger.java:137)
Emp(eid=1, empName=张三, age=24, sex=男, email=123@123.com, dept=null)

结论:一级缓存默认开启,且作用域仅限于SqlSession内


使一级缓存失效的四种情况:

  1. 不同的SqlSession对应不同的一级缓存
  2. 同一个SqlSession但是查询条件不同(查询到新的数据)
  3. 同一个SqlSession两次查询期间执行了任何一次增删改操作
  4. 同一个SqlSession两次查询期间手动清空了缓存
1
2
3
4
5
6
7
8
9
10
11
12
@Test
public void test0() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
CacheMapper mapper1 = sqlSession.getMapper(CacheMapper.class);
Emp emp1 = mapper1.getEmpByEid(1);
System.out.println(emp1);
// 清空缓存
sqlSession.clearCache();
CacheMapper mapper2 = sqlSession.getMapper(CacheMapper.class);
Emp emp2 = mapper2.getEmpByEid(1);
System.out.println(emp2);
}

9.2 二级缓存

9.2.1 基本说明和使用

二级缓存是SqlSessionFactory级别,通过同一个SqlSessionFactory创建的SqlSession查询的结果会被缓存;此后若再次执行相同的查询语句,结果就会从缓存中获取。

  • 二级缓存开启的条件:

    • 在核心配置文件中,设置全局配置属性cacheEnabled="true",默认为true,所以不需要设置
    • 在映射文件中设置标签<cache/>
    • 二级缓存必须在SqlSession关闭(close)或提交(commit)之后有效
    • 查询的数据所转换的实体类类型必须实现序列化的接口

      1
      2
      3
      public class Emp implements Serializable {
      // ...
      }
  • 使二级缓存失效的情况:两次查询之间执行了任意的增删改,会使一级和二级缓存同时失效

代码示例

1
2
3
4
5
6
<mapper namespace="com.hongyi.mapper.CacheMapper">
<cache/>
<select id="getEmpByEid" resultType="Emp">
select * from t_emp where eid = #{eid}
</select>
</mapper>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
@Test
public void test1() {
try {
InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
SqlSession sqlSession1 = sqlSessionFactory.openSession(true);
CacheMapper mapper1 = sqlSession1.getMapper(CacheMapper.class);
System.out.println(mapper1.getEmpByEid(1));
// 关闭连接
sqlSession1.close();
SqlSession sqlSession2 = sqlSessionFactory.openSession(true);
CacheMapper mapper2 = sqlSession2.getMapper(CacheMapper.class);
System.out.println(mapper2.getEmpByEid(1));
// 关闭连接
sqlSession2.close();
} catch (IOException e) {
e.printStackTrace();
}
}

执行结果:

1
2
3
4
5
6
7
DEBUG 06-06 16:12:05,301 Cache Hit Ratio [com.hongyi.mapper.CacheMapper]: 0.0 (LoggingCache.java:60) 
DEBUG 06-06 16:12:05,872 ==> Preparing: select * from t_emp where eid = ? (BaseJdbcLogger.java:137)
DEBUG 06-06 16:12:05,919 ==> Parameters: 1(Integer) (BaseJdbcLogger.java:137)
DEBUG 06-06 16:12:05,965 <== Total: 1 (BaseJdbcLogger.java:137)
Emp(eid=1, empName=张三, age=24, sex=男, email=123@123.com, dept=null)
DEBUG 06-06 16:12:05,990 Cache Hit Ratio [com.hongyi.mapper.CacheMapper]: 0.5 (LoggingCache.java:60)
Emp(eid=1, empName=张三, age=24, sex=男, email=123@123.com, dept=null)

发现只执行了一次sql语句。

9.2.2 相关配置

在mapper配置文件中添加的cache标签可以设置一些属性:

  • eviction属性:缓存回收策略

    • LRU(Least Recently Used) – 最近最少使用的:移除最长时间不被使用的对象。
    • FIFO(First in First out) – 先进先出:按对象进入缓存的顺序来移除它们。
    • SOFT – 软引用:移除基于垃圾回收器状态和软引用规则的对象。
    • WEAK – 弱引用:更积极地移除基于垃圾收集器状态和弱引用规则的对象。
    • 默认的是 LRU。
  • flushInterval属性:刷新间隔,单位毫秒

    • 默认情况是不设置,也就是没有刷新间隔,缓存仅仅调用语句时刷新
  • size属性:引用数目,正整数

    • 代表缓存最多可以存储多少个对象,太大容易导致内存溢出
  • readOnly属性:只读,true/false

    • true:只读缓存;会给所有调用者返回缓存对象的相同实例。因此这些对象不能被修改。这提供了很重要的性能优势。
    • false:读写缓存;会返回缓存对象的拷贝(通过序列化)。这会慢一些,但是安全,因此默认是false。

9.3 缓存查询的顺序

  • 先查询二级缓存,因为二级缓存中可能会有其他程序已经查出来的数据,可以拿来直接使用。
  • 如果二级缓存没有命中,再查询一级缓存
  • 如果一级缓存也没有命中,则查询数据库
  • SqlSession关闭之前,数据缓存在一级缓存,SqlSession关闭之后,一级缓存中的数据会写入二级缓存

9.4 整合第三方缓存EHCache

9.4.1 添加依赖

1
2
3
4
5
6
7
8
9
10
11
12
<!-- Mybatis EHCache整合包 --> 
<dependency>
<groupId>org.mybatis.caches</groupId>
<artifactId>mybatis-ehcache</artifactId>
<version>1.2.1</version>
</dependency>
<!-- slf4j日志门面的一个具体实现 -->
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-classic</artifactId>
<version>1.2.3</version>
</dependency>

9.4.2 配置

  • 创建EHCache的配置文件ehcache.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
<?xml version="1.0" encoding="utf-8" ?> 
<ehcache xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="../config/ehcache.xsd">
<!-- 磁盘保存路径 -->
<diskStore path="D:\atguigu\ehcache"/>
<defaultCache
maxElementsInMemory="1000"
maxElementsOnDisk="10000000"
eternal="false"
overflowToDisk="true"
timeToIdleSeconds="120"
timeToLiveSeconds="120"
diskExpiryThreadIntervalSeconds="120"
memoryStoreEvictionPolicy="LRU">
</defaultCache>
</ehcache>
  • 设置二级缓存的类型
1
<cache type="org.mybatis.caches.ehcache.EhcacheCache"/>
  • 加入logback日志

存在SLF4J时,作为简易日志的log4j将失效,此时我们需要借助SLF4J的具体实现logback来打印日志。

创建logback的配置文件logback.xml

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
<?xml version="1.0" encoding="UTF-8"?> 
<configuration debug="true">
<!-- 指定日志输出的位置 -->
<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
<encoder>
<!-- 日志输出的格式 -->
<!-- 按照顺序分别是:时间、日志级别、线程名称、打印日志的类、日志主体内容、换行 -->
<pattern>[%d{HH:mm:ss.SSS}] [%-5level] [%thread] [%logger] [%msg]%n
</pattern>
</encoder>
</appender>
<!-- 设置全局日志级别。日志级别按顺序分别是:DEBUG、INFO、WARN、ERROR --> <!-- 指定任何一个日志级别都只打印当前级别和后面级别的日志。 -->
<root level="DEBUG">
<!-- 指定打印日志的appender,这里通过“STDOUT”引用了前面配置的appender -->
<appender-ref ref="STDOUT" />
</root>
<!-- 根据特殊需求指定局部日志级别 -->
<logger name="com.atguigu.crowd.mapper" level="DEBUG"/>
</configuration>

10 MyBatis逆向工程

  • 正向工程:先创建Java实体类,由框架负责根据实体类生成数据库表。Hibernate是支持正向工程的。

  • 逆向工程:先创建数据库表,由框架负责根据数据库表,反向生成如下资源:

    • Java实体类
    • Mapper接口
    • Mapper映射文件

10.1 配置

  • 添加依赖和插件
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
<!-- 依赖MyBatis核心包 --> 
<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.7</version>
</dependency>
</dependencies>

<!-- 控制Maven在构建过程中相关配置 -->
<build>
<!-- 构建过程中用到的插件 -->
<plugins>
<!-- 具体插件,逆向工程的操作是以构建过程中插件形式出现的 -->
<plugin>
<groupId>org.mybatis.generator</groupId>
<artifactId>mybatis-generator-maven-plugin</artifactId>
<version>1.3.0</version>
<!-- 插件的依赖 -->
<dependencies>
<!-- 逆向工程的核心依赖 -->
<dependency>
<groupId>org.mybatis.generator</groupId>
<artifactId>mybatis-generator-core</artifactId>
<version>1.3.2</version>
</dependency>
<!-- 数据库连接池 -->
<dependency>
<groupId>com.mchange</groupId>
<artifactId>c3p0</artifactId>
<version>0.9.2</version>
</dependency>
<!-- MySQL驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.8</version>
</dependency>
</dependencies>
</plugin>
</plugins>
</build>
  • 创建mybatis核心配置文件
  • 创建逆向工程的配置文件

文件名必须是:generatorConfig.xml

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE generatorConfiguration
PUBLIC "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN"
"http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd">
<generatorConfiguration>
<!--
targetRuntime: 执行生成的逆向工程的版本
MyBatis3Simple: 生成基本的CRUD(清新简洁版)
MyBatis3: 生成带条件的CRUD(奢华尊享版)
-->
<context id="DB2Tables" targetRuntime="MyBatis3Simple">
<!-- 数据库的连接信息 -->
<jdbcConnection
driverClass="com.mysql.jdbc.Driver"
connectionURL="jdbc:mysql://localhost:3306/test"
userId="root"
password="12345678">
</jdbcConnection>
<!-- javaBean的生成策略-->
<javaModelGenerator targetPackage="com.hongyi.pojo" targetProject=".\src\main\java">
<property name="enableSubPackages" value="true" />
<property name="trimStrings" value="true" />
</javaModelGenerator>
<!-- SQL映射文件的生成策略 -->
<sqlMapGenerator targetPackage="com.hongyi.mapper" targetProject=".\src\main\resources">
<property name="enableSubPackages" value="true" />
</sqlMapGenerator>
<!-- Mapper接口的生成策略 -->
<javaClientGenerator type="XMLMAPPER" targetPackage="com.hongyi.mapper" targetProject=".\src\main\java">
<property name="enableSubPackages" value="true" />
</javaClientGenerator>
<!-- 逆向分析的表 -->
<!-- tableName设置为*号,可以对应所有表,此时不写domainObjectName -->
<!-- domainObjectName属性指定生成出来的实体类的类名 -->
<table tableName="t_emp" domainObjectName="Emp"/>
<table tableName="t_dept" domainObjectName="Dept"/>
</context>
</generatorConfiguration>

执行结果

双击下图所示按钮:

image-20220606165558612

即可生成:

image-20220606165636857

10.2 QBC查询

11 分页

11.1 配置

  • 添加依赖
1
2
3
4
5
6
<!-- https://mvnrepository.com/artifact/com.github.pagehelper/pagehelper --> 
<dependency>
<groupId>com.github.pagehelper</groupId>
<artifactId>pagehelper</artifactId>
<version>5.2.0</version>
</dependency>
  • 配置分页插件:在MyBatis的核心配置文件中配置插件
1
2
3
4
<plugins>
<!--设置分页插件-->
<plugin interceptor="com.github.pagehelper.PageInterceptor"/>
</plugins>

11.2 使用

  • 在查询功能之前使用PageHelper.startPage(int pageNum, int pageSize)开启分页功能

    • pageNum:当前页的页码
    • pageSize:每页显示的条数
  • 在查询获取list集合之后,使用PageInfo<T> pageInfo = new PageInfo<>(List<T> list, intnavigatePages)获取分页相关数据

    • list:分页之后的数据
    • navigatePages:导航分页的页码数,例如值为3,则展示第2页时显示的为1 2 3
  • 分页相关数据:

    • pageNum:当前页的页码
    • pageSize:每页显示的条数
    • size:当前页显示的真实条数
    • total:总记录数
    • pages:总页数
    • prePage:上一页的页码
    • nextPage:下一页的页码
    • isFirstPage/isLastPage:是否为第一页/最后一页
    • hasPreviousPage/hasNextPage:是否存在上一页/下一页
    • navigatePages:导航分页的页码数
    • navigatepageNums:导航分页的页码,[1,2,3,4,5]

代码示例1

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
/**
* limit, index, pageSize
* index:当前页的起始索引
* pageSize:每页显示的条数
* pageNum:当前页的页码
* 关系: index = (pageNum - 1) * pageSize
*/
@Test
public void test0() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);
// 在查询之前开启分页:查询第1页,每页4条数据
PageHelper.startPage(1, 4);
List<Emp> list = mapper.selectByExample(null);
list.forEach(System.out::println);
}

代码示例2——获取分页对象(方法1)

1
2
3
4
5
6
7
8
9
10
@Test
public void test0() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);
// 在查询之前开启分页:查询第1页,每页4条数据
Page<Object> page = PageHelper.startPage(1, 4);
System.out.println(page);
List<Emp> list = mapper.selectByExample(null);
list.forEach(System.out::println);
}

打印结果:

1
Page{count=true, pageNum=1, pageSize=4, startRow=0, endRow=4, total=0, pages=0, reasonable=null, pageSizeZero=null}[]

代码示例3——获取分页对象(方法2)

1
2
3
4
5
6
7
8
9
10
@Test
public void test1() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);
PageHelper.startPage(1, 4);
List<Emp> list = mapper.selectByExample(null);
PageInfo<Emp> page = new PageInfo<>(list, 5);
System.out.println(page);
list.forEach(System.out::println);
}

打印结果:

1
PageInfo{pageNum=1, pageSize=4, size=4, startRow=1, endRow=4, total=14, pages=4, list=Page{count=true, pageNum=1, pageSize=4, startRow=0, endRow=4, total=14, pages=4, reasonable=false, pageSizeZero=false}[Emp(eid=1, empName=张三, age=24, sex=男, email=123@123.com, did=1), Emp(eid=2, empName=李四, age=24, sex=男, email=123@123.com, did=1), Emp(eid=3, empName=王五, age=24, sex=男, email=123@123.com, did=2), Emp(eid=4, empName=赵六, age=24, sex=女, email=123@123.com, did=2)], prePage=0, nextPage=2, isFirstPage=true, isLastPage=false, hasPreviousPage=false, hasNextPage=true, navigatePages=5, navigateFirstPage=1, navigateLastPage=4, navigatepageNums=[1, 2, 3, 4]}

image-20220606184504731

12 原理简介

整体流程如下:

img

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
@Test
public void test0() throws IOException {
// 加载核心配置文件
InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
// 获取SqlSessionFactoryBuilder
SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
// 获取SqlSessionFactory
SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(inputStream);
// 获取SqlSession
SqlSession sqlSession = sqlSessionFactory.openSession(true);
// 获取mapper接口的实现对象
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
// 测试功能
int result = mapper.insertUser();
// 提交事务
// sqlSession.commit();
System.out.println("result: " + result);
}

12.1 SqlSessionFactoryBuilder

SqlSessionFactoryBuilder是MyBatis中用于创建SqlSessionFactory的构建器,它负责解析mybatis-config.xml配置文件中的配置信息,并创建出SqlSessionFactory对象。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
public SqlSessionFactory build(Reader reader, String environment, Properties properties) {
SqlSessionFactory var5;
try {
// 解析mybatis-config.xml配置文件
// 信息都存放在Configuration对象中
XMLConfigBuilder parser = new XMLConfigBuilder(reader, environment, properties);
// 使用解析后的信息,创建SqlSessionFactory对象
var5 = this.build(parser.parse());
} catch (Exception var14) {
throw ExceptionFactory.wrapException("Error building SqlSession.", var14);
} finally {
ErrorContext.instance().reset();
try {
reader.close();
} catch (IOException var13) {

}
}
// 返回SqlSessionFactory对象
return var5;
}

其中,又调用了build的重载方法(第8行var5 = this.build(parser.parse());):

1
2
3
public SqlSessionFactory build(Configuration config) {
return new DefaultSqlSessionFactory(config);
}

DefaultSqlSessionFactory即是接口SqlSessionFactory的实现类:

1
2
3
4
5
6
7
8
public class DefaultSqlSessionFactory implements SqlSessionFactory {
private final Configuration configuration;

public DefaultSqlSessionFactory(Configuration configuration) {
this.configuration = configuration;
}
// openSession的重载方法...
}

12.2 SqlSessionFactory

SqlSessionFactory接口是线程安全的,SqlSessionFactory一旦被创建,应该在应用执行期间都存在。在应用运行期间不要重复创建多次,建议使用单例模式。

SqlSessionFactory是创建SqlSession的工厂。源码如下:

1
2
3
4
5
6
7
8
9
10
11
12
public interface SqlSessionFactory {
// 方法实现在实现类DefaultSqlSessionFactory中
SqlSession openSession();
SqlSession openSession(boolean var1);
SqlSession openSession(Connection var1);
SqlSession openSession(TransactionIsolationLevel var1);
SqlSession openSession(ExecutorType var1);
SqlSession openSession(ExecutorType var1, boolean var2);
SqlSession openSession(ExecutorType var1, TransactionIsolationLevel var2);
SqlSession openSession(ExecutorType var1, Connection var2);
Configuration getConfiguration();
}

调用openSession,返回SqlSession对象(SqlSession为接口,DefaultSqlSession为其实现类):

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
private SqlSession openSessionFromDataSource(ExecutorType execType, TransactionIsolationLevel level, boolean autoCommit) {
Transaction tx = null;

DefaultSqlSession var8;
try {
Environment environment = this.configuration.getEnvironment();
TransactionFactory transactionFactory = this.getTransactionFactoryFromEnvironment(environment);
tx = transactionFactory.newTransaction(environment.getDataSource(), level, autoCommit);
Executor executor = this.configuration.newExecutor(tx, execType);
var8 = new DefaultSqlSession(this.configuration, executor, autoCommit);
} catch (Exception var12) {
this.closeTransaction(tx);
throw ExceptionFactory.wrapException("Error opening session. Cause: " + var12, var12);
} finally {
ErrorContext.instance().reset();
}
// 返回DefaultSqlSession对象
return var8;
}

12.3 SqlSession

SqlSession是MyBatis的关键对象,是执行持久化操作的独享,类似于JDBC中的Connection。实现类为DefaultSqlSession

使用完SqlSession之后关闭Session很重要,应该确保使用finally块来关闭它。

源码:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
public interface SqlSession extends Closeable {
<T> T selectOne(String var1);
<T> T selectOne(String var1, Object var2);
<E> List<E> selectList(String var1);
<E> List<E> selectList(String var1, Object var2);
<E> List<E> selectList(String var1, Object var2, RowBounds var3);
<K, V> Map<K, V> selectMap(String var1, String var2);
<K, V> Map<K, V> selectMap(String var1, Object var2, String var3);
<K, V> Map<K, V> selectMap(String var1, Object var2, String var3, RowBounds var4);
<T> Cursor<T> selectCursor(String var1);
<T> Cursor<T> selectCursor(String var1, Object var2);
<T> Cursor<T> selectCursor(String var1, Object var2, RowBounds var3);
void select(String var1, Object var2, ResultHandler var3);
void select(String var1, ResultHandler var2);
void select(String var1, Object var2, RowBounds var3, ResultHandler var4);
int insert(String var1);
int insert(String var1, Object var2);
int update(String var1);
int update(String var1, Object var2);
int delete(String var1);
int delete(String var1, Object var2);
void commit();
void commit(boolean var1);
void rollback();
void rollback(boolean var1);
List<BatchResult> flushStatements();
void close();
void clearCache();
Configuration getConfiguration();
<T> T getMapper(Class<T> var1);
Connection getConnection();
}

关键代码:

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

思想:通过JDK的动态代理来实现,getMapper返回的即一个代理对象。