org.castor.cache.distributed

Class GigaspacesCache

Implemented Interfaces:
Cache, Map

public final class GigaspacesCache
extends AbstractDistributedCache

Gigaspaces implementation of Castor JDO Cache.

Gigaspaces supports a wide variety of cache topologies, allowing the user to distribute and/or replicate application data as needed. This cache instance replicates this flexibility by allowing you to configure it (and thus the underlying Gigaspaces instance) as follows.
 <cache-type type="gigaspaces">
    <cacheUrl>/./</cacheURL>
    <cacheProperties>schema=cache</cacheProperties>
 </cache-type>
 
As mentioned briefly above, the main issue is the cache topology usage. Per definition, Gigaspaces caches can be started in various modes:


Each of the above can run in replicated or partitioned mode. This means you should run several instance in one of the above mode using the relevant schema name, total_membres and id.

instance 1:
"/./myCache?schema=cache&cluster_schema=replicated&total_members=2&id=1"

instance 2:
"/./myCache?schema=cache&cluster_schema=replicated&total_members=2&id=2"
or

instance 1:
"/./myCache?schema=cache&cluster_schema=partitioned&total_members=2&id=1"

instance 2:
"/./myCache?schema=cache&cluster_schema=partitioned&total_members=2&id=2"

When running the cache in server or in embedded mode, you must have the cache schema to be used, i.e. 'schema=cache'.
For more information on cache topoligies and the use of URLs with Gigaspaces, please see here.
For more details on Gigaspaces in general, please see http://www.gigaspaces.com/.

Version:
$Revision: 5951 $ $Date: 2006-04-25 16:09:10 -0600 (Tue, 25 Apr 2006) $
Author:
Werner Guttmann
Since:
1.0
See Also:
The Gigaspaces Home Page, The Gigaspaces Wiki

Field Summary

static String
IMPLEMENTATION
The classname of the implementations factory class.
static String
TYPE
The type of the cache.

Fields inherited from interface org.castor.cache.Cache

DEFAULT_DEBUG, DEFAULT_NAME, DEFAULT_TYPE, PARAM_DEBUG, PARAM_NAME, PARAM_TYPE

Method Summary

String
getType()
void
initialize(Properties params)
void
initialize(String implementation, Properties params)
Normally called to initialize CoherenceCache.

Methods inherited from class org.castor.cache.distributed.AbstractDistributedCache

clear, containsKey, containsValue, entrySet, get, getCache, isEmpty, keySet, put, putAll, remove, setCache, size, values

Methods inherited from class org.castor.cache.AbstractBaseCache

close, expire, expireAll, getName, initialize, invokeMethod, invokeStaticMethod

Field Details

IMPLEMENTATION

public static final String IMPLEMENTATION
The classname of the implementations factory class.

TYPE

public static final String TYPE
The type of the cache.

Method Details

getType

public String getType()
Specified by:
getType in interface Cache

initialize

public void initialize(Properties params)
            throws CacheAcquireException
Specified by:
initialize in interface Cache
Overrides:
initialize in interface AbstractBaseCache
See Also:
org.castor.cache.Cache.initialize(java.util.Properties)

initialize

public void initialize(String implementation,
                       Properties params)
            throws CacheAcquireException
Normally called to initialize CoherenceCache. To be able to test the method without having com.tangosol.net.CacheFactory implementation, it can also be called with a test implementations classname.
Parameters:
implementation - Cache implementation classname to initialize.
params - Parameters to initialize the cache (e.g. name, capacity).
Throws:
CacheAcquireException - If cache can not be initialized.

Intalio Inc. (C) 1999-2006. All rights reserved http://www.intalio.com