Skip to content

giuseppe-trisciuoglio/developer-kit / plugins/developer-kit-java/skills/spring-boot-cache

spring-boot-cache

Verified

Provides patterns for implementing Spring Boot caching: configures Redis/Caffeine/EhCache providers with TTL and eviction policies, applies @Cacheable/@CacheEvict/@CachePut annotations, validates cache hit/miss behavior, and exposes metrics via Actuator. Use when adding caching to Spring Boot services, configuring cache expiration, evicting stale data, or diagnosing cache misses.

references/spring-framework-cache-docs.md

View on GitHub
# Spring Framework Cache Reference (Official)

Curated excerpts from the official Spring Framework reference documentation
covering caching fundamentals and annotation usage. Source pages are from the
[Spring Framework Reference Guide 6.2](https://docs.spring.io/spring-framework/reference/6.2/-SNAPSHOT/integration/cache/).

## Cache Abstraction Overview

- **Purpose**: Transparently wrap expensive service methods and reuse results
  resolved from configured cache managers.
- **Enablement**:

  ```java
  @Configuration
  @EnableCaching
  public class CacheConfig {
      @Bean
      public CacheManager cacheManager() {
          return new ConcurrentMapCacheManager("books");
      }
  }
  ```

  Source: [/integration/cache/annotations](https://docs.spring.io/spring-framework/reference/6.2/-SNAPSHOT/integration/cache/annotations)

- **Supported return types**: `CompletableFuture`, Reactor `Mono`/`Flux`,
  blocking objects, and collections are all cacheable. For async/reactive types,
  Spring stores the resolved value and rehydrates it on retrieval.

## Core Annotations

### `@Cacheable`

- Cache the method invocation result using the provided cache name and key.
- Supports conditional caching with `condition` (pre-invocation) and `unless`
  (post-invocation, access `#result`).

```java
@Cacheable(cacheNames = "book", condition = "#isbn.length() == 13", unless = "#result.hardback")
public Book findBook(String isbn) { ... }
```

Source: [/integration/cache/annotations](https://docs.spring.io/spring-framework/reference/6.2/-SNAPSHOT/integration/cache/annotations)

### `@CachePut` and `@CacheEvict`

- `@CachePut`: Always run the method and update cache entry with fresh result.
- `@CacheEvict`: Remove entries; use `allEntries = true` or `beforeInvocation`
  for pre-call eviction.

```java
@CacheEvict(cacheNames = "books", key = "#isbn", beforeInvocation = true)
public void reset(String isbn) { ... }
```

Source: [/integration/cache/annotations](https://docs.spring.io/spring-framework/reference/6.2/-SNAPSHOT/integration/cache/annotations)

### `@Caching`

- Bundle multiple cache operations on a single method:

```java
@Caching(evict = {
    @CacheEvict("primary"),
    @CacheEvict(cacheNames = "secondary", key = "#isbn")
})
public Book importBooks(String isbn) { ... }
```

Source: [/integration/cache/annotations](https://docs.spring.io/spring-framework/reference/6.2/-SNAPSHOT/integration/cache/annotations)

## Store Configuration Highlights

- **Caffeine**: Configure `CaffeineCacheManager` to create caches on demand.

  ```java
  @Bean
  CacheManager cacheManager() {
      return new CaffeineCacheManager();
  }
  ```

  Source: [/integration/cache/store-configuration](https://docs.spring.io/spring-framework/reference/6.2/-SNAPSHOT/integration/cache/store-configuration)

- **XML alternative**: Use `<cache:annotation-driven cache-manager="..."/>`
  when annotation configuration is not feasible.

  ```xml
  <cache:annotation-driven cache-manager="cacheManager"/>
  <bean id="cacheManager" class="org.springframework.cache.caffeine.CaffeineCacheManager"/>
  ```

  Source: [/integration/cache/declarative-xml](https://docs.spring.io/spring-framework/reference/6.2/-SNAPSHOT/integration/cache/declarative-xml)

## Reactive and Async Support

- `@Cacheable` works with asynchronous signatures:

  ```java
  @Cacheable("books")
  public Mono<Book> findBook(ISBN isbn) { ... }
  ```

  ```java
  @Cacheable(cacheNames = "foos", sync = true)
  public CompletableFuture<Foo> executeExpensiveOperation(String id) { ... }
  ```

  Source: [/integration/cache/annotations](https://docs.spring.io/spring-framework/reference/6.2/-SNAPSHOT/integration/cache/annotations)

## Additional Resources

- [`spring-cache-doc-snippet.md`](spring-cache-doc-snippet.md): Excerpt of the
  narrative caching overview from the Spring documentation.
- Refer to [`cache-core-reference.md`](cache-core-reference.md) for expanded
  API reference material and `cache-examples.md` for progressive examples.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 193kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 193kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 193kUpdated Claude CodeCodexVerifiedInstall