Mybatis总结

---

一、简介

1.什么是MyBatis

MyBatis中文文档点此进入

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

如何获得Mybatis？

• maven仓库:https://mvnrepository.com/artifact/org.mybatis/mybatis

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

• GitHub：https://github.com/mybatis/mybatis-3

---

2.持久化、持久层

数据持久化，是一个动作；持久层是完成持久化工作的代码块。

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

---

3.mybatis优点

• 使sql与代码分离，提高可以维护性
• 提供映射标签，支持对象与数据库的orm字段关系映射
• 提供对象关系映射标签，支持对象关系组件维护
• 提供xml标签，支持编写动态sql

---

二、第一个mybatis程序

搭建环境-->导入mybatis-->编写代码-->测试

1.搭建环境

搭建数据库

CREATE DATABASE `mybatis`;

-- 创建表
CREATE TABLE `user` {
	`id` INT(20) NOT NULL	PRIMARY KEY,
	`name` VARCHAR(30) DEFAULT NULL,
	`pwd` VARCHAR(30) DEFAULT NULL
} ENGINE=INNODB DEFAULT CHARSET=uff8;

-- 插入数据
INSERT INTO `user`(`id`,`name`,`pwd`) VALUES 
(1,'张三','123'),
(2,'李四','234'),
(3,'王五','345')

---

2.导入mybatis

1）创建maven项目
2）删除src
3）导入依赖

---

3.编写代码

1）创建一个子模块

3）连接数据库

2）编写mybatis的核心配置文件
在resources文件下创建一个mybatis-config.xml文件

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
  PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
  "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
  <environments default="development">
    <environment id="development">
      <transactionManager type="JDBC"/>
      <dataSource type="POOLED">
        <property name="driver" value="${driver}"/>
        <property name="url" value="${url}"/>
        <property name="username" value="${username}"/>
        <property name="password" value="${password}"/>
      </dataSource>
    </environment>
  </environments>
  <mappers>
    <mapper resource="org/mybatis/example/BlogMapper.xml"/>
  </mappers>
</configuration>

3）编写mybatis工具类

String resource = "org/mybatis/example/mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

4）编写实体类

5）编写接口及其实现类

<?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="org.mybatis.example.BlogMapper">
  <select id="selectBlog" resultType="Blog">
    select * from Blog where id = #{id}
  </select>
</mapper>

---

4.测试

有可能会碰到的报错：：

解决方案：参考我的另一篇文章Maven环境配置。第八章、总结

---

三、CRUD

1.select

UserMapper（接口类）：

UserMapper.xml（接口实现类）：

UserMapperTest（测试类）：

---

2.insert

UserMapper（接口类）：

UserMapper.xml（接口实现类）：

UserMapperTest（测试类）：

---

3.update

UserMapper（接口类）：

UserMapper.xml（接口实现类）：

UserMapperTest（测试类）：

---

4.delete

UserMapper（接口类）：

UserMapper.xml（接口实现类）：

UserMapperTest（测试类）：

---

5.Map

假设实体类或数据库中的表里的字段或参数过多，应当使用map

UserMapper（接口类）：

UserMapper.xml（接口实现类）：

UserMapperTest（测试类）：

---

四、配置解析

1.核心配置文件

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

• properties（属性）
• settings（设置）
• typeAliases（类型别名）
• typeHandlers（类型处理器）
• objectFactory（对象工厂）
• plugins（插件）
• environments（环境配置）

• environment（环境变量）
  –transactionManager（事务管理器）
  –dataSource（数据源）

• databaseIdProvider（数据库厂商标识）
• mappers（映射器）

注意标签的顺序！！！

---

2.properties（属性）

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

1）编写一个db.properties文件

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

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

---

3.settings（设置）

了解一下几个即可，具体的可以查mybatis官方文档

开启缓存

日志

数据库不区分大小写，只能用 _ 来分隔，这样可能会导致数据库的字段名和实体类中的属性名不一致。开启这个开关来将字段自动转换。

---

4.typeAliases（类型别名）

类型别名可为 Java 类型设置一个缩写名字,降低冗余的全限定类名书写。

• 可以给实体类起别名
  
  
• 指定一个包名，Mybatis会在该包名下搜索需要的java bean（实体类），默认为首字母小写的类名。
  如果想起别名，在此基础上添加注解

默认名字

起别名（添加注解）

---

5.environments（环境配置）

---

6.mappers（映射器）

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

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

方式二：使用class文件绑定注册
注意点：
1、接口和他的mapper配置文件必须同名
2、接口和他的mapper配置文件必须在同一个包下

<mappers>
	<mapper class="com.lzl.mapper.UserMapper"/>
</mappers>

方式三：使用扫描包进行注入绑定
注意点：
1、接口和他的mapper配置文件必须同名
2、接口和他的mapper配置文件必须在同一个包下

<mappers>
	<package name="com.lzl.mapper"/>
</mappers>

---

8.生命周期和作用域

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

SqlSessionFactoryBuilder

• 一旦创建了SqlSessionFactory，就不需要它了
• 作用域是局部变量

SqlSessionFactory

• 可以理解成数据库连接池
• SqlSessionFactory一旦被创建就应该在应用运行期间一直存在，没有理由丢弃或者重新创建一个实例
• 作用域是全局变量

SqlSession

