Mybatis的缓存机制

最新推荐文章于 2025-01-29 16:52:01 发布

所学即分享

最新推荐文章于 2025-01-29 16:52:01 发布

阅读量1.3k

点赞数 1

文章标签： mybatis 数据库缓存 sql java

本文链接：https://blog.csdn.net/m0_72106802/article/details/126897987

版权

前言

Mybatis框架内置了一级缓存机制和二级缓存机制，一级缓存机制又称为会话（Session）缓存，默认是开启的，且无法关闭；二级缓存机制又成为namespace缓存，作用于某个namespace，可以理解为是接口。

一、Mybatis缓存机制

1.1 一级缓存

一级缓存必须满足：同一个SqlSession、同一个Mapper对象、执行相同的查询、且参数相同！

一级缓存代码示例：备注：提前准备实体类、DTO类、Mapper接口类以及xml的sql命令类

@Slf4j
@SpringBootTest
public class MybatisCacheTest {
    @Autowired
    SqlSessionFactory sqlSessionFactory;

    @Test
    void testMybatisCache1(){
        SqlSession sqlSession=sqlSessionFactory.openSession();
        BrandMapper brandMapper=sqlSession.getMapper(BrandMapper.class);

        Long id = 6L;
        log.debug("开始执行第1次【id={6}】的查询……", id);
        BrandStandardVO result1 = brandMapper.getStandardById(id);
        log.debug("第1次的查询结果：{}", result1);
        log.debug("第1次的查询结果的hashCode：{}", result1.hashCode());

        log.debug("开始执行第2次【id={6}】的查询……", id);
        BrandStandardVO result2 = brandMapper.getStandardById(id);
        log.debug("第2次的查询结果：{}", result1);
        log.debug("第2次的查询结果的hashCode：{}", result1.hashCode());
    }
}

通过测试并观察日志【参见下文】，可以看到，第1次执行查询，但是，第2次并没有真正的执行查询，并且，2次查询结果的hashCode值是完全相同的！也就是说：Mybatis只执行了第1次的查询，当执行第2次的代码时，并没有真正连接到MySQL数据库执行查询，而是将第1次的查询结果直接返回了！也可以说：Mybatis在第1次查询后，就把查询结果缓存下来了！

1.2 一级缓存失效

一级缓存会因为以下任一原因消失：

调用SqlSession对象的clearCache()方法，将清空缓存
当前执行了任何写操作（增/删/改），无论任何数据有没有发生变化，都会清空缓存

1.2.1 调用SqlSession对象的clearCache()方法清除缓存

@Slf4j
@SpringBootTest
public class MybatisCacheTest {
    @Autowired
    SqlSessionFactory sqlSessionFactory;

    @Test
    void testMybatisCache1(){
        SqlSession sqlSession=sqlSessionFactory.openSession();
        BrandMapper brandMapper=sqlSession.getMapper(BrandMapper.class);

        Long id = 6L;
        log.debug("开始执行第1次【id={6}】的查询……", id);
        BrandStandardVO result1 = brandMapper.getStandardById(id);
        log.debug("第1次的查询结果：{}", result1);
        log.debug("第1次的查询结果的hashCode：{}", result1.hashCode());

        sqlSession.clearCache();
        log.debug("这里调用了sqlSession的clearCache()方法！清理了缓存!");

        log.debug("开始执行第2次【id={6}】的查询……", id);
        BrandStandardVO result2 = brandMapper.getStandardById(id);
        log.debug("第2次的查询结果：{}", result1);
        log.debug("第2次的查询结果的hashCode：{}", result1.hashCode());
    }
}

通过调用SqlSession的clearCache()方法，把第一次的缓存清理掉了，所以第二次又从数据库查询了一次。

1.2.2 执行任何(增/删/改)方法让缓存失效

@Slf4j
@SpringBootTest
public class MybatisCacheTest {
    @Autowired
    SqlSessionFactory sqlSessionFactory;

