Package com.alachisoft.ncache.client.datastructures

Interface DataStructureManager

All Superinterfaces:

CollectionManager

public interface DataStructureManager
extends CollectionManager

This interface contains create and get operations for the Counter and remove operation for all distributed data structures.

Method Summary

Modifier and Type	Method	Description
Counter	createCounter(java.lang.String key)	Creates the counter against the provided name.
Counter	createCounter(java.lang.String key, long initialValue)	Creates the counter against the provided name.
Counter	createCounter(java.lang.String name, DataStructureAttributes attributes, long initialValue, WriteThruOptions options)	Creates the counter against the provided name and configures it according to the provided user configuration as attributes.
Counter	getCounter(java.lang.String key)	Gets Counter interface against the provided name.
Counter	getCounter(java.lang.String key, ReadThruOptions options)	Gets Counter interface against the provided name with backing source Read Thru option.
void	remove(java.lang.String key)	Remove the specified data structure.
void	remove(java.lang.String key, WriteThruOptions writeThruOptions)	Remove the specified data structure.

Methods inherited from interface com.alachisoft.ncache.client.datastructures.CollectionManager

createHashSet, createHashSet, createList, createList, createMap, createMap, createQueue, createQueue, getHashSet, getHashSet, getList, getList, getMap, getMap, getQueue, getQueue

Method Detail

createCounter

Counter createCounter(java.lang.String key)
               throws CacheException,
                      java.lang.IllegalArgumentException

Creates the counter against the provided name.

Parameters:

key - is unqiue identifier for counter object.Initial value of counter is zero.

Returns:

Interface for using counters.

Throws:

CacheException

java.lang.IllegalArgumentException

createCounter

Counter createCounter(java.lang.String key,
                      long initialValue)
               throws CacheException,
                      java.lang.IllegalArgumentException

Creates the counter against the provided name.

Parameters:

key - is unqiue identifier for counter object.

initialValue - is starting index of counter object.

Returns:

Interface for using counters.

Throws:

CacheException

java.lang.IllegalArgumentException

createCounter

Counter createCounter(java.lang.String name,
                      DataStructureAttributes attributes,
                      long initialValue,
                      WriteThruOptions options)
               throws CacheException,
                      java.lang.IllegalArgumentException

Creates the counter against the provided name and configures it according to the provided user configuration as attributes.

Parameters:

name - is unqiue identifier for counter object.

attributes - DataStructureAttributes for providing user configuration for this collection.

initialValue - is starting index of counter object

options - WriteThruOptions regarding updating data source. This can be WriteThru, WriteBehind or None.

Returns:

Interface for using counters.

Throws:

CacheException

java.lang.IllegalArgumentException

remove

void remove(java.lang.String key)
     throws CacheException,
            java.io.IOException

Remove the specified data structure.

Parameters:

key - Name of the data type.

Throws:

CacheException

java.io.IOException

remove

void remove(java.lang.String key,
            WriteThruOptions writeThruOptions)
     throws CacheException,
            java.io.IOException

Remove the specified data structure.

Parameters:

key - Name of the data type.

writeThruOptions - WriteThruOptions regarding updating data source. This can be WriteThru, WriteBehind or None.

Throws:

CacheException

java.io.IOException

getCounter

Counter getCounter(java.lang.String key)
            throws CacheException,
                   java.lang.IllegalArgumentException

Gets Counter interface against the provided name.

Parameters:

key - Name of counter.

Returns:

Interface for using counters.

Throws:

CacheException

java.lang.IllegalArgumentException

getCounter

Counter getCounter(java.lang.String key,
                   ReadThruOptions options)
            throws CacheException,
                   java.lang.IllegalArgumentException

Gets Counter interface against the provided name with backing source Read Thru option.

Parameters:

key - Name of counter.

options - ReadThruOptions to read from data source. These can be either ReadThru, ReadThruForced or None.

Returns:

Interface for using counters.

Throws:

CacheException

java.lang.IllegalArgumentException