Spring系列緩存注解@Cacheable @CacheEvit @CachePut 使用姿勢介紹

image

SpringBoot系列緩存注解@Cacheable @CacheEvit @CachePut使用姿勢介紹

Spring在3.1版本，就提供了一條基于注解的緩存策略，實際使用起來還是很絲滑的，本文將針對幾個常用的注解進行簡單的介紹說明，有需要的小伙伴可以嘗試一下

本文主要知識點：

  • @Cacheable: 緩存存在，則使用緩存；不存在，則執(zhí)行方法，并將結(jié)果塞入緩存
  • @CacheEvit: 失效緩存
  • @CachePut: 更新緩存

I. 項目環(huán)境

1. 項目依賴

本項目借助SpringBoot 2.2.1.RELEASE + maven 3.5.3 + IDEA + redis5.0進行開發(fā)

開一個web服務(wù)用于測試

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-redis</artifactId>
    </dependency>
</dependencies>

全程使用默認(rèn)配置，redis本機，端口6379，無密碼

II. 緩存注解介紹

1. @Cacheable

這個注解用于修飾方法or類，當(dāng)我們訪問它修飾的方法時，優(yōu)先從緩存中獲取，若緩存中存在，則直接獲取緩存的值；緩存不存在時，執(zhí)行方法，并將結(jié)果寫入緩存

這個注解，有兩個比較核心的設(shè)置

    /**
     * 與 cacheNames 效果等價
     */
    @AliasFor("cacheNames")
    String[] value() default {};

    
    @AliasFor("value")
    String[] cacheNames() default {};

    /**
     * 緩存key
     */
    String key() default "";

cacheNames可以理解為緩存key的前綴，可以為組件緩存的key變量；當(dāng)key不設(shè)置時，使用方法參數(shù)來初始化，注意key為SpEL表達式，因此如果要寫字符串時，用單引號括起來

一個簡單的使用姿勢

/**
 * 首先從緩存中查，查到之后，直接返回緩存數(shù)據(jù)；否則執(zhí)行方法，并將結(jié)果緩存
 * <p>
 * redisKey: cacheNames + key 組合而成 --> 支持SpEL
 * redisValue: 返回結(jié)果
 *
 * @param name
 * @return
 */
@Cacheable(cacheNames = "say", key = "'p_'+ #name")
public String sayHello(String name) {
    return "hello+" + name + "-->" + UUID.randomUUID().toString();
}

如我們傳參為 yihuihui, 那么緩存key為 say::p_yihuihui

除了上面三個配置值之外，查看@Cacheable注解源碼的童鞋可以看到還有condition設(shè)置，這個表示當(dāng)它設(shè)置的條件達成時，才寫入緩存

/**
 * 滿足condition條件的才寫入緩存
 *
 * @param age
 * @return
 */
@Cacheable(cacheNames = "condition", key = "#age", condition = "#age % 2 == 0")
public String setByCondition(int age) {
    return "condition:" + age + "-->" + UUID.randomUUID().toString();
}

上面這個case中，age為偶數(shù)的時候，才走緩存；否則不寫緩存

接下來是unless參數(shù)，從名字上可以看出它表示不滿足條件時才寫入緩存

/**
 * unless, 不滿足條件才寫入緩存
 *
 * @param age
 * @return
 */
@Cacheable(cacheNames = "unless", key = "#age", unless = "#age % 2 == 0")
public String setUnless(int age) {
    return "unless:" + age + "-->" + UUID.randomUUID().toString();
}

2. @CachePut

不管緩存有沒有，都將方法的返回結(jié)果寫入緩存；適用于緩存更新

/**
 * 不管緩存有沒有，都寫入緩存
 *
 * @param age
 * @return
 */
@CachePut(cacheNames = "t4", key = "#age")
public String cachePut(int age) {
    return "t4:" + age + "-->" + UUID.randomUUID().toString();
}

3. @CacheEvict

這個就是我們理解的刪除緩存

/**
 * 失效緩存
 *
 * @param name
 * @return
 */