    @Test
    void testMybatisCache1(){
        SqlSession sqlSession=sqlSessionFactory.openSession();
        BrandMapper brandMapper=sqlSession.getMapper(BrandMapper.class);

        Long id = 6L;
        log.debug("开始执行第1次【id={6}】的查询……", id);
        BrandStandardVO result1 = brandMapper.getStandardById(id);
        log.debug("第1次的查询结果：{}", result1);
        log.debug("第1次的查询结果的hashCode：{}", result1.hashCode());

         log.debug("准备修改【id={}】的数据……", 40000);
         Brand brand = new Brand();
         brand.setId(40000L);
         brand.setSort(99);
         brandMapper.updateById(brand);
         log.debug("完成修改【id={}】的数据", 40000);

        log.debug("开始执行第2次【id={6}】的查询……", id);
        BrandStandardVO result2 = brandMapper.getStandardById(id);
        log.debug("第2次的查询结果：{}", result1);
        log.debug("第2次的查询结果的hashCode：{}", result1.hashCode());
    }
}

可以看出中间执行了一次更改数据的操作，不管与查询的数据有没有关系，下次相同的查询还是会去从数据库获取数据。

2.1 二级缓存

二级缓存的应用优先级高于一级缓存，也就是说，Mybatis框架将优先从二级缓存中查找数据，如果命中，将返回，如果未命中，则从一级缓存中查找数据，如果命中，将返回，如果仍未命中，将执行真正的查询！

在使用Spring Boot与Mybatis集成的框架的项目中，二级缓存默认是全局开启的，各namespace默认未开启，如果需要开启，需要在XML文件中添加<cache/>标签，则表示当前XML中所有的查询都开启了二级缓存！另外，在每个查询上都有useCache属性，默认为true，如果在同一个namespace中，有些查询需要使用二级缓存，也有一些并不需要使用，则可以将不需要使用二级缓存的查询配置为useCache="false"。

当启用了二缓存后，每次尝试查询时，日志中都会出现 Cache Hit Ratio 的记录！

@Slf4j
@SpringBootTest
public class MybatisCacheTest {
    @Autowired
    BrandMapper brandMapper;

    @Test
    void testMybatisCache2(){
            Long id = 6L;
            log.debug("开始执行第1次【id={}】的查询……", id);
            BrandStandardVO result1 = brandMapper.getStandardById(id);
            log.debug("第1次的查询结果：{}", result1);
            log.debug("第1次的查询结果的hashCode：{}", result1.hashCode());
            

            log.debug("开始执行第2次【id={}】的查询……", id);
            BrandStandardVO result2 = brandMapper.getStandardById(id);
            log.debug("第2次的查询结果：{}", result2);
            log.debug("第2次的查询结果的hashCode：{}", result2.hashCode());

            id = 7L;
            log.debug("开始执行第1次【id={}】的查询……", id);
            BrandStandardVO result3 = brandMapper.getStandardById(id);
            log.debug("第2次的查询结果：{}", result3);
            log.debug("第2次的查询结果的hashCode：{}", result3.hashCode());

            log.debug("开始执行第2次【id={}】的查询……", id);
            BrandStandardVO result4 = brandMapper.getStandardById(id);
            log.debug("第2次的查询结果：{}", result4);
            log.debug("第2次的查询结果的hashCode：{}", result4.hashCode());

            id = 6L;
            log.debug("开始执行第3次【id={}】的查询……", id);
            BrandStandardVO result5 = brandMapper.getStandardById(id);
            log.debug("第3次的查询结果：{}", result5);
            log.debug("第3次的查询结果的hashCode：{}", result5.hashCode());
    }
}

这里可以通过Cache Hit Ratio(缓存命中率)的日志看出从缓存中获取数据的命中率。

与一级缓存机制一样二级缓存也会因为中间执行任一增删改操作，就会导致缓存失效。

2.2 报错演示

二级缓存的数据是存储在磁盘上的，需要查询结果的数据类型实现了Serilizable接口，如果未实现此接口，则查询时直接报错：


org.apache.ibatis.cache.CacheException: Error serializing object.  Cause: java.io.NotSerializableException: cn.tedu.csmall.product.pojo.vo.BrandStandardVO