给接口添加缓存

码农UP2U

发布于 2021-10-27 10:57:01

1.4K0

发布于 2021-10-27 10:57:01

文章被收录于专栏：码农UP2U

在项目中有些接口调用非常的频繁，但是接口的数据却很少改变，在接口上添加缓存可以有效的提高接口的性能。本文介绍如何在接口上增加缓存来提高接口的性能。

一、创建 SpringBoot 项目

在项目中，我们通过引入 Redis 服务器来做接口的缓存，我们创建一个 SpringBoot 的项目，先来添加其依赖，依赖如下：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-pool2</artifactId>
    <version>2.6.0</version>
</dependency>

依赖中引入了 Redis 所需的依赖，以及连接池的依赖，引入依赖后，来完成相关的配置。配置文件如下：

spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.datasource.url=jdbc:mysql://127.0.0.1:3306/mybatis_plus?characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai
spring.datasource.username=root
spring.datasource.password=

spring.jackson.date-format=yyyy-MM-dd HH:mm:ss
spring.jackson.time-zone=GMT+8

mybatis-plus.configuration.log-impl=org.apache.ibatis.logging.stdout.StdOutImpl

spring.redis.host=127.0.0.1
spring.redis.port=6379
spring.redis.database=0
spring.redis.timeout=1800000
spring.redis.lettuce.pool.max-active=20
spring.redis.lettuce.pool.max-wait=-1
spring.redis.lettuce.pool.max-idle=5
spring.redis.lettuce.pool.min-idle=0

二、创建项目的结构及代码

写一个简单的 Demo，Demo 的功能有两个，一个用来读取用户的列表，第二个功能用来添加新的用户。我们首先创建 controller、service 和 mapper 三个包结构。然后在其下分别添加相关的代码。

首先添加 controller 的代码，代码如下：

@RestController
@RequestMapping("/api/user")
public class CacheController
{
    @Autowired
    private CacheService cacheService;

    @GetMapping("getList")
    public List<User> getList() {
        return cacheService.getList();
    }

    @PostMapping("save")
    public void save(User user) {
        cacheService.setUser(user);
    }
}

在 Controller 中有 getList 和 save 两个方法，getList 方法用来获取用户的列表，save 用来添加新的用户。然后来编写这两个方法对应的 service 代码，代码如下：

@Service
public class CacheServiceImpl extends ServiceImpl<UserMapper, User> implements CacheService
{
    @Override
    public List<User> getList() {
        return baseMapper.selectList(null);
    }

    @Override
    public void setUser(User user) {
        baseMapper.insert(user);
    }
}

在 service 的 getList 方法，直接调用 baseMapper 的 selectList 方法来获取全部用户的列表，setUser 方法直接调用 baseMapper 的 insert 方法来添加新的用户。

mapper 文件直接继承 BaseMapper 即可，mapper 代码如下：

@Mapper
public interface UserMapper extends BaseMapper<User>
{
}

上面的代码是典型 Web 开发的套路。在上面的代码中，每次调用 getList 接口都会查询 user 表，返回用户的列表。在返回的列表中，只要用户的信息不变，或者用户没有增减，那么列表返回的内容总是固定的。在这种情况，每次调用接口都去查询数据库，对数据库而言是一种负担，且是不必要的。这时候给该接口增加一个缓存，那么每次调用 getList 时就无需查询数据库了，这样既减轻了数据库的压力，也提升了接口的性能，这样就非常的 nice 了。

三、给接口增加缓存

缓存的形式比较多，可以在项目的内存中直接进行缓存，也可以使用专门的缓存服务器进行缓存。如果缓存的内容少，可以直接在项目的内存中进行缓存，省去了缓存服务器的管理与成本，缓存的内容多则在缓存服务器中进行缓存，方便后续的扩容和进行单独的管理等，并且在项目重启后，缓存的内容不丢。本 Demo 我们使用 Redis 服务器来作为缓存。

使用缓存，首先来增加一个 config 包，在包中创建一个 Redis 的配置类，在该配置类中设置编写 key 生成的规则，设置 RedisTemplate 的规则，设置缓存的规则等。此处，基本上每个 Redis 的配置类都差不多，因此，这里就不贴出具体的代码了。

在配置好 Redis 的配置类后，无需修改任何代码，只需要在 service 的方法上增加注解，即可给接口增加缓存，增加注解后的 service 代码如下：

@Override
@Cacheable(value = "user", keyGenerator = "keyGenerator")
public List<User> getList() {
    return baseMapper.selectList(null);
}

@Override
@CacheEvict(value = "user", allEntries = true)
public void setUser(User user) {
    baseMapper.insert(user);
}

在上面的代码中，为两个方法分别增加了注解。第一个 @Cacheable 注解用于给该方法增加一个缓存，另外一个 @CacheEvict 注解用于给清除缓存。在两个注解中，都有一个 value 值，@CacheEvict 清除缓存时会清除指定 value 的缓存。

增加完缓存后，我们重启项目，重新来测试接口的缓存。在测试接口之前，不要忘记启动 Redis 服务器，然后通过 redis-cli 执行 flushdb 清空 redis 中的缓存，这样方便我们观察缓存中的数据。做好这些准备，我们就可以请求接口的地址了，地址如下：