@CachePut for updating cache in Spring Boot

Introduction

@CachePut helps keep your cache updated when you change data. It runs the method and then updates the cache with the new result.

When you want to update cached data after saving or changing it in the database.

When you want to make sure the cache always has the latest version of an object.

When you update an item and want the cache to reflect that change immediately.

When you want to avoid stale data in your cache after modifying data.

When you want to update cache without skipping the method execution.

Syntax

Spring Boot

@CachePut(value = "cacheName", key = "#key")
public ReturnType methodName(Parameters) {
    // method logic
}

value is the name of the cache to update.

key defines which cache entry to update, often using method parameters.

Examples

This updates the cache named 'users' with the user object using the user's id as the key.

Spring Boot

@CachePut(value = "users", key = "#user.id")
public User updateUser(User user) {
    // update user in database
    return user;
}

Updates the 'products' cache entry for the given product id after updating the product.

Spring Boot

@CachePut(value = "products", key = "#id")
public Product updateProduct(Long id, Product product) {
    // update product in database
    return product;
}

Sample Program

This service method updates a user and then updates the cache entry for that user using @CachePut.

The cache key is the user's id, so the cache always has the latest user data.

Spring Boot

import org.springframework.cache.annotation.CachePut;
import org.springframework.stereotype.Service;

@Service
public class UserService {

    @CachePut(value = "users", key = "#user.id")
    public User updateUser(User user) {
        // Imagine this updates the user in a database
        System.out.println("Updating user in database: " + user);
        return user; // Return updated user to update cache
    }
}

record User(Long id, String name) {}

// Example usage:
// UserService service = new UserService();
// User updated = service.updateUser(new User(1L, "Alice Updated"));
// Output:
// Updating user in database: User[id=1, name=Alice Updated]

Important Notes

@CachePut always runs the method, unlike @Cacheable which may skip method execution if cache exists.

Make sure the method returns the updated object so the cache can store it.

Use proper keys to avoid cache collisions or wrong updates.

Summary

@CachePut updates cache after method runs.

Use it when you want fresh data in cache after changes.

It needs a cache name and a key to know what to update.

Practice

1. What is the primary purpose of the @CachePut annotation in Spring Boot?

easy

A. To update the cache with the method's return value after execution

B. To clear all entries in the cache before method execution

C. To cache the method result only if it is not already cached

D. To disable caching for the annotated method

Solution

1. Step 1: Understand the role of @CachePut

   @CachePut is used to update the cache with fresh data after the method runs, unlike @Cacheable which caches only if data is absent.

2. Step 2: Compare options with @CachePut behavior

   Only To update the cache with the method's return value after execution correctly describes updating the cache after method execution. Others describe different caching behaviors.

3. Final Answer:

   To update the cache with the method's return value after execution -> Option A

4. Quick Check:

   @CachePut updates cache after method runs [OK]

Hint: Remember: @CachePut always updates cache after method runs [OK]

Common Mistakes:

• Confusing @CachePut with @Cacheable
• Thinking @CachePut clears cache
• Assuming it caches only if absent

2. Which of the following is the correct syntax to use @CachePut to update a cache named "users" with a key based on the method parameter id?

easy

A. @CachePut(cacheName = "users", key = "id")

B. @CachePut(value = "users", key = "#id")

C. @CachePut(name = "users", key = "id")

D. @CachePut(cache = "users", key = "#id")

Solution

1. Step 1: Recall correct attribute names for @CachePut

   The correct attribute for cache name is 'value' or 'cacheNames', and SpEL expressions for keys use '#'.

2. Step 2: Analyze each option's syntax

   @CachePut(value = "users", key = "#id") uses 'value' and '#id' correctly. Others use incorrect attribute names or miss the '#' for SpEL.

3. Final Answer:

   @CachePut(value = "users", key = "#id") -> Option B

4. Quick Check:

   Use 'value' and '#param' for key in @CachePut [OK]

Hint: Use 'value' for cache name and '#' before param in key [OK]

Common Mistakes:

• Using wrong attribute names like cacheName or cache
• Missing '#' in key expression
• Using plain string instead of SpEL for key

3. Given the following method in a Spring Boot service:

