Caffeine is a high performance, near optimal caching library based on Java 8. For more details, see our user's guide and browse the API docs for the latest release.
Caffeine provides an in-memory cache using a Google Guava inspired API. The improvements draw on our experience designing Guava's cache and ConcurrentLinkedHashMap.
LoadingCache<Key, Graph> graphs = Caffeine.newBuilder()
.maximumSize(10_000)
.expireAfterAccess(5, TimeUnit.MINUTES)
.refreshAfterWrite(1, TimeUnit.MINUTES)
.build(key -> createExpensiveGraph(key));Caffeine provides flexible construction to create a cache with a combination of the following features:
- automatic loading of entries into the cache, optionally asynchronously
- size-based eviction when a maximum is exceeded based on frequency and recency
- time-based expiration of entries, measured since last access or last write
- keys automatically wrapped in weak references
- values automatically wrapped in weak or soft references
- notification of evicted (or otherwise removed) entries
- writes propagated to an external resource
- accumulation of cache access statistics
In addition, Caffeine offers the following extensions:
- A short look at what Caffeine brings to your applications.
- Caffeine is presented as part of a research paper evaluating its novel eviction policy.
- TinyLFU: A Highly Efficient Cache Admission Policy by Gil Einziger, Roy Friedman, Ben Manes
On the radar,
- Spring Cache support is targeted for the Spring 4.3 / Boot 1.4 releases
- Early discussions with Apache Cassandra shows promise towards adoption
- Postgres is evaluating whether to port the cache
Download from Maven Central or depend via Gradle:
compile 'com.github.ben-manes.caffeine:caffeine:2.0.3'
// Optional extensions
compile 'com.github.ben-manes.caffeine:guava:2.0.3'
compile 'com.github.ben-manes.caffeine:jcache:2.0.3'Snapshots of the development version are available in Sonatype's snapshots repository.