掘金 后端 ( ) • 2024-05-06 11:04

1.Spring Cache介绍

Spring Cache 是一个框架,实现了基于注解的缓存功能,只需要简单地加一个注解,就能实现缓存功能。

Spring Cache 提供了一层抽象,底层可以切换不同的缓存实现,例如:

  • EHCache
  • Caffeine
  • Redis(常用)

起步依赖:

<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-cache</artifactId>  		         <version>2.7.3</version> 
</dependency>

2.常用注解

在SpringCache中提供了很多缓存操作的注解,常见的是以下的几个:

注解 说明 @EnableCaching 开启缓存注解功能,通常加在启动类上 @Cacheable 在方法执行前先查询缓存中是否有数据,如果有数据,则直接返回缓存数据;如果没有缓存数据,调用方法并将方法返回值放到缓存中 @CachePut 将方法的返回值放到缓存中 @CacheEvict 将一条或多条数据从缓存中删除

在spring boot项目中,使用缓存技术只需在项目中导入相关缓存技术的依赖包,并在启动类上使用@EnableCaching开启缓存支持即可。

3.案例示范

3.1 环境准备

image-20240310151532238

建立了上述工程,为简单讲解,该项目省略了service层。

数据库接入了redis与mysql数据库,redis作为缓存,mysql用来存储案例数据,并集成了swagger依赖,方便进行接口测试。

在userController中,主要写了如下几个接口,并在对应mapper中写了相关sql语句:

@PostMapping
public User save(@RequestBody User user){
    userMapper.insert(user);
    return user;
}

@DeleteMapping
public void deleteById(Long id){
    userMapper.deleteById(id);
}

@DeleteMapping("/delAll")
public void deleteAll(){
    userMapper.deleteAll();
}

@GetMapping
public User getById(Long id){
    return userMapper.getById(id);
}

3.2 开启缓存

开启缓存就在启动类上加@EnableCaching注解。

@SpringBootApplication
@EnableCaching // 开启springCache缓存
public class SpringCacheApplication {

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

3.3 @CachePut注解

@CachePut 说明:

​ 作用: 将方法返回值,放入缓存

​ value: 缓存的名称, 每个缓存名称下面可以有很多key

​ key: 缓存的key --> 支持Spring的表达式语言SPEL语法

在save方法上加注解@CachePut

当前UserController的save方法是用来保存用户信息的,我们希望在该用户信息保存到数据库的同时,也往缓存中缓存一份数据,我们可以在save方法上加上注解 @CachePut,用法如下:

	/**
	* CachePut:将方法返回值放入缓存
	* value:缓存的名称,每个缓存名称下面可以有多个key,一般与需要缓存的数据相关
	* key:缓存的key
	*/
	@PostMapping
    @CachePut(value = "userCache", key = "#user.id") // key的生成:userCache::1
    public User save(@RequestBody User user){
        userMapper.insert(user);
        return user;
    }

说明:key的写法如下

#user.id: #user指的是方法形参的名称, id指的是user的id属性 , 也就是使用user的id属性作为key ;

#result.id: #result代表方法返回值,该表达式 代表以返回对象的id属性作为key ;

#p0.id:#p0指的是方法中的第一个参数,id指的是第一个参数的id属性,也就是使用第一个参数的id属性作为key;

#a0.id:#a0指的是方法中的第一个参数,id指的是第一个参数的id属性,也就是使用第一个参数的id属性作为key;

#root.args[0].id: #root.args[0]指的是方法中的第一个参数,id指的是第一个参数的id属性,也就是使用第一个参数的id属性作为key ;

注意: 一般常用的就是第一种方式

启动服务,通过swagger接口文档测试,访问UserController的save()方法

因为id是自增,所以不需要设置id属性

image-20240310153203623

查看user表中的数据

image-20240310153217860

查看Redis中的数据

image-20240310153324594

3.4 @Cacheable注解

@Cacheable 说明:

​ 作用: 在方法执行前,spring先查看缓存中是否有数据,如果有数据,则直接返回缓存数据;若没有数据,调用方法并将方法返回值放到缓存中

​ value: 缓存的名称,每个缓存名称下面可以有多个key(也可以写cacheNames)

​ key: 缓存的key ----> 支持Spring的表达式语言SPEL语法

在getById上加注解@Cacheable

	/**
	* Cacheable:在方法执行前spring先查看缓存中是否有数据,如果有数据,则直接返回缓存数据;若没有数据,	  *调用方法并将方法返回值放到缓存中
	* value:缓存的名称,每个缓存名称下面可以有多个key(也可以写cacheNames)
	* key:缓存的key
	*/
	@GetMapping
    @Cacheable(cacheNames = "userCache",key="#id")
    public User getById(Long id){
        User user = userMapper.getById(id);
        return user;
    }

重启服务,通过swagger接口文档测试,访问UserController的getById()方法

第一次访问,会请求我们controller的方法,查询数据库。后面再查询相同的id,就直接从Redis中查询数据,不用再查询数据库了,就说明缓存生效了。

提前在redis中手动删除掉id=2的用户数据

image-20240310153824885

image-20240310153745220

查看控制台sql语句:说明从数据库查询的用户数据(记得开启日志)

image-20240310154337262

查看Redis中的缓存数据:说明已成功缓存

image-20240310154140579

再次查询相同id的数据时,直接从redis中直接获取,不再查询数据库。可以打断点测试,也可以看输出日志。

3.5 @CacheEvict注解

@CacheEvict 说明:

​ 作用: 清理指定缓存

​ value: 缓存的名称,每个缓存名称下面可以有多个key

​ key: 缓存的key --> 支持Spring的表达式语言SPEL语法

在 delete 方法上加注解@CacheEvict

	@DeleteMapping
    @CacheEvict(cacheNames = "userCache",key = "#id") // 删除某个key对应的缓存数据
    public void deleteById(Long id){
        userMapper.deleteById(id);
    }

	@DeleteMapping("/delAll")
    @CacheEvict(cacheNames = "userCache",allEntries = true) // 删除userCache下所有的缓存数据
    public void deleteAll(){
        userMapper.deleteAll();
    }

重启服务,通过swagger接口文档测试,访问UserController的deleteAll()方法

image-20240310154811868

查看user表:数据清空

image-20240310154825035

查询Redis缓存数据

image-20240310154840602