@Cacheable("books")
public Book findBookById(String id) {
    // 業(yè)務(wù)邏輯
}

@Cacheable(value = {"books", "archivedBooks"}, condition = "#id.length() > 10")
public Book findBookWithComplexKey(String id) {
    // 業(yè)務(wù)邏輯
}
@Service
public class MyService {
    /**
     * 一個(gè)使用 @Cacheable 所有屬性的案例。
     * 
     * @param id 用戶ID
     * @return 返回用戶對(duì)象
     */
    @Cacheable(
        value = "users",          // 緩存名稱
        key = "#id",              // 緩存鍵，使用SpEL表達(dá)式
        condition = "#id.length() > 3",  // 緩存條件，只有當(dāng)ID長度大于3時(shí)才緩存
        unless = "#result == null" // 除非條件，如果結(jié)果為null，則不緩存
    )
    public User findUserById(String id) {
        // 模擬數(shù)據(jù)庫查詢操作，這里假設(shè)ID長度小于3時(shí)沒有結(jié)果
        if (id == null || id.length() <= 3) {
            return null;
        }
        return performDatabaseQuery(id);
    }
    private User performDatabaseQuery(String id) {
        // 模擬數(shù)據(jù)庫查詢邏輯
        return new User(id, "Name based on ID");
    }
}

@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Inherited
@Documented
public @interface Cacheable {
    // 緩存KEY所在緩存的標(biāo)識(shí)符，支持多個(gè)，CSV格式
    @AliasFor("cacheNames")
    String[] value() default {};
    // 緩存KEY所在緩存的標(biāo)識(shí)符，支持多個(gè)，CSV格式
    @AliasFor("value")
    String[] cacheNames() default {};
    // 緩存的KEY，支持SpEL表達(dá)式動(dòng)態(tài)計(jì)算
    // 默認(rèn)為空(缺省按照方法的所有參數(shù)組合生成SimpleKey)
    String key() default "";
    // 緩存KEY生成器
    String keyGenerator() default "";
    // 緩存管理器
    String cacheManager() default "";
    // 緩存解析器
    String cacheResolver() default "";
    // 緩存的條件，使用SpEL表達(dá)式，方法調(diào)用前計(jì)算，當(dāng)結(jié)果為true時(shí)執(zhí)行動(dòng)作
    // 默認(rèn)為空，表示總是緩存方法返回值
    String condition() default "";
    // 否決緩存的條件，使用SpEL表達(dá)式，方法調(diào)用后計(jì)算（可使用result），當(dāng)結(jié)果為true時(shí)不執(zhí)行動(dòng)作
    // 默認(rèn)為空，表示永不否決；
    String unless() default "";
    // 使用異步模式標(biāo)識(shí)
    boolean sync() default false;
}

@CachePut("books")
public Book updateBookDetails(String id, Book details) {
    // 業(yè)務(wù)邏輯
}
@Service
public class MyService {
    /**
     * 使用 @CachePut 所有屬性的案例。
     *
     * @param user 用戶對(duì)象，包含ID
     * @return 更新后的用戶對(duì)象
     */
    @CachePut(
        value = "users",      // 緩存名稱
        key = "#user.id",     // 緩存鍵，使用SpEL表達(dá)式
        condition = "#user.age > 18"  // 條件，只有當(dāng)用戶年齡大于18時(shí)才更新緩存
    )
    public User updateUserProfile(User user) {
        // 模擬更新用戶信息的業(yè)務(wù)邏輯
        return performUpdate(user);
    }
    private User performUpdate(User user) {
        // 模擬更新邏輯
        user.setName("Updated Name");
        return user;
    }
}

