二级缓存详解

原创 已于 2025-06-17 21:06:25 修改 · 1.4k 阅读 · 30 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#spring #java #后端

于 2025-06-17 21:03:34 首次发布

提问：怎么使用注解开启二级缓存，注解应该放在那里？

在 MyBatis 中使用注解开启二级缓存，需要在 Mapper 接口上添加 @CacheNamespace 注解。让我详细解释：

  1. 基本用法：

    java

    Apply to TestJwt.java

    @Mapper

    @CacheNamespace  // 开启二级缓存

    public interface UserMapper {

        // Mapper 方法

    }

  1. 完整示例：

    java

    Apply to TestJwt.java

    @Mapper

    @CacheNamespace(

        eviction = LruCache.class,           // 缓存淘汰策略

        flushInterval = 60000,               // 刷新间隔（毫秒）

        size = 1024,                         // 缓存大小

        readWrite = true,                    // 是否读写

        blocking = false                     // 是否阻塞

    )

    public interface UserMapper {

        @Select("SELECT * FROM user WHERE id = #{id}")

        User getUserById(Integer id);

        

        @Insert("INSERT INTO user(name, age) VALUES(#{name}, #{age})")

        int insertUser(User user);

    }

  1. 实体类配置：

    java

    Apply to TestJwt.java

    // 实体类需要实现 Serializable 接口

    public class User implements Serializable {

        private Integer id;

        private String name;

        private Integer age;

        

        // getter 和 setter

    }

  1. 缓存配置选项：

    java

    Apply to TestJwt.java

    @CacheNamespace(

        // 缓存实现类

        implementation = PerpetualCache.class,

        

        // 缓存淘汰策略

        eviction = LruCache.class,

        

        // 刷新间隔（毫秒）

        flushInterval = 60000,

        

        // 缓存大小

        size = 1024,

        

        // 是否读写

        readWrite = true,

        

        // 是否阻塞

        blocking = false

    )

  1. 缓存注解使用场景：

    java

    Apply to TestJwt.java

    @Mapper

    @CacheNamespace

    public interface UserMapper {

        // 查询方法会被缓存

        @Select("SELECT * FROM user WHERE id = #{id}")

        User getUserById(Integer id);

        

        // 更新方法会清除缓存

        @Update("UPDATE user SET name = #{name} WHERE id = #{id}")

        int updateUser(User user);

        

        // 删除方法会清除缓存

        @Delete("DELETE FROM user WHERE id = #{id}")

        int deleteUser(Integer id);

    }

  1. 缓存控制：

    java

    Apply to TestJwt.java

    @Mapper

    @CacheNamespace

    public interface UserMapper {

        // 使用 @Options 控制单个方法的缓存行为

        @Select("SELECT * FROM user WHERE id = #{id}")

        @Options(useCache = true)  // 使用缓存

        User getUserById(Integer id);

        

        // 禁用缓存

        @Select("SELECT * FROM user WHERE id = #{id}")

        @Options(useCache = false)  // 不使用缓存

        User getUserByIdNoCache(Integer id);

    }

  1. 最佳实践：

    java

    Apply to TestJwt.java

    @Mapper

    @CacheNamespace(

        eviction = LruCache.class,

        flushInterval = 60000,

        size = 1024,

        readWrite = true

    )

    public interface UserMapper {

        // 查询方法

        @Select("SELECT * FROM user WHERE id = #{id}")

        User getUserById(Integer id);

        

        // 更新方法

        @Update("UPDATE user SET name = #{name} WHERE id = #{id}")

        int updateUser(User user);

        

        // 删除方法

        @Delete("DELETE FROM user WHERE id = #{id}")

        int deleteUser(Integer id);

    }

  1. 注意事项：
  • 实体类必须实现 Serializable 接口
  • 缓存会占用内存，注意设置合适的缓存大小
  • 更新操作会自动清除缓存
  • 注意缓存一致性问题
  1. 常见问题：

    java

    Apply to TestJwt.java

    // 错误：实体类没有实现 Serializable

    public class User {  // 错误

        private Integer id;

        private String name;

    }

    // 正确：实体类实现 Serializable

    public class User implements Serializable {  // 正确

        private Integer id;

        private String name;

    }

  1. 缓存配置建议：
  • 对于频繁查询但不常更新的数据，可以开启缓存
  • 对于实时性要求高的数据，可以禁用缓存
  • 根据数据量大小设置合适的缓存大小
  • 根据业务需求设置合适的刷新间隔

总结：

  • 在 Mapper 接口上使用 @CacheNamespace 注解开启二级缓存
  • 实体类必须实现 Serializable 接口
  • 可以通过注解参数配置缓存行为
  • 注意缓存一致性和性能问题
  • 根据业务需求选择合适的缓存配置

开启二级缓存的时候，实体类必须实现Serializable吗？

是的，在 MyBatis 中开启二级缓存时，实体类必须实现 Serializable 接口。这是因为：

  1. 为什么需要实现 Serializable：
  • 二级缓存会将对象序列化后存储
  • 序列化是对象持久化的过程
  • 反序列化是对象恢复的过程
  • 没有实现 Serializable 会导致序列化失败
  1. 正确的实体类定义：

    java

    Apply to TestJwt.java

    // 正确：实现 Serializable 接口

    public class User implements Serializable {

        private Integer id;

        private String name;

        private Integer age;

        

        // getter 和 setter

    }

    // 错误：没有实现 Serializable 接口

    public class User {  // 会导致序列化异常

        private Integer id;

        private String name;

        private Integer age;

    }

  1. 序列化版本号：

    java

    Apply to TestJwt.java

    public class User implements Serializable {

        // 建议添加序列化版本号

        private static final long serialVersionUID = 1L;

        

        private Integer id;

        private String name;

        private Integer age;

    }

  1. 常见错误：

    java

    Apply to TestJwt.java

    // 错误：没有实现 Serializable

    @Mapper

    @CacheNamespace

    public interface UserMapper {

        @Select("SELECT * FROM user WHERE id = #{id}")

        User getUserById(Integer id);  // 会抛出序列化异常

    }

    // 正确：实现 Serializable

    @Mapper

    @CacheNamespace

    public interface UserMapper {

        @Select("SELECT * FROM user WHERE id = #{id}")

        User getUserById(Integer id);  // 正常工作

    }

  1. 注意事项：
  • 所有被缓存的实体类都必须实现 Serializable
  • 实体类中的其他对象属性也需要实现 Serializable
  • 建议添加序列化版本号
  • 注意序列化性能影响

总结：

  • 开启二级缓存时，实体类必须实现 Serializable 接口
  • 这是 MyBatis 二级缓存的要求
  • 没有实现 Serializable 会导致序列化异常
  • 建议添加序列化版本号

开启二级缓存有什么好处

开启 MyBatis 二级缓存有以下几个主要好处：

  1. 提高查询性能：
  • 减少数据库访问次数
  • 降低数据库压力
  • 提高响应速度
  • 减少网络开销
  1. 减少数据库负载：

    java

    Apply to TestJwt.java

    @Mapper

    @CacheNamespace

    public interface UserMapper {

        // 第一次查询会访问数据库

        @Select("SELECT * FROM user WHERE id = #{id}")

        User getUserById(Integer id);

        

        // 第二次查询相同数据会直接从缓存获取

        // 不会访问数据库

    }

  1. 适用场景：
  • 频繁查询但不常更新的数据
  • 数据量较小的表
  • 对实时性要求不高的数据
  • 多用户共享的数据
  1. 性能提升示例：

    java

    Apply to TestJwt.java

    // 不使用缓存

    for (int i = 0; i < 1000; i++) {

        userMapper.getUserById(1);  // 每次都会查询数据库

    }

    // 使用缓存

    for (int i = 0; i < 1000; i++) {

        userMapper.getUserById(1);  // 只有第一次查询数据库，后续从缓存获取

    }

  1. 内存使用优化：

    java

    Apply to TestJwt.java

    @CacheNamespace(

        size = 1024,  // 控制缓存大小

        eviction = LruCache.class  // 使用 LRU 淘汰策略

    )

    public interface UserMapper {

        // 缓存配置

    }

  1. 注意事项：
  • 缓存会占用内存
  • 需要注意缓存一致性
  • 不适合频繁更新的数据
  • 实体类需要实现 Serializable
  1. 最佳实践：

    java

    Apply to TestJwt.java

    @Mapper

    @CacheNamespace(

        eviction = LruCache.class,

        flushInterval = 60000,  // 定期刷新缓存

        size = 1024,  // 控制缓存大小

        readWrite = true

    )

    public interface UserMapper {

        // 适合缓存的方法

        @Select("SELECT * FROM user WHERE id = #{id}")

        User getUserById(Integer id);

        

        // 不适合缓存的方法

        @Select("SELECT * FROM user WHERE update_time > #{time}")

        List<User> getRecentUsers(Date time);

    }

  1. 使用建议：
  • 根据业务需求选择合适的缓存策略
  • 设置合适的缓存大小
  • 定期清理缓存
  • 注意缓存一致性
  1. 性能对比：

    text

    Apply to TestJwt.java

    不使用缓存：

    - 每次查询都访问数据库

    - 响应时间较长

    - 数据库压力大

    使用缓存：

    - 首次查询访问数据库

    - 后续查询从缓存获取

    - 响应时间短

    - 数据库压力小

  1. 总结好处：
  • 提高查询性能
  • 减少数据库访问
  • 降低数据库压力
  • 提高响应速度
  • 减少网络开销
  • 优化系统资源使用
  1. 使用场景示例：

    java

    Apply to TestJwt.java

    // 适合缓存的场景

    @Select("SELECT * FROM user WHERE id = #{id}")

    User getUserById(Integer id);  // 用户基本信息

    // 不适合缓存的场景

    @Select("SELECT * FROM order WHERE user_id = #{userId}")

    List<Order> getUserOrders(Integer userId);  // 订单信息经常变化

