What is JBoss Cache

JBoss Cache consists of two editions:

• core - a replicated, distributed, transactional tree-structured cache
• pojo (formerly JBossCacheAop) - a layer on top of the core cache, providing you with an API-less feature set and giving you a more 'pojo' feel to your application with minimal intrusion.

Versions

The current stable release, recommended for general use, is JBoss Cache 2.1.1 "Alegrias". Note that this is not binary-compatible with JBoss Cache 1.x and if you need that level of binary compatibility the recommended version is JBoss Cache 1.4.1 "Cayenne".

The next release in the wings is JBoss Cache 2.2.0 "Poblano" and is currently in active development, currently in the final CR stages. 3.0.0 "Naga" is the hot new release currently under very heavy development. Expect an alpha of 3.0.0 very soon.

Learning about JBoss Cache

A tutorial and FAQ for both core and pojo editions are provided, along with the formal user guide.

JBoss Cache can be used either inside JBoss, with a different application server, or as a standalone product.

Here is official JBossCache main documentation page. This wiki page will serve for some additional materials.

Want to help us translate JBoss Cache documentation to a language of your choice? See the JBossCacheDocI18n page!

Troubleshooting

Here is the page for some tips on troubleshooting JBoss Cache.

Test Suite

• CodeCoverageAnalysis

More information

• Migrating from JBoss Cache 1.x.x to 2.x.x? Then read JBossCache200Migration
• Roadmap: is available: RoadMapOverview
• JBossCache on J2EE servers:
• JBoss Cache 1.4.x is always available and runs transparently on JBoss AS 4.x.
• JBoss Cache 1.4.x has been tested on J2SE 1.4 and Java SE 5.0. While it may work on Java SE 6, this hasn't been extensively tested.
• JBoss Cache 2.x is always available and runs transparently on the upcoming JBoss AS 5.x.
• JBoss Cache 2.x does not have support for J2SE 1.4 and requires either Java SE 5.0 or Java SE 6, both of which are extensively tested with JBoss Cache 2.x.
• For information on running JBoss Cache 2.x under J2SE 1.4, see this wiki page: JBossCacheHabaneroJava1.4
• JBossCacheAsCompatibility - a HOWTO for running JBoss Cache 2.x under JBoss AS 4.x safely.
• JBossCacheAndWebLogic - for a quick HOWTO on running JBoss Cache under BEA WebLogic 8.1, utilising a startup and shutdown class to initialize the cluster-wide caching service.
• JBossCacheAndWAS For a quick overview on how to run JBossCache in WebSphere?
• JBossCacheAndWAS_6.x - for a quick HOWTO on running JBoss Cache under WebSphere? 6.x series
• Hibernate integration: See JBossCacheHibernate for information and tips on using JBossCache as a 2nd-level cache in Hibernate
• Building JBossCache: To build a distribution for JBossCache, you will need to build the whole jboss-head project since cache depends on other libraries, e.g., jboss-aop, system, etc. Simply go to build directory and do a "build.sh", it should build the whole shebang. After that if you want distro, under cache, do "build.sh dist".
• Optimistic Locking: With JBossCache 1.3 "Wasabi", JBossCache now has a new locking mechanism to prevent deadlocks and improve concurent throughput while providing a high level of data integrity. See OptimisticNodeLocking.
• Buddy Replication: Have trouble replicating a lot of state to many machines in a cluster (whether using JBossCache, or other techs that use JBossCache such as http state replication)? Read JBossCacheBuddyReplication and JBossCacheBuddyReplicationDesign!
• Configuring your cache loader: This document talks about configuring cache loaders in JBossCache 1.3.0 "Wasabi", changes and new features in the way cache loaders work.
• JDBC-based cache loader: see JDBCCacheLoader for information and tips on how to configure JDBCCacheLoader with various DBMS.
• Accessing and Monitoring JBoss Cache using JMX: JBossCacheMBeans describes how to access JBoss Cache using its JMX MBeans. With JBoss Cache 1.3.0, this is also possible when running in a standalone (e.g., non-server) JDK 5.0 environment.
• Clustering patterns library: The clustering patterns library contains configuration strategies for high availability using JBoss Cache.
• Running JBoss Cache with the JGroups Multiplexer : See JBossCacheMultiplexer

Upgrading and Compatibility Information

JBoss Cache developer's page

For Subversion information, tags and branches, and tips on developing and debugging JBoss Cache, see JBossCacheDevelopment.

JBoss Cache & JGroups version compatibility

See http://labs.jboss.com/portal/jbosscache/compatibility/index.html for details

JBoss Cache & JDK Requirements

Here is the PojoCache wiki page

.

Other languages: