cache2k – High Performance Java Caching

cache2k focuses on providing a well engineered in-memory object cache implementation for Java applications.

Maven Central

  Cache<String,String> cache = new Cache2kBuilder<String, String>() {}
    .expireAfterWrite(5, TimeUnit.MINUTES)    // expire/refresh after 5 minutes
    .resilienceDuration(30, TimeUnit.SECONDS) // cope with at most 30 seconds
                                              // outage before propagating 
                                              // exceptions
    .refreshAhead(true)                       // keep fresh when expiring
    .loader(this::expensiveOperation)         // auto populating function
    .build();

For a detailed introduction continue with Getting Started.

Features at a glance

Single small jar file (less than 400k) with no external dependencies
Even smaller, for use with Android
One of the fastest cache for JVM local caching, see the benchmarks page
Java 6 and Android compatible
Leverages Java 8 to increase performance (if possible)
Pure Java code, no use of sun.misc.Unsafe
Thread safe, with a complete set of atomic operations
Resilience and smart exception handling
Null value support, see User Guide - Null Values
Automatic Expiry and Refresh: duration or point in time, variable expiry per entry, delta calculations
CacheLoader with blocking read through, see User Guide - Loading and Read Through
CacheWriter
Event listeners
Refresh ahead reduces latency
Low Overhead Statistics and JMX support
Separate and defined API with stable and concise interface
complete JCache / JSR107 support, complatible to JCache Specification 1.1
XML based configuration, to separate cache tuning from logic

News

Version 1.1.1.Alpha, 2018-07-02: Development preview release, new jar file structure, See Version 1.1.1.Alpha release notes
Version 1.0.2.Final, 2017-12-29: Support JCache standard 1.1, See Version 1.0.2.Final release notes
Version 1.0.1.Final, 2017-08-14: minor bugfix release, See Version 1.0.1.Final release notes
Version 1.0.0.Final, 2017-07-11: Minor documentation tweaks, allow more chars in a cache name, See Version 1.0.0.Final release notes

Integrating cache2k in your project

chacke2k is on maven central. Maven users add the following dependencies:

  <dependency>
    <groupId>org.cache2k</groupId>
    <artifactId>cache2k-api</artifactId>
    <version>${cache2k-version}</version>
    <scope>provided</scope>
  </dependency>
  <dependency>
    <groupId>org.cache2k</groupId>
    <artifactId>cache2k-all</artifactId>
    <version>${cache2k-version}</version>
    <scope>runtime</scope>
  </dependency>

Please replace ${cache2k-version} with the latest version.

Feedback

Please use the GitHub issue tracker for bugs and wishes you step upon. We also monitor the stackoverflow.com tag cache2k for general usage questions.

License

The code is released under Apache license.

Alternatives

cache2k does not try to be a full blown distributed enterprise caching solution. Some alternatives which you should take a look on:

Google Guava Cache
EHCache
JCS
Caffeine

Distributed caches:

Infinispan
hazelcast
redsisson
Apache ignite

Credits

Andrius Velykis for his maven reflow theme
Maximilian Richt for customizing the reflow theme and polishing the cache2k.org site design
Dr. Song Jiang for support, Hompage of Dr. Song Jiang