总结：

  • 二级缓存能显著提高查询性能
  • 减少数据库访问和压力
  • 提高系统响应速度
  • 优化资源使用
  • 适合特定业务场景
  • 需要注意缓存管理

最后我们来测试一下实体类如果没有实现Serializable接口会怎么样？会不会导致序列化异常？

可以看到没有实现Serializable接口导致出现io错误，再来试试实现Serializable接口会不会解决？

可以看到已经不会报错了，看来不实现Serializable接口确实会导致序列化异常。

那么我们再来看看二级缓存对于查询有没有提升？

我们可以看到我第一次查询速度是614ms

再重复查询试试

可以看到确实有所提升

24K30
关注
【mybatis注解开发+二级缓存】
xjj1128的博客
11-25 500
mybatis用注解形式实现数据表增删改查模糊查询
Mybatis二级缓存详解
共勉
11-17 4899
基于3.5.10版本的Mybatis源码，彻底搞清楚二级缓存是什么，是在哪里生效的，是怎么开启的，各自作用域是什么
MyBatis-23MyBatis缓存配置【二级缓存】
热门推荐
小工匠
05-07 1万+
概述 二级缓存的配置 全局开关cacheEnabled Mapper.xml中配置二级缓存 Mapper接口中配置二级缓存 只使用注解方式配置二级缓存 同时使用注解方式和XML映射文件时 二级缓存的使用 前提：实体类实现Serializable接口 示例 实体类SysPrivilege实现Serializable接口 PrivilegeMapper接口类增加接口方法 Privilege...
Mybatis中通过注解使用二级缓存
...
04-10 445
在Mybatis中使用注解开发一对多的查询配置的基础上进行修改： SqlMapConfig.xml <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.or...
mybatis开启二级缓存 注解+文件配置 两种方式
仗剑走天涯
03-23 1683
简要说明： 1.mybatis 的缓存机制有两级： （1）一级缓存：一级缓存mybatsi已近为我们自动开启，不用我们手动操作，而且我们是关闭不了的！！但是我们可以手动清除缓存。（SqlSession级别） （2）二级缓存：二级缓存需要我们手动开启。（全局级别） 注：缓存说白了就是查询时可以去历史记录找一找，不用去数据库中查询（不用执行查询语句）。 1.配置文件配置二级缓存(两步)： 1.在myb...
【Mybatis】Mybatis的一级和二级缓存(包含如何配置二级缓存)
酷酷的馫博客
10-28 2492
Mybatis的一级和二级缓存(包含如何配置二级缓存)
Hibernate一级缓存和二级缓存详解
08-26
Hibernate一级缓存和二级缓存详解 Hibernate是一种流行的基于Java的持久化框架，它提供了两种缓存机制：一级缓存和二级缓存。了解这两种缓存机制是非常重要的，因为它们可以极大地提高应用程序的性能。 一级缓存 ...
java中hibernate二级缓存详解
08-30
Hibernate 二级缓存详解 Hibernate 中的二级缓存是 SessionFactory 级别的缓存，它是属于进程范围的缓存。二级缓存是可配置的缓存插件，默认情况下，SessionFactory 不会启用这个缓存插件。二级缓存中的数据是...
如何检测cpu二级缓存是否损坏 详解二级缓存对CPU性能影响
01-20
本文主要是关于二极缓存的介绍，并阐述了二级缓存是否损坏的查看方法，并探讨了二级缓存对CPU性能的影响。二级缓存二级缓存的工作原理是当CPU要读取一个数据时，首先从缓存中查找，如果找到就立即读取并送给CPU处理...
Mybatis 之 二级缓存
凉茶铺的博客
06-08 1万+
⼆级缓存的原理和⼀级缓存原理⼀样，第⼀次查询，会将数据放⼊缓存中，然后第⼆次查询则会直接去 缓存中取。但是⼀级缓存是基于sqlSession的，⽽⼆级缓存是基于mapper⽂件的namespace的，也 就是说多个sqlSession可以共享⼀个mapper中的⼆级缓存区域，并且如果两个mapper的namespace 相同，即使是两个mapper,那么这两个mapper中执⾏sql查询到的数据也将存在相同的⼆级缓存区域 中如何使⽤⼆级缓存和⼀级缓存默认开启不⼀样，⼆级缓存需要我们⼿动开启⾸先在全局配置⽂件
springboot-mybatis之二级缓存（注解方式）-随手记
luning95的专栏
07-30 2555
springboot 自动开启了mybatis一级并支持二级缓存，mybatis的一级（session）和二级缓存（mapper-namespace）概念请自行了解。 接下来介绍下应用中如何配置开启和应用二级缓存： 1、在springboot 项目开发中首先pom.xml中添加mybatis依赖，我这里用的是通用mapper（和一般有所区别下面提到）： 2、yml配置开启二级缓存：...
SpringBoot整合MyBatis注解版并开启二级缓存
小小默：进无止境
06-26 1万+
【1】pom文件添加依赖 依赖如下所示： &amp;amp;amp;amp;amp;amp;amp;amp;amp;amp;amp;lt;dependency&amp;amp;amp;amp;amp;amp;amp;amp;amp;amp;amp;gt; &amp;amp;amp;amp;amp;amp;amp;amp;amp;amp;amp;lt;groupId&amp;amp;amp;amp;amp;amp;amp;amp;a
mybatis 基于注解的二级缓存
南淮北安的博客
05-09 1114
（1）在 SqlMapConfig 中开启二级缓存支持 默认是开启的：也就是不写也行 （2）在持久层UserDao.java 中使用注解配置二级缓存 （3）在持久层UserDao.java 中不使用注解配置二级缓存
Mybatis的二级缓存配置
lsziri的专栏
05-10 1111
一个项目中肯定会存在很多共用的查询数据，对于这一部分的数据，没必要 每一个用户访问时都去查询数据库，因此配置二级缓存将是非常必要的。 Mybatis的二级缓存配置相当容易，要开启二级缓存，只需要在你的Mapper 映射文件中添加一行： <cache /> 它将采用默认的行为进行缓存： 映射文件中所有的select语句将被缓存 映射文件中所有的insert、update和delete语句将刷新
MyBatis二级缓存实战
实践求真知
09-01 345
一领域模型 package org.fkit.domain; import java.io.Serializable; /** * * CREATE TABLE `tb_user` ( `id` INT(11) NOT NULL AUTO_INCREMENT, `name` VARCHAR(18) DEFAULT NULL, `sex` CHAR(2) DEFAULT NULL,...
springboot 中基于注解开启mybatis二级缓存
搬砖人的博客
05-10 3030
只需要加入注解@CacheNamespace即可 @Mapper @Repository @CacheNamespace public interface UserMapper { @Select("SELECT ID,NAME,AGE,PASSWORD FROM USER WHERE ID = #{id}") User selectById(String id); } ...
Hibernate二级缓存详解与应用总结
"关于Hibernate二级缓存的理论与实践总结" 在Java开发领域，Hibernate是一个广泛应用的对象关系映射（ORM）框架，它极大地简化了数据库操作。而二级缓存是Hibernate提供的一个性能优化特性，旨在提升数据访问速度，...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值