@CacheEvict(cacheNames = "say", key = "'p_'+ #name")
public String evict(String name) {
    return "evict+" + name + "-->" + UUID.randomUUID().toString();
}

4. @Caching

在實際的工作中，經(jīng)常會遇到一個數(shù)據(jù)變動，更新多個緩存的場景，對于這個場景，可以通過@Caching來實現(xiàn)

/**
 * caching實現(xiàn)組合，添加緩存，并失效其他的緩存
 *
 * @param age
 * @return
 */
@Caching(cacheable = @Cacheable(cacheNames = "caching", key = "#age"), evict = @CacheEvict(cacheNames = "t4", key = "#age"))
public String caching(int age) {
    return "caching: " + age + "-->" + UUID.randomUUID().toString();
}

上面這個就是組合操作

  • 從 caching::age緩存取數(shù)據(jù)，不存在時執(zhí)行方法并寫入緩存；
  • 失效緩存 t4::age

5. 異常時，緩存會怎樣？

上面的幾個case，都是正常的場景，當(dāng)方法拋出異常時，這個緩存表現(xiàn)會怎樣？

/**
 * 用于測試異常時，是否會寫入緩存
 *
 * @param age
 * @return
 */
@Cacheable(cacheNames = "exception", key = "#age")
@Cacheable(cacheNames = "say", key = "'p_yihuihui'")
public int exception(int age) {
    return 10 / age;
}

根據(jù)實測結(jié)果，當(dāng)age==0時，上面兩個緩存都不會成功

6. 測試用例

接下來驗證下緩存注解與上面描述的是否一致

@RestController
public class IndexRest {
    @Autowired
    private BasicDemo helloService;

    @GetMapping(path = {"", "/"})
    public String hello(String name) {
        return helloService.sayHello(name);
    }
}

上面這個主要是驗證@Cacheable注解，若緩存不命中，每次返回的結(jié)果應(yīng)該都不一樣，然而實際訪問時，會發(fā)現(xiàn)返回的都是相同的

curl http://localhost:8080/?name=yihuihui

失效緩存

@GetMapping(path = "evict")
public String evict(String name) {
    return helloService.evict(String.valueOf(name));
}

失效緩存，需要和上面的case配合起來使用

curl http://localhost:8080/evict?name=yihuihui
curl http://localhost:8080/?name=yihuihui

剩下其他的相關(guān)測試類就比較好理解了，一并貼出對應(yīng)的代碼

@GetMapping(path = "condition")
public String t1(int age) {
    return helloService.setByCondition(age);
}

@GetMapping(path = "unless")
public String t2(int age) {
    return helloService.setUnless(age);
}

@GetMapping(path = "exception")
public String exception(int age) {
    try {
        return String.valueOf(helloService.exception(age));
    } catch (Exception e) {
        return e.getMessage();
    }
}

@GetMapping(path = "cachePut")
public String cachePut(int age) {
    return helloService.cachePut(age);
}

7. 小結(jié)

最后管理小結(jié)一下Spring提供的幾個緩存注解

  • @Cacheable: 緩存存在，則從緩存?。环駝t執(zhí)行方法，并將返回結(jié)果寫入緩存
  • @CacheEvit: 失效緩存
  • @CachePut: 更新緩存
  • @Caching: 都注解組合

上面雖說可以滿足常見的緩存使用場景，但是有一個非常重要的點沒有說明，緩存失效時間應(yīng)該怎么設(shè)置？？？

如何給每個緩存設(shè)置不同的緩存失效時間，咱么下篇博文見，我是一灰灰，歡迎關(guān)注長草的公眾號一灰灰blog

III. 不能錯過的源碼和相關(guān)知識點

0. 項目

1. 一灰灰Blog

盡信書則不如，以上內(nèi)容，純屬一家之言，因個人能力有限，難免有疏漏和錯誤之處，如發(fā)現(xiàn)bug或者有更好的建議，歡迎批評指正，不吝感激

下面一灰灰的個人博客，記錄所有學(xué)習(xí)和工作中的博文，歡迎大家前去逛逛

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點，簡書系信息發(fā)布平臺，僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容