org.cristalise.storage

Class MemoryOnlyClusterStorage

java.lang.Object

org.cristalise.kernel.persistency.ClusterStorage

org.cristalise.storage.MemoryOnlyClusterStorage

public class MemoryOnlyClusterStorage
extends ClusterStorage

Field Summary

Fields inherited from class org.cristalise.kernel.persistency.ClusterStorage

NONE, READ, READWRITE, WRITE

Constructor Summary

Constructors

Constructor and Description
MemoryOnlyClusterStorage()

Method Summary

Modifier and Type	Method and Description
void	abort(TransactionKey transactionKey)
void	begin(TransactionKey transactionKey)
boolean	checkQuerySupport(String language) Checks whether the storage support the given type of query or not
void	clear()
void	close() Shuts down the storage.
void	commit(TransactionKey transactionKey)
void	delete(ItemPath thisItem, String path, TransactionKey transactionKey) Remove a CRISTAL local object from storage.
void	dumpContents(ItemPath thisItem)
String	executeQuery(Query query, TransactionKey transactionKey) Executes an SQL/OQL/XQuery/XPath/etc query in the target database.
C2KLocalObject	get(ItemPath thisItem, String path, TransactionKey transactionKey) Fetches a CRISTAL local object from storage by path
String[]	getClusterContents(ItemPath itemPath, ClusterType type, TransactionKey transactionKey) Queries the local path below the given type and returns the possible next elements.
String[]	getClusterContents(ItemPath thisItem, String path, TransactionKey transactionKey) Queries the local path below of the item and returns the possible next elements.
String	getId()
int	getLastIntegerId(ItemPath itemPath, String path, TransactionKey transactionKey) History and JobList based on a integer id that is incremented each tome a new Event or Job is stored
String	getName()
void	open(Authenticator auth) Connects to the storage.
void	postBoostrap() Informs the ClusterSorage that the Boostrap process has finished.
void	postConnect() Informs the ClusterSorage that connect was done.
void	postStartServer() Informs the ClusterSorage that the start server process has finished.
void	put(ItemPath thisItem, C2KLocalObject obj, TransactionKey transactionKey) Stores a CRISTAL local object.
short	queryClusterSupport(ClusterType clusterType) Declares whether or not this ClusterStorage can read or write a particular CRISTAL local object type.

Methods inherited from class org.cristalise.kernel.persistency.ClusterStorage

getClusters, getClusterType, getPath

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MemoryOnlyClusterStorage

public MemoryOnlyClusterStorage()

Method Detail

clear

public void clear()

open

public void open(Authenticator auth)
          throws PersistencyException

Description copied from class: ClusterStorage

Connects to the storage. It must be possible to retrieve CRISTAL local objects after this method returns.

Specified by:

open in class ClusterStorage

Parameters:

auth - The Authenticator instance that the user or server logged in with.

Throws:

PersistencyException - If storage initialization failed

close

public void close()
           throws PersistencyException

Description copied from class: ClusterStorage

Shuts down the storage. Data must be completely written to disk before this method returns, so the process can exit. No further gets or puts should follow.

Specified by:

close in class ClusterStorage

Throws:

PersistencyException - If closing failed

checkQuerySupport

public boolean checkQuerySupport(String language)

Description copied from class: ClusterStorage

Checks whether the storage support the given type of query or not

Specified by:

checkQuerySupport in class ClusterStorage

Parameters:

language - type of the query (e.g. SQL/XQuery/XPath/....)

Returns:

whether the Storage supports the type of the query or not

queryClusterSupport

public short queryClusterSupport(ClusterType clusterType)

Description copied from class: ClusterStorage

Declares whether or not this ClusterStorage can read or write a particular CRISTAL local object type.

Specified by:

queryClusterSupport in class ClusterStorage

Parameters:

clusterType - The Cluster type requested

Returns:

A ClusterStorage constant: NONE, READ, WRITE, or READWRITE

getName

public String getName()

Specified by:

getName in class ClusterStorage

Returns:

A full name of this storage for logging

getId

public String getId()

Specified by:

getId in class ClusterStorage

Returns:

A short code for this storage for reference

executeQuery

public String executeQuery(Query query,
                           TransactionKey transactionKey)
                    throws PersistencyException

Description copied from class: ClusterStorage

Executes an SQL/OQL/XQuery/XPath/etc query in the target database.

Specified by:

executeQuery in class ClusterStorage

Parameters:

query - the query to be executed