@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Inherited
@Documented
public @interface CachePut {
    // 緩存KEY所在緩存的標(biāo)識(shí)符，支持多個(gè)，CSV格式
    @AliasFor("cacheNames")
    String[] value() default {};
    // 緩存KEY所在緩存的標(biāo)識(shí)符，支持多個(gè)，CSV格式
    @AliasFor("value")
    String[] cacheNames() default {};
    // 緩存的KEY，可以為空(缺省按照方法的所有參數(shù)組合生成SimpleKey)；
    // 支持SpEL表達(dá)式
    String key() default "";
    // KEY的生成器
    String keyGenerator() default "";
    // 緩存管理器
    String cacheManager() default "";
    // 緩存解析器
    String cacheResolver() default "";
    // 放置緩存的條件，使用SpEL表達(dá)式，方法調(diào)用后計(jì)算（可使用result），當(dāng)結(jié)果為true時(shí)執(zhí)行動(dòng)作
    // 默認(rèn)為空，表示方法結(jié)果總是被緩存
    String condition() default "";
    // 否決放置緩存的條件，使用SpEL表達(dá)式，方法調(diào)用后計(jì)算（可使用result），當(dāng)結(jié)果為true時(shí)不執(zhí)行動(dòng)作
    // 默認(rèn)為空，表示永不否決；
    String unless() default "";
}

@CacheEvict("books")
public void deleteBook(String id) {
    // 業(yè)務(wù)邏輯
}

@CacheEvict(allEntries = true)
public void clearAllCaches() {
    // 業(yè)務(wù)邏輯
}

@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Inherited
@Documented
public @interface CacheEvict {
    // 緩存KEY所在緩存的標(biāo)識(shí)符，支持多個(gè)，CSV格式
    @AliasFor("cacheNames")
    String[] value() default {};
    // 緩存KEY所在緩存的標(biāo)識(shí)符，支持多個(gè)，CSV格式
    @AliasFor("value")
    String[] cacheNames() default {};
    // 緩存的KEY，可以為空(缺省按照方法的所有參數(shù)組合生成SimpleKey)；
    // 支持SpEL表達(dá)式
    String key() default "";
    // KEY的生成器
    String keyGenerator() default "";
    // 緩存管理器
    String cacheManager() default "";
    // 緩存解析器
    String cacheResolver() default "";
    // 清除緩存的條件，使用SpEL表達(dá)式，執(zhí)行次序由beforeInvocation()決定
    // 默認(rèn)為空，表示總是清除緩存
    String condition() default "";
    // 刪除緩存中所有條目標(biāo)識(shí)
    // 默認(rèn)為false，表示只刪除指定KEY的值
    boolean allEntries() default false;
    // 方法調(diào)用前執(zhí)行標(biāo)識(shí)
    // 默認(rèn)為false，表示方法成功調(diào)用（未拋出異常）后執(zhí)行；為true則方法調(diào)用前執(zhí)行
    boolean beforeInvocation() default false;
}

@Caching(
    cacheable = {@Cacheable("books")},
    put = {@CachePut("books")},
    evict = {@CacheEvict("archivedBooks")}
)
public Book processBook(String id, Book details) {
    // 業(yè)務(wù)邏輯
}

@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Inherited
@Documented
public @interface Caching {
    // Cacheable集合
     Cacheable[] cacheable() default {};
    // CachePut集合
     CachePut[] put() default {};
    // CacheEvict集合
     CacheEvict[] evict() default {};
}

@CacheConfig(cacheNames = "books", keyGenerator = "customKeyGenerator")
public class BookService {
    // 類中的方法可以使用緩存注解
}

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface CacheConfig {
    // 緩存KEY所在緩存的標(biāo)識(shí)符，支持多個(gè)，CSV格式
    String[] cacheNames() default {};
    // KEY的生成器
    String keyGenerator() default "";
    // 緩存管理器
    String cacheManager() default "";
    // 緩存解析器
    String cacheResolver() default "";
}

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Import(CachingConfigurationSelector.class)
public @interface EnableCaching {
    // 代理模式：CGLIB or JDK Interface
    // 默認(rèn)為false，表示基于JDK Interface
    // 設(shè)置為true，會(huì)影響所有需要代理的Spring管理的Bean
    boolean proxyTargetClass() default false;
    // 緩存應(yīng)用模式：Proxy or AspectJ
    // Proxy模式只允許通過代理攔截調(diào)用，不會(huì)攔截同一類中的本地調(diào)用
    // AspectJ模式下，proxyTargetClass()無效，會(huì)攔截同一類中的本地調(diào)用
    AdviceMode mode() default AdviceMode.PROXY;
    // 特定連接點(diǎn)應(yīng)用多個(gè)建議時(shí)，緩存操作的執(zhí)行順序
    int order() default Ordered.LOWEST_PRECEDENCE;
}