Spring中@Cacheable注解的使用詳解

更新時間：2023年11月08日 09:11:48 作者：你就像甜甜的益達

這篇文章主要介紹了Spring中@Cacheable注解的使用詳解,Spring框架提供了@Cacheable注解來輕松地將方法結果緩存起來,以便在后續(xù)調用中快速訪問,本文將詳細介紹@Cacheable注解的使用方法,并從源碼級別解析其實現(xiàn)原理,需要的朋友可以參考下

@Cacheable注解

在現(xiàn)代的應用程序中，緩存是提高性能和可擴展性的重要組成部分。

Spring框架提供了@Cacheable注解來輕松地將方法結果緩存起來，以便在后續(xù)調用中快速訪問。本文將詳細介紹@Cacheable注解的使用方法，并從源碼級別解析其實現(xiàn)原理。

@Cacheable注解的使用方法

@Cacheable注解可用于Spring管理的bean中的任何方法上。它可以被用來緩存方法返回的結果。當使用@Cacheable注解時，Spring會在調用方法前檢查緩存中是否已經(jīng)存在該方法的結果，如果存在，則直接返回緩存中的結果，而不會執(zhí)行方法體中的代碼。如果緩存中不存在該方法的結果，則會執(zhí)行方法體中的代碼，并將結果存儲到緩存中，以便下次調用該方法時可以直接返回緩存中的結果。

下面是@Cacheable注解的使用示例：

@Cacheable(value="users", key="#userId")
public User getUserById(String userId) {
    // 查詢數(shù)據(jù)庫獲取用戶信息
}

上面的示例中，@Cacheable注解被用于getUserById方法上。其中value屬性指定了緩存的名稱為“users”，key屬性指定了緩存的鍵為傳入的userId參數(shù)。當調用getUserById方法時，Spring會先檢查名為“users”的緩存中是否已經(jīng)存在鍵為userId的結果，如果存在，則直接返回緩存中的結果，否則執(zhí)行方法體中的代碼，并將結果存儲到緩存中。

@Cacheable注解還可以使用SpEL表達式來動態(tài)地計算緩存的鍵。例如：

@Cacheable(value="users", key="#user.id")
public User getUserById(User user) {
    // 查詢數(shù)據(jù)庫獲取用戶信息
}

上面的示例中，key屬性使用了SpEL表達式“#user.id”，表示緩存的鍵為傳入?yún)?shù)user對象的id屬性值。

@Cacheable注解還支持多個鍵值對作為緩存的鍵。例如：

@Cacheable(value="users", key="#userId + '_' + #type")
public User getUserByIdAndType(String userId, String type) {
    // 查詢數(shù)據(jù)庫獲取用戶信息
}

上面的示例中，key屬性使用了兩個參數(shù)作為鍵值對，分別是userId和type。

@Cacheable注解還支持condition屬性來指定是否進行緩存。例如：

@Cacheable(value="users", key="#userId", condition="#userId.length() < 10")
public User getUserById(String userId) {
    // 查詢數(shù)據(jù)庫獲取用戶信息
}

上面的示例中，condition屬性使用了SpEL表達式“#userId.length() < 10”，表示只有當傳入?yún)?shù)userId的長度小于10時才進行緩存。

@Cacheable注解還支持unless屬性來指定不進行緩存的條件。例如：

@Cacheable(value="users", key="#userId", unless="#result == null")
public User getUserById(String userId) {
    // 查詢數(shù)據(jù)庫獲取用戶信息
}

上面的示例中，unless屬性使用了SpEL表達式“#result == null”，表示只有當方法返回值不為null時才進行緩存。

@Cacheable注解源碼分析

@Cacheable注解是Spring框架中org.springframework.cache.annotation包下的一個注解。它實際上是一個組合注解，包含了@CachePut、@CacheEvict和@Caching三個注解。

當使用@Cacheable注解時，Spring會在運行時動態(tài)地生成一個代理對象來攔截目標方法的調用。代理對象會首先檢查緩存中是否已經(jīng)存在該方法的結果，如果存在，則直接返回緩存中的結果，否則執(zhí)行目標方法，并將結果存儲到緩存中。

下面是@Cacheable注解的源碼：

@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Inherited
@Documented
@Caching(cacheable = @Cacheable)
public @interface Cacheable {
    Class<?>[] value() default {};
    String[] cacheNames() default {};
    String key() default "";
    String keyGenerator() default "";
    String cacheManager() default "";
    String cacheResolver() default "";
    String condition() default "";
    String unless() default "";
    boolean sync() default false;
}

從源碼可以看出，@Cacheable注解包含了value、cacheNames、key、keyGenerator、cacheManager、cacheResolver、condition、unless和sync等屬性。

value和cacheNames屬性用于指定緩存名稱。

key和keyGenerator屬性用于指定緩存鍵。

cacheManager和cacheResolver屬性用于指定緩存管理器和緩存解析器。

condition和unless屬性用于指定是否進行緩存。

sync屬性用于指定是否啟用同步模式。