transactionKey - the key of the transaction, can be null

Returns:

the xml result of the query

Throws:

PersistencyException

get

public C2KLocalObject get(ItemPath thisItem,
                          String path,
                          TransactionKey transactionKey)
                   throws PersistencyException

Description copied from class: ClusterStorage

Fetches a CRISTAL local object from storage by path

Specified by:

get in class ClusterStorage

Parameters:

thisItem - The ItemPath of the containing Item

path - The path of the local object

transactionKey - the key of the transaction, can be null

Returns:

The C2KLocalObject, or null if the object was not found

Throws:

PersistencyException - when retrieval failed

put

public void put(ItemPath thisItem,
                C2KLocalObject obj,
                TransactionKey transactionKey)
         throws PersistencyException

Description copied from class: ClusterStorage

Stores a CRISTAL local object. The path is automatically generated.

Specified by:

put in class ClusterStorage

Parameters:

thisItem - The Item that the object will be stored under

obj - The C2KLocalObject to store

transactionKey - the key of the transaction, cannot be null

Throws:

PersistencyException - When storage fails

delete

public void delete(ItemPath thisItem,
                   String path,
                   TransactionKey transactionKey)
            throws PersistencyException

Description copied from class: ClusterStorage

Remove a CRISTAL local object from storage. This should be used sparingly and responsibly, as it violated traceability. Objects removed in this way are not expected to be recoverable.

Specified by:

delete in class ClusterStorage

Parameters:

thisItem - The containing Item

path - The path of the object to be removed

transactionKey - the key of the transaction, cannot be null

Throws:

PersistencyException - When deletion fails or is not allowed

getClusterContents

public String[] getClusterContents(ItemPath thisItem,
                                   String path,
                                   TransactionKey transactionKey)
                            throws PersistencyException

Description copied from class: ClusterStorage

Queries the local path below of the item and returns the possible next elements.

Specified by:

getClusterContents in class ClusterStorage

Parameters:

thisItem - The Item to query

path - The path within that Item to query. May be ClusterStorage.ROOT (empty String)

transactionKey - the key of the transaction, can be null

Returns:

A String array of the possible next path elements

Throws:

PersistencyException - When an error occurred during the query

getClusterContents

public String[] getClusterContents(ItemPath itemPath,
                                   ClusterType type,
                                   TransactionKey transactionKey)
                            throws PersistencyException

Description copied from class: ClusterStorage

Queries the local path below the given type and returns the possible next elements.

Overrides:

getClusterContents in class ClusterStorage

transactionKey - the key of the transaction, can be null

Returns:

Throws:

PersistencyException

dumpContents

public void dumpContents(ItemPath thisItem)

postBoostrap

public void postBoostrap()

Description copied from class: ClusterStorage

Informs the ClusterSorage that the Boostrap process has finished. It enables the implementation to perform domain specific tasks

Specified by:

postBoostrap in class ClusterStorage

postStartServer

public void postStartServer()

Description copied from class: ClusterStorage

Informs the ClusterSorage that the start server process has finished. It enables the implementation to perform domain specific tasks

Specified by:

postStartServer in class ClusterStorage

postConnect

public void postConnect()

Description copied from class: ClusterStorage

Informs the ClusterSorage that connect was done. It enables the implementation to perform domain specific tasks

Specified by:

postConnect in class ClusterStorage

getLastIntegerId

public int getLastIntegerId(ItemPath itemPath,
                            String path,
                            TransactionKey transactionKey)
                     throws PersistencyException

Description copied from class: ClusterStorage

History and JobList based on a integer id that is incremented each tome a new Event or Job is stored

Specified by:

getLastIntegerId in class ClusterStorage

Parameters:

itemPath - The ItemPath (UUID) of the containing Item

path - the cluster patch, either equals to 'AuditTrail' or 'Job'

transactionKey - the key of the transaction, can be null

Returns:

returns the last found integer id (zero based), or -1 if not found

Throws:

PersistencyException - When storage fails

begin

public void begin(TransactionKey transactionKey)
           throws PersistencyException

Specified by:

begin in class ClusterStorage

Throws:

PersistencyException

commit

public void commit(TransactionKey transactionKey)
            throws PersistencyException

Specified by:

commit in class ClusterStorage

Throws:

PersistencyException

abort

public void abort(TransactionKey transactionKey)
           throws PersistencyException

Specified by:

abort in class ClusterStorage

Throws:

PersistencyException