• 可以理解成连接到连接池的一个请求
• SqlSession 的实例不是线程安全的，因此是不能被共享的，作用域是方法作用域
• 用完后需立即关闭，否则资源会被占用（因为连接池中的资源数是有限的）
  

---

9.结果集映射

如果实体类中的属性名和数据库中对应的字段名不一致，查询出来的结果会为null。
例如，数据库中的一个字段名是pwd，而实体类中的属性名为password，查询结果如下：

此时，用结果集映射可以解决这个问题。

---

五、日志

1.STDOUT_LOGGING

标准日志输出

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

---

2.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）配置log4l.properties文件

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/lzl.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的使用

---

六、分页

1.使用Limit分页

select * from user limit startIndex,pagesize
select * from user limit n;	#[0,n]

2.分页的实现

UserMapper（接口类）：

UserMapper.xml（接口实现类）：

UserMapperTest（测试类）：

---

七、注解

1.select

1）在核心配置文件中绑定接口

2）注解在接口上实现

3）测试

• 本质：反射机制的实现
• 底层：动态代理，可以参考另一篇博客多线程总结第四章内容。
• 如果遇到resultMap映射的问题是无法解决的。

---

2.自动提交事务

1）之前提交事务需要手动提交

2）在MybatisUtil工具类中，获取sqlSession实例时，可以调用openSession的一个重载方法，在其中设置提交事务的开关。

---

3.@Param()

• 基本类型的参数或者String类型，需要加上。
• 引用类型不需要加
• 在SQL中引用的就是@Param()中设定的属性名

---

4. #{} 和 ${} 的区别

#{}会防止SQL注入

• #{}是预编译处理，调用了PreparedStatement的set方法，是占位符。
  如：select * from user where name = #{userName} and pwd= #{password}; 设userName=小明，password=123
  解析时将#{userName}替换成了 ？。select * from user where name = ? and pwd = ?;
  再把小明和123放进去，外面加上单引号。select * from user where name = '小明' and pwd = '123';
• ${}是字符串替换，是拼接符。
  如：select * from user where name = ${userName} and pwd= ${password}; 设userName=小明，password=123
  解析时直接将值拼接进去了。select * from user where name = 小明 and pwd = 123;
  可能会发生SQL注入。如果输入1 or 1=1。select * from user where name = 小明 and pwd = 1 or 1=1;
  此时不知道密码也会查询到该用户的全部信息

---

八、Lombok

简化开发步骤

<dependency>
	<groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.10</version>
</dependency>

@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

1.@Data

2.@AllArgsConstructor、@NoArgsConstructor

---

九、复杂查询

1.环境搭建

1）数据库设计表，student 和 teacher通过id关联

2）创建实体类

3）创建接口

4）创建mapper.xml文件

5）注册mapper

---

2.多对一的处理

多个学生对应一个老师
查询所有的学生信息,以及对应的老师的信息

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

实体类：

Mapper：

1）子查询

2）嵌套查询

2.一对多的处理

一个老师拥有多个学生
查询一个老师有多少个学生

实体类：


mapper类：

嵌套查询：

---

十、动态SQL

根据不同的条件生成不同的SQL语句

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

1.环境搭建

1）博客表

2）实体类

3）IDUtil类

---

2.if、where

提供了可选的查找文本功能，如果不传入 if 中的值，则返回原SQL语句的查找
mapper：

mapper.xml：

Test：

---

3.choose（when、otherwise）

类似于 switch。when 相当于 case ， otherwise 在 when 条件下均未执行时才会走通。

---

4.set

update 语句中用到的标签，同 where 标签的作用类似，可以自动忽略掉多个 set 字段中间的逗号

---

5.SQL片段

在项目中往往有很多SQL语句的查询条件都相同，则可以将相同的部分抽取出来，方便复用

• 最好基于单表来定义SQL片段，提高耦合度
• 不要存在 where 标签
  

---

6.foreach

---

十一、缓存

• 什么是缓存
  1、存在内存中的临时数据
  2、将用户经常查询的数据放在缓存中，下次再去查询时就不用进行写操作，而是直接读取
• 缓存的作用
  减少和数据库交互的次数，降低高并发系统的性能问题，提高系统效率
• 读写分离
  当数据库访问量巨大时，将读操作和写操作分离，减少并发问题（可以用缓存来解决或者单独建一个数据库用来进行读操作）
• 主从复制
  其中有一个哨兵的机制。例如三个数据库中进行写操作，通过哨兵来监测，立即在第四个数据库中同步读出来。

1.mybatis中的缓存

---

2.一级缓存

• 本地缓存：sqlSession
  与数据库同一次会话期间查询到的数据会放在本地缓存中
• 缓存失效的情况
  1、查询不同的东西
  2、增删改操作，可能会改变原来的数据，所以一定会刷新
  3、查询不同的mapper.xml
  4、手动清理缓存。sqlSession.clearCache()
• 一级缓存是默认开启的，只在一次sqlSession中有效（拿到连接->关闭连接）。
• 一级缓存就是一个map
  

---

3.二级缓存

• 全局缓存，namespace级别
  1、若sqlSession关闭了，一级缓存中的数据会保存到二级缓存中
  2、不同的mapper查出的数据会放在自己对应的缓存（map）中
  3、默认开启的，但最好显示定义一下

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

• 缓存原理
  用户进行查询操作时，先进入二级缓存中看有没有，有的话直接获。否则再进入一级缓存中查看，若均没有，则查询数据库