Skip navigation

Integrations - Terracotta Cache

Article Rating?

Product Type Caching
Versions Supported Not Applicable
Module Status Forge download
Module Availability - Released (latest) See Terracotta Forge Releases
Module Availability - SNAPSHOT (latest) See Terracotta Forge Snapshots
Download with Kit Not Included

Introduction

Terracotta Cache, a Terracotta integration module (TIM), is a drop-in replacement for JBoss TreeCache and PojoCache. Terracotta Cache is a distributed cache that is API-compatible with the JBoss TreeCache and PojoCache components. Terracotta Cache can replace these JBoss components with minimal code changes.

Typically, simply changing 1 line of code to instantiate TerracottaCache() instead of TreeCache() is enough because Terracotta Cache maintains most of the JBoss TreeCache APIs.

Dependencies

The following integration modules must be installed with the Terracotta Cache module:

  • tim-synchronizedcollection
  • tim-synchronizedset
  • tim-synchronizedsortedset
  • tim-synchronizedmap
  • tim-synchronizedsortedmap

See Auto-Locked Collections for more information.

Implementation

After you download and unpack the synchronized Java collection TIMs into the Terracotta modules directory, add the following to your tc-config.xml:

<clients>
   <modules>
      <module name="tim-terracotta-cache" version="1.1.0" group-id="org.terracotta.modules"/>
   </modules>
</clients>

The version attribute matches the TIM version.

The <module> element shown is configured for a TIM installed in the <TC_HOME>/modules/org/terracotta/modules directory. For information on installing TIMs in other directories, see the Configuration Guide and Reference.

Known Issues

  • Client applications should declare a CacheManager field and mark it as root.
  • TerraCotta Cache currently replaces JBoss Cache v.1.4. Due to incompatible API changes, it can not replace JBoss Cache 2.0.
Adaptavist Theme Builder Powered by Atlassian Confluence