JCache is the API being defined in JSR107. It defines a standard Java Caching API for use by developers and a standard SPI ("Service Provider Interface") for use by implementers.
12 October 2011: 0.3
Changes in this release:
- Numerous changes across the spec, TCK and RI
- Annotations implementations in the RI for Spring and CDI
- Transactions API finalised
<dependency> <groupId>javax.cache</groupId> <artifactId>cache-api</artifactId> <version>0.3</version> </dependency>
16 August 2011: 0.2
<dependency> <groupId>javax.cache</groupId> <artifactId>cache-api</artifactId> <version>0.2</version> </dependency>
Snapshot releases of jars for binaries, source and javadoc are available.
Download the cache-api from https://oss.sonatype.org/index.html#nexus-search;quick~javax-cache
or use the following Maven snippet:
<repository> <id>sonatype-nexus-snapshots</id> <name>Sonatype Nexus Snapshots</name> <url>https://oss.sonatype.org/content/repositories/snapshots</url> <releases> <enabled>false</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </repository> <dependency> <groupId>javax.cache</groupId> <artifactId>cache-api</artifactId> <version>0.2</version> </dependency>
The JavaDoc is available as a jar with the releases. We also have the latest JavaDoc online.
The evolving specification is available online on as a Google Doc.
The reference implementation ("RI") source is available on GitHub.
This implementation is not meant for production use. For that we would refer you to one of the many open source and commercial implementations of JCache.
The RI is there to ensure that the specification and API works.
For example, some things that we leave out:
- implementation of transactions.
- tiered storage. A simple on-heap store is used.
- replicated or distributed caching
Why did we do this? Because a much greater engineering effort, which gets put into the open source and commercial caches which implement this API, is required to accomplish these things.
Having said that, the RI is Apache 2 and is a correct implementation of the spec. It can be used to create new cache implementations.
Building From Source
Building uses Maven in all modules. Maven 2.2.1 and 3.0.4 have been tested.
See each module's README.md for build instructions.
Testing Implementions of JSR107
The jsr107tck module contains a domain, tests and an implementation-tester. The implementation-tester allows an implementation, packaged as a Maven module, to be specified on the command line and tested. For example a fictional Acme company implementation could be tested as follows:
mvn -Dtest=CacheManagerFactoryTest \ -Dimplementation-groupId=acme.cache \ -Dimplementation-artifactId=acme-cache \ -Dimplementation-version=0.1-SNAPSHOT \ test
Please join the mailing list if you're interested in using or developing the software: http://groups.google.com/group/jsr107
We will be using the
#jsr107 channel on Freenode for chat.
We also have set up a commit hook which publishes commits to the channel.
Please log issues to: https://github.com/jsr107/jsr107spec/issues
Right now code contribution is limited to the Expert Group, but please feel free to post to the mailing list.
The API is available under the JPA license and may be freely used.
The TCK is available under a restricted TCK license although the tests.
The reference implementation is available under an Apache 2 license.
For details please read the license in each source code file.
This free, open source software was made possible by the JSR107 Expert Group who put many hours of hard work into it.
Copyright (c) JSR107 Expert Group