Package nl.info.webdav.locking

Class ResourceLocks

java.lang.Object

nl.info.webdav.locking.ResourceLocks

All Implemented Interfaces:

IResourceLocks

public class ResourceLocks
extends Object
implements IResourceLocks

Simple locking management for concurrent data access, NOT the webdav locking.

Field Summary

Fields

Modifier and Type	Field	Description
protected int	_cleanupCounter
protected Hashtable<String,LockedObject>	_locks	keys: path value: LockedObject from that path
protected Hashtable<String,LockedObject>	_locksByID	keys: id value: LockedObject from that id
protected LockedObject	_root
protected Hashtable<String,LockedObject>	_tempLocks	keys: path value: Temporary LockedObject from that path
protected Hashtable<String,LockedObject>	_tempLocksByID	keys: id value: Temporary LockedObject from that id
protected LockedObject	_tempRoot

Constructor Summary

Constructors

Constructor	Description
ResourceLocks()

Method Summary

Modifier and Type	Method	Description
void	checkTimeouts(ITransaction transaction, boolean temporary)	Deletes LockedObjects, where timeout has reached.
boolean	exclusiveLock(ITransaction transaction, String path, String owner, int depth, int timeout)	Tries to lock the resource at "path" exclusively.
LockedObject	getLockedObjectByID(ITransaction transaction, String id)	Gets the LockedObject corresponding to specified id.
LockedObject	getLockedObjectByPath(ITransaction transaction, String path)	Gets the locked object on specified path.
LockedObject	getTempLockedObjectByID(ITransaction transaction, String id)	Gets the LockedObject corresponding to specified id (lock token).
LockedObject	getTempLockedObjectByPath(ITransaction transaction, String path)	Gets the LockedObject on specified path.
boolean	lock(ITransaction transaction, String path, String owner, boolean exclusive, int depth, int timeout, boolean temporary)	Tries to lock the resource at "path".
boolean	sharedLock(ITransaction transaction, String path, String owner, int depth, int timeout)	Tries to lock the resource at "path" shared.
boolean	unlock(ITransaction transaction, String id, String owner)	Unlocks all resources at "path" (and all sub-folders if existing) that have the same owner.
void	unlockTemporaryLockedObjects(ITransaction transaction, String path, String owner)	Unlocks all resources at "path" (and all sub-folders if existing) that have the same owner.

Methods inherited from class java.lang.Object

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

Field Details

_cleanupCounter

protected int _cleanupCounter

_locks

protected Hashtable<String,LockedObject> _locks

keys: path value: LockedObject from that path

_locksByID

protected Hashtable<String,LockedObject> _locksByID

keys: id value: LockedObject from that id

_tempLocks

protected Hashtable<String,LockedObject> _tempLocks

keys: path value: Temporary LockedObject from that path

_tempLocksByID

protected Hashtable<String,LockedObject> _tempLocksByID

keys: id value: Temporary LockedObject from that id

_root

protected LockedObject _root

_tempRoot

protected LockedObject _tempRoot

Constructor Details

ResourceLocks

public ResourceLocks()

Method Details

lock

public boolean lock(ITransaction transaction,
 String path,
 String owner,
 boolean exclusive,
 int depth,
 int timeout,
 boolean temporary)
             throws LockFailedException

Description copied from interface: IResourceLocks

Tries to lock the resource at "path".

Specified by:

lock in interface IResourceLocks

Parameters:

transaction - the transaction

path - what resource to lock

owner - the owner of the lock

exclusive - if the lock should be exclusive (or shared)

depth - depth

timeout - lock duration in seconds.

Returns:

true if the resource at path was successfully locked, false if an existing lock prevented this

Throws:

LockFailedException - if the lock failed

unlock

public boolean unlock(ITransaction transaction,
 String id,
 String owner)

Description copied from interface: IResourceLocks

Unlocks all resources at "path" (and all sub-folders if existing) that have the same owner.

Specified by:

unlock in interface IResourceLocks

Parameters:

transaction - the transaction

id - id to the resource to unlock

owner - who wants to unlock

unlockTemporaryLockedObjects

public void unlockTemporaryLockedObjects(ITransaction transaction,
 String path,
 String owner)

Description copied from interface: IResourceLocks

Unlocks all resources at "path" (and all sub-folders if existing) that have the same owner.

Specified by:

unlockTemporaryLockedObjects in interface IResourceLocks

Parameters:

transaction - the transaction

path - what resource to unlock

owner - who wants to unlock

checkTimeouts

public void checkTimeouts(ITransaction transaction,
 boolean temporary)

Description copied from interface: IResourceLocks

Deletes LockedObjects, where timeout has reached.

Specified by:

checkTimeouts in interface IResourceLocks

Parameters:

transaction - the transaction

temporary - check timeout on temporary or real locks

exclusiveLock

public boolean exclusiveLock(ITransaction transaction,
 String path,
 String owner,
 int depth,
 int timeout)
                      throws LockFailedException

Description copied from interface: IResourceLocks

Tries to lock the resource at "path" exclusively.

Specified by:

exclusiveLock in interface IResourceLocks

Parameters:

transaction - the transaction

path - what resource to lock

owner - the owner of the lock

depth - depth

timeout - lock duration in seconds.

Returns:

true if the resource at path was successfully locked, false if an existing lock prevented this

Throws:

LockFailedException - if the lock failed

sharedLock

public boolean sharedLock(ITransaction transaction,
 String path,
 String owner,
 int depth,
 int timeout)
                   throws LockFailedException

Description copied from interface: IResourceLocks

Tries to lock the resource at "path" shared.

Specified by:

sharedLock in interface IResourceLocks

Parameters:

transaction - the transaction

path - what resource to lock

owner - the owner of the lock

depth - depth

timeout - lock Duration in seconds.

Returns:

true if the resource at path was successfully locked, false if an existing lock prevented this

Throws:

LockFailedException - if the lock failed

getLockedObjectByID

public LockedObject getLockedObjectByID(ITransaction transaction,
 String id)

Description copied from interface: IResourceLocks

Gets the LockedObject corresponding to specified id.

Specified by:

getLockedObjectByID in interface IResourceLocks

Parameters:

transaction - the transaction

id - lock token to requested resource

Returns:

LockedObject or null if no LockedObject on specified path exists

getLockedObjectByPath

public LockedObject getLockedObjectByPath(ITransaction transaction,
 String path)

Description copied from interface: IResourceLocks

Gets the locked object on specified path.

Specified by:

getLockedObjectByPath in interface IResourceLocks

Parameters:

transaction - the transaction

path - the path to requested resource

Returns:

LockedObject or null if no LockedObject on specified path exists

getTempLockedObjectByID

public LockedObject getTempLockedObjectByID(ITransaction transaction,
 String id)

Description copied from interface: IResourceLocks

Gets the LockedObject corresponding to specified id (lock token).

Specified by:

getTempLockedObjectByID in interface IResourceLocks

Parameters:

transaction - the transaction

id - the lock token to requested resource

Returns:

LockedObject or null if no LockedObject on specified path exists

getTempLockedObjectByPath

public LockedObject getTempLockedObjectByPath(ITransaction transaction,
 String path)

Description copied from interface: IResourceLocks

Gets the LockedObject on specified path.

Specified by:

getTempLockedObjectByPath in interface IResourceLocks

Parameters:

transaction - the transaction

path - path to requested resource

Returns:

LockedObject or null if no LockedObject on specified path exists