org.cristalise.storage

Class ProxyLoader

java.lang.Object

org.cristalise.kernel.persistency.ClusterStorage

org.cristalise.storage.ProxyLoader

public class ProxyLoader
extends ClusterStorage

Used by proxies to load clusters by queryData from the Entity. Last client storage - only used if not cached elsewhere

Field Summary

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

allClusterTypes, COLLECTION, HISTORY, JOB, LIFECYCLE, NONE, OUTCOME, PATH, PROPERTY, READ, READWRITE, ROOT, VIEWPOINT, WRITE

Constructor Summary

Constructors

Constructor and Description
ProxyLoader()

Method Summary

Modifier and Type	Method and Description
boolean	checkQuerySupport(String language) Checks whether the storage support the given type of query or not
void	close() Shuts down the storage.
void	delete(ItemPath thisItem, String path) delete cluster not supported
String	executeQuery(Query query) Executes an SQL/OQL/XQuery/XPath/etc query in the target database.
C2KLocalObject	get(ItemPath thisItem, String path) retrieve object by path
String[]	getClusterContents(ItemPath thisItem, String path) Directory listing
String	getId()
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) store object not supported
short	queryClusterSupport(String 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

getClusterContents, getClusters, getClusterType, getPath, queryClusterSupport

Methods inherited from class java.lang.Object

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

Constructor Detail

ProxyLoader

public ProxyLoader()

Method Detail

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

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

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(String 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. Must be one of the Cluster type constants from this class.

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)
                    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

Returns:

the xml result of the query

Throws:

PersistencyException

get

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

retrieve object by path

Specified by:

get in class ClusterStorage

Parameters:

thisItem - The ItemPath of the containing Item

path - The path of the local object

Returns:

The C2KLocalObject, or null if the object was not found

Throws:

PersistencyException - when retrieval failed

put

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

store object not supported

Specified by:

put in class ClusterStorage

Parameters:

thisItem - The Item that the object will be stored under

obj - The C2KLocalObject to store

Throws:

PersistencyException - When storage fails

delete

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

delete cluster not supported

Specified by:

delete in class ClusterStorage

Parameters:

thisItem - The containing Item

path - The path of the object to be removed

Throws:

PersistencyException - When deletion fails or is not allowed

getClusterContents

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

Directory listing

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)

Returns:

A String array of the possible next path elements

Throws:

PersistencyException - When an error occurred during the query