Cache auto-configuration in Spring Boot 1.3

Engineering | Stéphane Nicoll | June 15, 2015 | ...

Over the past year, we have significantly improved the cache abstraction, with support of JSR-107 (JCache) annotations and a better declarative model to share or externalize common settings. In Spring Boot 1.3, we now offer a comprehensive auto-configuration for it.

In a nutshell, the cache abstraction applies caching to methods, thus reducing the number of executions based on the information available in the cache. The caching logic is applied transparently: the method below will only be invoked if the specified ISBN is not already present in the books cache. Upon calling that method for a missing Book, the caches will be updated transparently so that a further call does not invoke the method again.

public Book findBook(ISBN isbn) {...}

To actually enable the processing of those annotations a basic setup requires @EnableCaching to be set and a CacheManager bean to be defined.

public class MyApp {
    public CacheManager cacheManager() { ...}


We wanted to try to reduce this last step so that all you'd have to do is add @EnableCaching on your Spring Boot app and you're done. This is now a reality as of Spring Boot 1.3.M1! Spring Boot offers auto-configuration for any JSR-107 compliant provider but also for EhCache, Hazelcast, Infinispan, Redis and Guava. We also provide a very basic support if none of these are available using ConcurrentHashMap.

Spring Boot is inspecting your project to deduce the right defaults; for instance, if you have a ehcache.xml at the root of the classpath and EhCache 2.x is present, then we will automatically create a EhCacheCacheManager using that configuration file (unless specified otherwise). We also provide a broad support of configuration options: just grab Spring Boot 1.3.M1 and type spring.cache in your IDE to list the available options.

Spring Boot can create caches on startup if the underlying provider supports it. If you're using JCache, it can also give you a callback of the javax.cache.CacheManager in case you want to customize it on startup (i.e. to further tune the configuration).

If you're using the actuator, cache metrics are also exposed by default if the underlying cache provider supports it. For now we expose for each cache the size, the cache ratio and the miss ratio. We're looking forward to your feedback to improve that list.

Thanks a lot to the community for their help and in particular to Eddú Meléndez Gonzales who contributed many PRs! The documentation has been updated as well so please give it a try and let us know what you think.

Get the Spring newsletter

Thank you!

Get ahead

VMware offers training and certification to turbo-charge your progress.

Learn more

Get support

Spring Runtime offers support and binaries for OpenJDK™, Spring, and Apache Tomcat® in one simple subscription.

Learn more

Upcoming events

Check out all the upcoming events in the Spring community.

View all