@CachePut(value = "products", key = "#product.id")
public Product updateProduct(Product product) {
    product.setPrice(product.getPrice() + 10);
    return product;
}

What will be the effect on the cache when this method is called with a product having id=5 and price=100?

medium

A. The cache is not affected because @CachePut only caches if absent

B. The cache entry with key 5 is removed from the cache

C. The cache entry with key 5 is updated with the product having price 110

D. A new cache entry with key 110 is added

Solution

1. Step 1: Understand @CachePut behavior on method call

   @CachePut updates the cache entry with the key specified after the method returns the updated object.

2. Step 2: Analyze the method logic and cache key

   The method increases price by 10 and returns the product. The key is product.id which is 5, so cache key 5 is updated with product price 110.

3. Final Answer:

   The cache entry with key 5 is updated with the product having price 110 -> Option C

4. Quick Check:

   @CachePut updates cache key with returned value [OK]

Hint: Returned value updates cache at key specified [OK]

Common Mistakes:

• Thinking cache key changes to price
• Assuming cache entry is removed
• Confusing @CachePut with @Cacheable

4. Consider this method annotated with @CachePut:

@CachePut(value = "orders", key = "#order.id")
public Order updateOrder(Order order) {
    // missing return statement
}

What is the problem with this code?

medium

A. The method should be annotated with @Cacheable instead

B. The key expression is invalid and causes a syntax error

C. The cache name 'orders' is not allowed in @CachePut

D. The method does not return a value, so cache cannot be updated

Solution

1. Step 1: Check method return requirement for @CachePut

   @CachePut requires the method to return a value to update the cache with that value.

2. Step 2: Identify missing return statement issue

   The method lacks a return statement, so no value is returned to update the cache, causing runtime issues.

3. Final Answer:

   The method does not return a value, so cache cannot be updated -> Option D

4. Quick Check:

   @CachePut needs method return to update cache [OK]

Hint: Always return updated value when using @CachePut [OK]

Common Mistakes:

• Forgetting to return the updated object
• Confusing cache name attribute
• Using @Cacheable instead of @CachePut incorrectly

5. You have a method that updates a user's email and you want to ensure the cache entry for that user is updated immediately after the change. Which approach correctly uses @CachePut to achieve this, assuming the method signature is public User updateEmail(Long userId, String newEmail)?

hard

A. @CachePut(value = "users", key = "#userId")
public User updateEmail(Long userId, String newEmail) {
User user = userRepository.findById(userId);
user.setEmail(newEmail);
userRepository.save(user);
return user;
}

B. @CachePut(value = "users", key = "#newEmail")
public User updateEmail(Long userId, String newEmail) {
User user = userRepository.findById(userId);
user.setEmail(newEmail);
userRepository.save(user);
return user;
}

C. @CachePut(value = "users")
public void updateEmail(Long userId, String newEmail) {
User user = userRepository.findById(userId);
user.setEmail(newEmail);
userRepository.save(user);
}

D. @CachePut(key = "#userId")
public User updateEmail(Long userId, String newEmail) {
User user = userRepository.findById(userId);
user.setEmail(newEmail);
userRepository.save(user);
return user;
}

Solution

1. Step 1: Verify correct cache name and key usage

   @CachePut(value = "users", key = "#userId") public User updateEmail(Long userId, String newEmail) { User user = userRepository.findById(userId); user.setEmail(newEmail); userRepository.save(user); return user; } uses 'value = "users"' and key '#userId', correctly identifying the cache and key.

2. Step 2: Check method return and update logic

   @CachePut(value = "users", key = "#userId") public User updateEmail(Long userId, String newEmail) { User user = userRepository.findById(userId); user.setEmail(newEmail); userRepository.save(user); return user; } returns the updated User object, which is necessary for @CachePut to update the cache. Other options either use wrong key, no return, or missing cache name.

3. Final Answer:

   @CachePut(value = "users", key = "#userId") public User updateEmail(Long userId, String newEmail) { User user = userRepository.findById(userId); user.setEmail(newEmail); userRepository.save(user); return user; } -> Option A

4. Quick Check:

   Return updated object and use correct cache name and key [OK]

Hint: Return updated object and use correct cache name and key [OK]

Common Mistakes:

• Using wrong key expression
• Not returning updated object
• Omitting cache name in annotation