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
Caffeinethe 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 Bootuser 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.propertiesfor 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 Bootsuses 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-bootsartifact. Nobody needs unused dependencies.
- At first you may remove the relevant customizations - if no code changes were introduced, just remove all the properties matching
- 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.typeis set with valuecaffeine; - if property
spring.cache.typeis not defined at all.
- if property
More information is in issue#44 or commit#a134dc6.
- Use
coffee-boots.cache.default-specto 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
CacheManageris 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 ofCacheMetricsRegistrarbean. 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.
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.
![dependabot-preview[bot] avatar](https://avatars.githubusercontent.com/in/2141?v=4 "dependabot-preview[bot]")
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent