SpringBoot集成Mybatis以及对Mybatis一级二级缓存的理解

MyBatis简介

MyBatis 是一款优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息，将接口和 Java 的
POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
官网地址：http://www.mybatis.org/mybatis-3/
Github地址：https://github.com/mybatis/mybatis-3

SpringBoot集成Mybatis

引入依赖

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
    <groupId>org.mybatis.spring.boot</groupId>
    <artifactId>mybatis-spring-boot-starter</artifactId>
    <version>1.3.2</version>
</dependency>

实体类,可以使用`lombok`简化实体类编写

@Data
@NoArgsConstructor
@AllArgsConstructor
public class UserVo {
    String id;
    String name;
}

mapper接口

public interface UserMapper {
    UserVo findById(@Param("id") String id);
    void saveUser(UserVo userVo);
    void updateUser(UserVo userVo);
}

mapper接口对应的xml文件一般放在资源目录下

创建相同的目录

image.png

注意：绝对不能一次性创建目录，例如com.example.mybatisdemo.mapper,直接这样写是错误的

对应的xml文件

<?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.example.mybatisdemo.mapper.UserMapper">
    <cache type="org.mybatis.caches.ehcache.EhcacheCache"/>
    <resultMap id="UserMap" type="com.example.mybatisdemo.entity.UserVo" autoMapping="true"/>

    <insert id="saveUser">
        INSERT INTO user (`id`,`name`)
        VALUES
        (#{id},#{name})
    </insert>
    <update id="updateUser">
        UPDATE user
        SET
        name=#{name}
        WHERE
        id=#{id}
    </update>
    <select id="findById" resultMap="UserMap">
        SELECT id,name FROM user WHERE id=#{id}
    </select>
</mapper>

controller层

@RestController
public class UserApi {
    @Autowired
    UserMapper userMapper;
    @GetMapping("/getUser/{id}")
    public Object getUser(@PathVariable(value = "id") String id){
        JSONObject jsonObject=new JSONObject();
        jsonObject.put("user",userMapper.findById(id));
        return jsonObject;
    }
    @PostMapping("/addUser")
    public Object addUser(@RequestBody UserVo userVo){
        JSONObject jsonObject=new JSONObject();
        String uuid=UUID.randomUUID().toString();
        userVo.setId(uuid);
        userMapper.saveUser(userVo);
        jsonObject.put("user",userMapper.findById(uuid));
        return jsonObject;
    }
    @PutMapping("/updateUser")
    public Object updateUser(@RequestBody UserVo userVo){
        JSONObject jsonObject=new JSONObject();
        userMapper.updateUser(userVo);
        jsonObject.put("user",userMapper.findById(userVo.getId()));
        return jsonObject;
    }
}

`yml`配置文件

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    username: mysql帐号
    password: mysql密码
    url: jdbc:mysql://localhost:3306/数据库名称?useSSL=false

如果想在控制台看到执行的SQL语句
可以在yml配置文件中设置logging.level.Mapper类的包=debug

logging:
  level:
    com:
      example:
        mybatisdemo:
          mapper: debug

最后别忘了在启动类加入@MapperScan,
通过使用@MapperScan可以指定要扫描的Mapper接口的包的路径

@SpringBootApplication
@MapperScan("com.example.mybatisdemo.mapper")
public class MybatisDemoApplication {

    public static void main(String[] args) {
        SpringApplication.run(MybatisDemoApplication.class, args);
    }
}

数据库方面记得自己建表哦，很简单

可能出现的问题

在项目启动过程中发现以下警告

Loading class `com.mysql.jdbc.Driver'. This is deprecated. 
The new driver class is `com.mysql.cj.jdbc.Driver'. 
The driver is automatically registered via the SPI and manual 
loading of the driver class is generally unnecessary.

这是因为项目Mysql依赖在6.0.2版本之前的驱动是com.mysql.jdbc.Driver
在6.0.2版本之后则变为com.mysql.cj.jdbc.Driver
SpringBoot引入依赖时不指定版本号默认引入最新的依赖

异常java.sql.SQLException: The server time zone value 'ÖÐ¹ú±ê×¼Ê±¼ä' is unrecognized or represents more than one time zone.
在Navicat或者Mysql小黑框中输入show VARIABLES like '%time_zone';

image.png

进行设置set GLOBAL time_zone='+8:00';即可

MyBatis缓存

一级缓存

一级缓存的使用不需要我们配置,一级缓存是基于PerpetualCache 的 HashMap本地缓存，其存储作用域为 Session，当 Session flush 或 close 之后，该Session中的所有 Cache就将清空。

image.png

MyBatis 默认是开启一级缓存的，MyBatis会在一次会话中，一个SqlSession对象中创建一个本地缓存(local cache)，对于每一次查询，都会尝试根据查询的条件去本地缓存中查找是否在缓存中，如果在缓存中，就直接从缓存中取出，然后返回给用户；否则，从数据库读取数据，将查询结果存入缓存并返回给用户。

二级缓存

如果需要开启二级缓存，resultMap的对应的实体类必须要序列化
不然会报java.io.NotSerializableException

一个类只有实现了Serializable接口，它的对象才是可序列化的。因此如果要序列化某些类的对象，这些类就必须实现Serializable接口。Serializable是一个空接口，它的目的只是简单的标识一个类的对象可以被序列化。

默认的二级缓存

Mybatis的二级缓存与一级缓存其机制相同，默认也是采用 PerpetualCache，HashMap存储，不同在于其存储作用域为 Mapper(Namespace),也是一个内存级别的缓存

默认的二级缓存功能如下：
1.映射语句文件中所有的select语句将会被缓存
2.映射语句文件中所有的insert update delete语句会刷新缓存
3.缓存会使用(Least Flush Interval,LRU最近最少使用的)算法来收回
4.根据时间表（如 no Flush Interval,没有刷新间隔），缓存不会以任何时间顺序来刷新
5.缓存会存储集合或对象（无论查询方法返回什么类型的值）的1024个引用
6.缓存会被视为read/wriete(可读/可写)的，意味着对象检索不是共享的，而且可以安全的被调用者修改，而不干扰其他调用者或者线程所做的潜在修改。

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

上面配置的意思是创建了一个FIFP缓存，每隔60S刷新一次，存储集合或对象的512个引用，而且返回的对象被认为是只读的，因而在不同线程中的调用者之间修改它们会导致冲突。

配置属性详解如下
eviction回收策略:
1.LRU 最近最少使用的，移除最长时间不被使用的对象，这是默认值
2.FIFO 先进先出，按对象进入缓存的顺序来移除它们
3.SOFT 软引用，移除基于垃圾回收器状态和软引用规则的对象
4.WEAK 弱引用，更积极的移除基于垃圾收集器状态和弱引用规则的对象
flushInterval刷新间隔
可以被设置为任意的正整数，而且它们代表一个合理的毫秒形式的时间段。默认情况不设置，即没有刷新间隔，缓存仅仅在调用语句时刷新
size引用数目
可以被设置为任意的正整数，要记住缓存的对象数目和运行环境的可用内存资源数目，默认1024
readOnly只读
属性可以被设置为true后者false。只读的缓存会给所有调用者返回缓存对象的相同实例，因此这些对象不能被修改，这提供了很重要的性能优势。可读写的缓存会通过序列化返回缓存对象的拷贝，这种方式会慢一些，但很安全，因此默认为false

结合Ehcache实现Mybatis二级缓存

由于Mybatis自己实现的二级缓存不是很好,所以我们需要整合第三方缓存框架,可以实现分布式缓存和中央缓存

使用的话需要引入两个依赖

<dependency>
    <groupId>net.sf.ehcache</groupId>
    <artifactId>ehcache</artifactId>
    <version>2.10.6</version>
</dependency>
<dependency>
    <groupId>org.mybatis.caches</groupId>
    <artifactId>mybatis-ehcache</artifactId>
     <version>1.1.0</version>
</dependency>

image.png

在需要开启二级缓存的namespace中加入

<cache type="org.mybatis.caches.ehcache.EhcacheCache"/>

MyBatis的二级缓存是和命名空间绑定的，即二级缓存需要配置在Mapper.xml映射文件中或者配置在Mapper.java接口中。在映射文件中，命名空间就是XML根节点mapper的namespace属性。在Mapper接口中，命名空间就是接口的全限定名称。

再次启动，看看加入二级缓存后sql语句的执行情况

image.png

查询了一次之后，我继续连点了十几下查询，Cache Hit Ratio是缓存命中率

二级缓存的说明
1.缓存是以namespace为单位的，不同namespace下的操作互不影响
2.insert,update,delete操作会清空所在namespace下的全部缓存
3.通常使用MyBatis Generator生成的代码中，都是各个表独立的，每个表都有自己的namespace

多表操作下不能使用二级缓存

注意：Mybatis二级缓存对于访问多的查询请求且用户对查询结果实时性要求不高，此时可采用Mybatis二级缓存技术降低数据库访问量，提高访问速度。如果需要多表,以及数据多变的缓存建议使用redis，多表操作一定一定不能使用二级缓存，这样会导致数据不一致的问题

SpringBoot集成Mybatis以及对Mybatis一级二级缓存的理解

SpringBoot集成Mybatis以及对Mybatis一级二级缓存的理解

MyBatis简介