Spring Cache是Spring提供的一整套缓存解决方案。它本身并不提供缓存实现,而是提供统一的接口和代码规范、配置、注解等,以便整合各种Cache方案,使用户不用关心Cache的细节。
Spring支持“透明”地向应用程序添加缓存,将缓存应用于方法,在方法执行前检查缓存中是否有可用的数据。这样可以减少方法执行的次数,同时提高响应的速度。缓存的应用方式“透明”,不会对调用者造成任何干扰。只要通过注解@EnableCaching启用了缓存支持,Spring Boot就会自动处理好缓存的基础配置。
Spring Cache作用在方法上。当调用一个缓存方法时,会把该方法参数和返回结果作为一个“键值对”(key / value)存放在缓存中,下次用同样的参数来调用该方法时将不再执行该方法,而是直接从缓存中获取结果进行返回。所以在使用Spring Cache时,要保证在缓存的方法和方法参数相同时返回相同的结果。
Spring Boot提供的声明式缓存(cache)注解,如下表:
注解 | 说明 |
---|---|
@EnableCaching | 开启缓存。 |
@Cacheable | 可以作用在类和方法上,以键值对的方式缓存类或方法的返回值。 |
@CachePut | 方法被调用,然后结果被缓存。 |
@CacheEvict | 清空缓存。 |
@Caching | 用来组合多个注解标签。 |
声明式缓存注解的详细使用:《Spring使用Cache、整合Ehcache》
Spring Boot支持多种不同的缓存产品。在默认情况下使用的是简单缓存,不建议在正式环境中使用。我们可以配置一些更加强大的缓存,比如Ehcache。
Ehcache是一种广泛使用的开源Java分布式缓存,它具有内存和磁盘存储、缓存加载器、缓存扩展、缓存异常处理、GZIP缓存、Servlet 过滤器,以及支持 REST 和 SOAP API 等特点。
【实例】创建SpringBoot与MyBatis的整合项目,实现用户信息的查询、新增、修改、删除功能。并使用 Spring Cache 和 EhCache 实现缓存管理,执行结果如下图:
在MySQL数据库中创建用户信息表(tb_user),并添加数据。
-- 判断数据表是否存在,存在则删除
DROP TABLE IF EXISTS tb_user;
-- 创建“用户信息”数据表
CREATE TABLE IF NOT EXISTS tb_user
(
user_id INT AUTO_INCREMENT PRIMARY KEY COMMENT '用户编号',
user_name VARCHAR(50) NOT NULL COMMENT '用户姓名',
age INT DEFAULT(0) NOT NULL COMMENT '年龄',
blog_url VARCHAR(50) NOT NULL COMMENT '博客地址',
blog_remark VARCHAR(50) COMMENT '博客信息'
) COMMENT = '用户信息表';
-- 添加数据
INSERT INTO tb_user(user_name,age,blog_url,blog_remark) VALUES('pan_junbiao的博客',32,'https://blog.csdn.net/pan_junbiao','您好,欢迎访问 pan_junbiao的博客');
(1)创建SpringBoot项目,项目结构如下图:
(2)添加pom.xml配置信息
在pom.xml配置文件中添加MyBatis、 MySQL的JDBC数据库驱动、Spring Boot 缓存支持启动器、Ehcache 缓存等。
org.mybatis.spring.boot
mybatis-spring-boot-starter
2.1.3
mysql
mysql-connector-java
8.0.20
org.springframework.boot
spring-boot-starter-thymeleaf
org.springframework.boot
spring-boot-starter-cache
2.3.2.RELEASE
net.sf.ehcache
ehcache
(3)配置相关信息
将默认的application.properties文件的后缀修改为“.yml”,即配置文件名称为:application.yml,并配置以下信息:
#Spring配置
spring:
#缓存管理器
cache:
type: ehcache
ehcache:
config: classpath:ehcache.xml #缓存加载配置文件
#使用Thymeleaf模板引擎
thymeleaf:
mode: HTML5
encoding: UTF-8
cache: false #使用Thymeleaf模板引擎,关闭缓存
servlet:
content-type: text/html
#DataSource数据源
datasource:
url: jdbc:mysql://localhost:3306/db_admin?useSSL=false&
username: root
password: 123456
driver-class-name: com.mysql.cj.jdbc.Driver
#MyBatis配置
mybatis:
type-aliases-package: com.pjb.entity #别名定义
configuration:
log-impl: org.apache.ibatis.logging.stdout.StdOutImpl #指定 MyBatis 所用日志的具体实现,未指定时将自动查找
map-underscore-to-camel-case: true #开启自动驼峰命名规则(camel case)映射
lazy-loading-enabled: true #开启延时加载开关
aggressive-lazy-loading: false #将积极加载改为消极加载(即按需加载),默认值就是false
#lazy-load-trigger-methods: "" #阻挡不相干的操作触发,实现懒加载
cache-enabled: true #打开全局缓存开关(二级环境),默认值就是true
在 resources (资源目录)下,创建 ehcache.xml 配置文件,配置信息如下:
配置属性说明:
属性 | 说明 |
---|---|
这个是磁盘存储路径,当内存缓存满了的时候,就会往这里面放,java.io.tmdir是操作系统缓存的临时目录,不同操作系统缓存目录不一样。 | |
maxElementsInMemory | 内存缓存中最多可以存放的元素数量,若放入Cache中的元素超过这个数值,则有以下两种情况: (1)若 overflowToDisk=true,则会将Cache中多出的元素放入磁盘文件中。 (2)若 overflowToDisk=false,则根据memoryStoreEvictionPolicy策略替换Cache中原有的元素。 |
overflowToDisk | 内存不足时,是否启用磁盘缓存。 |
eternal | 缓存中对象是否永久有效。 |
timeToIdleSeconds | 缓存数据在失效前的允许闲置时间(单位:秒),仅当 eternal=false 时使用,默认值是0表示可闲置时间无穷大,若超过这个时间没有访问此Cache中的某个元素,那么此元素将被从Cache中清除。 |
timeToLiveSeconds | 缓存数据的总的存活时间(单位:秒),仅当 eternal=false 时使用,从创建开始计时,失效结束。 |
maxElementsOnDisk | 磁盘缓存中最多可以存放的元素数量,0表示无穷大。 |
diskExpiryThreadIntervalSeconds | 磁盘缓存的清理线程运行间隔,默认是120秒。 |
memoryStoreEvictionPolicy | 内存存储与释放策略,即达到 maxElementsInMemory 限制时,Ehcache会根据指定策略清理内存,共有三种策略,分别为LRU(最近最少使用)、LFU(最常用的)、FIFO(先进先出)。 |
defaultCache | 默认缓存方式。 |
cache | 自定义的缓存方式,自行设置 name。 |
在 application.yml 配置文件中配置目标缓存管理器,支持 Ehcache、Generic、Redis、Jcache等。这里配置使用Ehcache。
#Spring配置
spring:
#缓存管理器
cache:
type: ehcache
ehcache:
config: classpath:ehcache.xml #缓存加载配置文件
在SpringBoot项目启动入口类中添加注解@EnableCaching,开启缓存功能。
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cache.annotation.EnableCaching;
@SpringBootApplication
@EnableCaching
public class SpringcacheDemoApplication
{
public static void main(String[] args)
{
SpringApplication.run(SpringcacheDemoApplication.class, args);
}
}
在com.pjb.entity包中,创建UserInfo类(用户信息实体类)。
package com.pjb.entity;
import java.io.Serializable;
/**
* 用户信息实体类
* @author pan_junbiao
**/
public class UserInfo implements Serializable
{
private int userId; //用户编号
private String userName; //用户姓名
private int age; //年龄
private String blogUrl; //博客地址
private String blogRemark; //博客信息
//省略getter与setter方法...
}
在com.pjb.mapper包中,创建UserMapper接口(用户信息Mapper动态代理接口)。
package com.pjb.mapper;
import com.pjb.entity.UserInfo;
import org.apache.ibatis.annotations.*;
import org.springframework.stereotype.Repository;
/**
* 用户信息Mapper动态代理接口
* @author pan_junbiao
**/
@Mapper
@Repository
public interface UserMapper
{
/**
* 根据用户ID,获取用户信息
*/
@Select("SELECT * FROM tb_user WHERE user_id = #{userId}")
public UserInfo getUserById(int userId);
/**
* 新增用户,并获取自增主键
*/
@Insert("INSERT INTO tb_user(user_name,age,blog_url,blog_remark) VALUES(#{userName},#{age},#{blogUrl},#{blogRemark});")
@Options(useGeneratedKeys = true, keyColumn = "user_id", keyProperty = "userId")
public int insertUser(UserInfo userInfo);
/**
* 修改用户
*/
@Update("UPDATE tb_user SET user_name = #{userName} ,age = #{age} ,blog_url = #{blogUrl} ,blog_remark = #{blogRemark} WHERE user_id = #{userId}")
public int updateUser(UserInfo userInfo);
/**
* 删除用户
*/
@Delete("DELETE FROM tb_user WHERE user_id = #{userId}")
public int deleteUser(int userId);
}
在com.pjb.service包下,创建UserService接口(用户信息业务逻辑接口)。
package com.pjb.service;
import com.pjb.entity.UserInfo;
/**
* 用户信息业务逻辑接口
* @author pan_junbiao
**/
public interface UserService
{
/**
* 根据用户ID,获取用户信息
*/
public UserInfo getUserById(int userId);
/**
* 新增用户,并获取自增主键
*/
public UserInfo insertUser(UserInfo userInfo);
/**
* 修改用户
*/
public UserInfo updateUser(UserInfo userInfo);
/**
* 删除用户
*/
public int deleteUser(int userId);
}
在com.pjb.service.impl包下,创建UserServiceImpl类(用户信息业务逻辑类)。
package com.pjb.service.impl;
import com.pjb.entity.UserInfo;
import com.pjb.mapper.UserMapper;
import com.pjb.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.cache.annotation.CacheConfig;
import org.springframework.cache.annotation.CacheEvict;
import org.springframework.cache.annotation.CachePut;
import org.springframework.cache.annotation.Cacheable;
import org.springframework.stereotype.Service;
/**
* 用户信息业务逻辑类
* @author pan_junbiao
**/
//注意:必须对应配置文件ehcache.xml中cache节点的name属性值
//@CacheConfig(cacheNames = "userCache")
@Service
public class UserServiceImpl implements UserService
{
@Autowired
private UserMapper userMapper;
//注意:必须对应配置文件ehcache.xml中cache节点的name属性值
private static final String CACHE_NAME = "userCache";
/**
* 根据用户ID,获取用户信息
*/
@Override
@Cacheable(value = CACHE_NAME, key = "#userId")
public UserInfo getUserById(int userId)
{
return userMapper.getUserById(userId);
}
/**
* 新增用户,并获取自增主键
*/
@Override
@CachePut(value = CACHE_NAME, key = "#userInfo.userId")
public UserInfo insertUser(UserInfo userInfo)
{
userMapper.insertUser(userInfo);
return userInfo;
}
/**
* 修改用户
*/
@Override
@CachePut(value = CACHE_NAME, key = "#userInfo.userId")
public UserInfo updateUser(UserInfo userInfo)
{
userMapper.updateUser(userInfo);
return userInfo;
}
/**
* 删除用户
*/
@Override
@CacheEvict(value = CACHE_NAME, key = "#userId")
public int deleteUser(int userId)
{
return userMapper.deleteUser(userId);
}
}
从上述代码可以看出,查询用户的方法使用了 @Cacheable 注解来开启缓存。添加和修改方法使用了 @CachePut 注解,它是先处理方法,然后把结果进行缓存的。要想删除数据,则需要使用 @CacheEvict 注解来清空缓存。
@CacheConfig注解:如果所有的 @Cacheable() 里面都有一个 value=“xxx” 的属性,这显然如果方法多了,写起来也是挺累的,如果可以一次性声明完 那就省事了,所以有了 @CacheConfig 这个配置,@CacheConfig is a class-level annotation that allows to share the cache names,如果你在方法写别的名字,那么依然以方法的名字为准。
在com.pjb.controller包中,创建UserController类(用户控制器),实现用户数据的查询、新增、修改、删除,并实现数据的返回。
package com.pjb.controller;
import com.pjb.entity.UserInfo;
import com.pjb.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.servlet.ModelAndView;
/**
* 用户信息控制器
* @author pan_junbiao
**/
@Controller
@RequestMapping("/user")
public class UserController
{
@Autowired
private UserService userService;
/**
* 获取用户信息
*/
@RequestMapping("getUserById")
public ModelAndView getUserById(int userId)
{
//根据用户ID,获取用户信息
UserInfo userInfo = userService.getUserById(userId);
if(userInfo==null)
{
userInfo = new UserInfo();
}
//返回结果
ModelAndView modelAndView = new ModelAndView();
modelAndView.addObject("userInfo",userInfo);
modelAndView.setViewName("/user-info.html");
return modelAndView;
}
/**
* 新增用户
*/
@ResponseBody
@RequestMapping("insertUser")
public boolean insertUser()
{
//创建新用户
UserInfo userInfo = new UserInfo();
userInfo.setUserName("pan_junbiao的博客");
userInfo.setAge(32);
userInfo.setBlogUrl("https://blog.csdn.net/pan_junbiao");
userInfo.setBlogRemark("您好,欢迎访问 pan_junbiao的博客");
//执行新增方法
userService.insertUser(userInfo);
//返回结果
return userInfo.getUserId() > 0 ? true : false;
}
/**
* 修改用户
*/
@ResponseBody
@RequestMapping("updateUser")
public boolean updateUser(int userId)
{
UserInfo userInfo = new UserInfo();
userInfo.setUserId(userId);
userInfo.setUserName("pan_junbiao的博客_02");
userInfo.setAge(35);
userInfo.setBlogUrl("https://blog.csdn.net/pan_junbiao");
userInfo.setBlogRemark("您好,欢迎访问 pan_junbiao的博客");
//执行修改方法
userService.updateUser(userInfo);
//返回结果
return true;
}
/**
* 删除用户
*/
@ResponseBody
@RequestMapping("deleteUser")
public boolean deleteUser(int userId)
{
//执行新增方法
int result = userService.deleteUser(userId);
//返回结果
return result > 0 ? true : false;
}
}
在 resources/templates 目录下,创建 user-info.html 用户信息显示页面。
用户信息
用户信息
用户ID:
用户名称:
年龄:
博客地址:
备注信息:
至此,项目已经编写完成,执行结果如下图:
接着运行项目的其他方法,然后多次访问查询方法的URL,体验缓存效果。主要观察数据库是否进行了操作,如果数据库没有操作数据而正常返回数据,则代表缓存成功。