org.dlese.dpc.datamgr

Class DataManager

java.lang.Object

org.dlese.dpc.datamgr.DataManager

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

SerializedDataManager

public abstract class DataManager
extends java.lang.Object
implements java.io.Serializable

Provides an abstract implementation of a common interface for applications needing to work with a data store. Implementers of DataListener register with a DataManager instance. An instance of data is uniquely identified using an object identifier. Applications must request locks to restrict writing of data.

Version:

1.0, 9/30/02

Author:

Dave Deniman, John Weatherley

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
DataManager()

Method Summary

Modifier and Type	Method and Description
abstract boolean	delete(java.lang.String oid) Deletes an existing data object iff the object is not locked.
abstract boolean	delete(java.lang.String oid, java.lang.String lockKey) Deletes an existing data object, assuming the caller had requested and recieved the necessary lock.
abstract java.util.List	get(java.util.List oids) Retrieves a List of data objects.
abstract java.lang.Object	get(java.lang.String oid) Retrieves a single data object.
abstract boolean	isLocked(java.lang.String oid) Determine whether a given object is locked.
abstract boolean	isValidLock(java.lang.String oid, java.lang.String lockKey) Determine whether a given object is locked with the given key.
abstract java.lang.String	lock(java.lang.String oid) Request a lock for a data object.
abstract boolean	oidExists(java.lang.String oid) Determines whether an object with the given oid exists in the DataManager.
abstract java.lang.Object	put(java.lang.String oid, java.lang.Object obj) Adds a new object of data.
abstract java.lang.Object	remove(java.lang.String oid) Removes an existing data object iff the object is not locked.
abstract java.lang.Object	remove(java.lang.String oid, java.lang.String lockKey) Removes an existing data object, assuming the caller had requested and recieved the necessary lock.
abstract boolean	unlock(java.lang.String oid, java.lang.String lockKey) Remove the lock on a data object.
abstract java.lang.Object	update(java.lang.String oid, java.lang.Object obj) Updates a new object of data iff the object is not locked.
abstract java.lang.Object	update(java.lang.String oid, java.lang.Object obj, java.lang.String lockKey) Updates a new object of data, assuming the caller had requested and recieved the necessary lock.

Methods inherited from class java.lang.Object

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

Constructor Detail

DataManager

public DataManager()

Method Detail

get

public abstract java.lang.Object get(java.lang.String oid)
                              throws OIDDoesNotExistException

Retrieves a single data object.

Parameters:

oid - The data identifier

Returns:

Object of data

Throws:

OIDDoesNotExistException

get

public abstract java.util.List get(java.util.List oids)
                            throws OIDDoesNotExistException

Retrieves a List of data objects.

Parameters:

oids - List of data identifiers

Returns:

List of corresponding data objects

Throws:

OIDDoesNotExistException

put

public abstract java.lang.Object put(java.lang.String oid,
                                     java.lang.Object obj)
                              throws OIDAlreadyExistsException,
                                     ObjectNotSupportedException

Adds a new object of data.

Parameters:

oid - The unique identifier that references the new data object

obj - The new data object

Returns:

The added data object, if successful

Throws:

OIDAlreadyExistsException

ObjectNotSupportedException

remove

public abstract java.lang.Object remove(java.lang.String oid,
                                        java.lang.String lockKey)
                                 throws OIDDoesNotExistException,
                                        InvalidLockException

Removes an existing data object, assuming the caller had requested and recieved the necessary lock.

Parameters:

oid - The unique identifier that references the data object to be removed

lockKey - The key corresponding to the lock on this data object

Returns:

The removed data object, if successful

Throws:

OIDDoesNotExistException

InvalidLockException

remove

public abstract java.lang.Object remove(java.lang.String oid)
                                 throws OIDDoesNotExistException,
                                        LockNotAvailableException

Removes an existing data object iff the object is not locked. If the object is locked a LockNotAvailableException is thrown. After successful completion the object is removed from the DataManager and returned to the caller.

Parameters:

oid - The unique identifier that references the data object to be removed

Throws:

OIDDoesNotExistException

LockNotAvailableException

delete

public abstract boolean delete(java.lang.String oid,
                               java.lang.String lockKey)
                        throws OIDDoesNotExistException,
                               InvalidLockException

Deletes an existing data object, assuming the caller had requested and recieved the necessary lock. Similar to remove() except no object is returned and thus is more efficient if an object is not required.

Parameters:

oid - The unique identifier that references the data object to be deleted

lockKey - The key corresponding to the lock on this data object

Throws:

OIDDoesNotExistException

InvalidLockException

delete

public abstract boolean delete(java.lang.String oid)
                        throws OIDDoesNotExistException,
                               LockNotAvailableException

Deletes an existing data object iff the object is not locked. If the object is locked a LockNotAvailableException is thrown. Similar to remove() except no object is returned and thus is more efficient. After successful completion the object is deleted from the DataManager.

Parameters:

oid - The unique identifier that references the data object to be deleted

Throws:

OIDDoesNotExistException

LockNotAvailableException

update

public abstract java.lang.Object update(java.lang.String oid,
                                        java.lang.Object obj,
                                        java.lang.String lockKey)
                                 throws OIDDoesNotExistException,
                                        ObjectNotSupportedException,
                                        InvalidLockException

Updates a new object of data, assuming the caller had requested and recieved the necessary lock.

Parameters:

oid - The unique identifier that references the data object to be updated

obj - The new updated data object

lockKey - The key corresponding to the lock on this data object

Returns:

The updated data object, if successful

Throws:

OIDDoesNotExistException

ObjectNotSupportedException

InvalidLockException

update

public abstract java.lang.Object update(java.lang.String oid,
                                        java.lang.Object obj)
                                 throws OIDDoesNotExistException,
                                        ObjectNotSupportedException,
                                        LockNotAvailableException

Updates a new object of data iff the object is not locked. If the object is locked a LockNotAvailableException is thrown.

Parameters:

oid - The unique identifier that references the data object to be updated

obj - The new updated data object

Returns:

The updated data object, if successful otherwise null

Throws:

OIDDoesNotExistException

ObjectNotSupportedException

LockNotAvailableException

lock

public abstract java.lang.String lock(java.lang.String oid)
                               throws OIDDoesNotExistException,
                                      LockNotAvailableException

Request a lock for a data object.

Parameters:

oid - The unique identifier that references the data object to be locked

Returns:

The key for this lock, as a String, if successful

Throws:

OIDDoesNotExistException

LockNotAvailableException

unlock

public abstract boolean unlock(java.lang.String oid,
                               java.lang.String lockKey)
                        throws OIDDoesNotExistException,
                               InvalidLockException

Remove the lock on a data object.

Parameters:

oid - The unique identifier that references the locked data object

lockKey - The key corresponding to the lock on this data object

Returns:

true if successful, false otherwise

Throws:

OIDDoesNotExistException

InvalidLockException

oidExists

public abstract boolean oidExists(java.lang.String oid)

Determines whether an object with the given oid exists in the DataManager.

Parameters:

oid - The unique identifier that references the data object

Returns:

True iff the given object exists in this DataManager

isLocked

public abstract boolean isLocked(java.lang.String oid)

Determine whether a given object is locked.

Parameters:

oid - The unique identifier that references the data object

Returns:

True iff the object referred to by this oid is locked

isValidLock

public abstract boolean isValidLock(java.lang.String oid,
                                    java.lang.String lockKey)

Determine whether a given object is locked with the given key.

Parameters:

oid - The unique identifier that references the data object

lockKey - The lock key

Returns:

True iff the object referred to by this oid is locked with the given key