coffee-boots
coffee-boots copied to clipboard
Support property-based configuring of multiple Caffeine caches for Spring Cache abstraction.
Coffee Boots
Coffee Boots project implements (property-based) configuring of multiple Caffeine caches for Spring Cache abstraction. It works best with Spring Boot, implementing auto-configuration mechanism. This means that in most cases you don't have to create any beans yourself, just add dependency to the latest version:
<dependency>
<groupId>io.github.stepio.coffee-boots</groupId>
<artifactId>coffee-boots</artifactId>
<version>2.2.0</version>
</dependency>
Let's review a quick example to understand what the project does:
- Suppose you use Spring Cache functionality much and have a set of named caches.
- Your cached method may look like this:
@CachePut("myCache")
public Object getMyCachecObject() {
// some heavy stuff here
}
- Now you know that you need an ability to configure some of the named caches with specific parameters.
- Using this project's API you may define your own
Caffeine
the following way:
- Using this project's API you may define your own
@Autowired
private CaffeineSupplier caffeineSupplier;
@PostConstruct
public void initialize() {
Caffeine<Object, Object> myCacheBuilder = Caffeine.<Object, Object>newBuilder()
.expireAfterWrite(1L, TimeUnit.MINUTES)
.maximumSize(100000L);
this.caffeineSupplier.putCaffeine("myCache", myCacheBuilder);
}
- But in most cases hard-coding the exact caching parameters is not a good idea, so you may get them from properties.
- Modifying the above given code to get the caching parameters from
Environment
:
- Modifying the above given code to get the caching parameters from
@Autowired
private CaffeineSupplier caffeineSupplier;
@Autowired
private Environment environment;
@PostConstruct
public void initialize() {
Caffeine<Object, Object> myCacheBuilder = Caffeine.<Object, Object>newBuilder()
.expireAfterWrite(environment.getProperty("myCache.expireAfterWrite", Long.class, 1L), TimeUnit.MINUTES)
.maximumSize(environment.getProperty("myCache.maximumSize", Long.class, 100000L));
this.caffeineSupplier.putCaffeine("myCache", myCacheBuilder);
}
- After adding 3-5 caches you understand that configuring them this way 1 by 1 is no fun. As an experienced
Spring Boot
user you don't want to hard-code it, you want the framework to do this little magic for you, cause you know that the case is so simple and straight-forward. Ok, you're right, you may remove the above given customizations and just define the needed value forcoffee-boots.cache.spec.<your_cache_name>
property.- The appropriate configuration in your
application.properties
for the above given example would be the following:
- The appropriate configuration in your
coffee-boots.cache.spec.myCache=maximumSize=100000,expireAfterWrite=1m
- Let's imagine that you don't need to use the project anymore. Ok, no problem:
- At first you may remove the relevant customizations - if no code changes were introduced, just remove all the properties matching
coffee-boots.*
prefix. At this point your goal is reached asCoffee Boots
uses Spring's default functionality if no customizations are defined. - If you're not planning to use this functionality in the nearest future, just drop the dependency to
io.github.stepio.coffee-boots:coffee-boots
artifact. Nobody needs unused dependencies.
- At first you may remove the relevant customizations - if no code changes were introduced, just remove all the properties matching
Bonus points for advanced users
- If you use Caffeine only with specific environments (profiles) and don't want this project's beans to be created in other cases you can define property
spring.cache.type
. This project works only in 2 cases:- if property
spring.cache.type
is set with valuecaffeine
; - if property
spring.cache.type
is not defined at all.
- if property
More information is in issue#44 or commit#a134dc6.
- Use
coffee-boots.cache.default-spec
to define "basic" cache configuration with common key-value pairs to be reused by all other custom cache configurations. This allows simplifying custom configurations if necessary.
More information is in issue#43 or commit#2a38d5b.
- If you'd like to get automatic metrics registaration for your custom caches, don't forget to add next dependencies:
<dependency>
<groupId>io.micrometer</groupId>
<artifactId>micrometer-core</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-actuator-autoconfigure</artifactId>
</dependency>
This triggers the appropriate auto-configurations with relevant post-processing, more information is in issue#38 or commit#d4f137b.
- You may dislike the fact that project-specific
CacheManager
is created alongside with the built-in Spring BootCacheManager
. "Overloaded" bean is marked as@Primary
. This minor overhead allows executing the whole Spring Boot mechanism of cache initialization, including creation ofCacheMetricsRegistrar
bean. Individual configurations cannot be invoked as they're package-private. Project-specific deep custom configuration is avoided at all costs to simplify support of newer versions of Spring and Spring Boot.
You may still use earlier version 2.0.0
without the above mentioned advanced features if you really hate this overhead.
More information is in issue#38 or commit#d4f137b.
P.S.
Project's name is almost meaningless - just wanted it to be close to Caffeine
and Spring Boot
without violating 3rd party trade marks.
Related issues:
Example project (my own sandbox): stepio/coffee-boots-example.