org.jasig.portal.concurrency.locking
Class EntityLockImpl

java.lang.Object
  org.jasig.portal.concurrency.locking.EntityLockImpl

All Implemented Interfaces:

IEntityLock

public class EntityLockImpl
extends Object
implements IEntityLock

An implementation of IEntityLock. A lock is granted to a lockOwner for an entityType and entityKey. It guarantees some degree of exclusive access to the entity, depending on lockType and expirationTime.

Version:

$Revision: 19776 $

Author:

Dan Ellentuck

See Also:

IEntityLock

Constructor Summary

protected	EntityLockImpl(Class newEntityType, String newEntityKey, int newLockType, Date newExpirationTime, String newLockOwner)
protected	EntityLockImpl(Class newEntityType, String newEntityKey, int newLockType, Date newExpirationTime, String newLockOwner, IEntityLockService newService)

Method Summary

void	convert(int newType) Delegate to the service.
void	convert(int newType, int duration) Delegate to the service.
boolean	equals(Object obj)
protected void	expire()
protected void	finalize()
String	getEntityKey()
Class	getEntityType()
Date	getExpirationTime()
String	getLockOwner() Could be the portal user or the framework or ...?
int	getLockType() See IEntityLockingService for a description of lock types.
protected IEntityLockService	getService()
int	hashCode() This method is supported primarily for hash tables, such as those provided in java.util.
boolean	isLocked() Answer if the lock is unexpired.
boolean	isValid() Delegate to the service.
void	release() Delegate to the service.
void	renew() Delegate to the service.
void	renew(int duration) Delegate to the service.
String	toString() Returns a String that represents the value of this object.

Methods inherited from class java.lang.Object

clone, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

EntityLockImpl

protected EntityLockImpl(Class newEntityType,
                         String newEntityKey,
                         int newLockType,
                         Date newExpirationTime,
                         String newLockOwner)

EntityLockImpl

protected EntityLockImpl(Class newEntityType,
                         String newEntityKey,
                         int newLockType,
                         Date newExpirationTime,
                         String newLockOwner,
                         IEntityLockService newService)

Method Detail

convert

public void convert(int newType)
             throws LockingException

Delegate to the service.

Specified by:

convert in interface IEntityLock

Parameters:

newType - int

Throws:

LockingException - - if the conversion fails.

convert

public void convert(int newType,
                    int duration)
             throws LockingException

Delegate to the service.

Specified by:

convert in interface IEntityLock

Parameters:

newType - int

duration - int

Throws:

LockingException - - if the conversion fails.

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

Parameters:

obj - the Object to compare with

Returns:

true if these Objects are equal; false otherwise.

See Also:

Hashtable

expire

protected void expire()

finalize

protected void finalize()
                 throws Throwable

Overrides:

finalize in class Object

Throws:

Throwable

getEntityKey

public String getEntityKey()

Specified by:

getEntityKey in interface IEntityLock

Returns:

java.lang.String

getEntityType

public Class getEntityType()

Specified by:

getEntityType in interface IEntityLock

Returns:

java.lang.Class

See Also:

for known types.

getExpirationTime

public Date getExpirationTime()

Specified by:

getExpirationTime in interface IEntityLock

Returns:

java.util.Date

getLockOwner

public String getLockOwner()

Could be the portal user or the framework or ...?

Specified by:

getLockOwner in interface IEntityLock

Returns:

java.lang.String

getLockType

public int getLockType()

See IEntityLockingService for a description of lock types.

Specified by:

getLockType in interface IEntityLock

Returns:

int

getService

protected IEntityLockService getService()

Returns:

org.jasig.portal.concurrency.locking.IEntityLockService

hashCode

public int hashCode()

This method is supported primarily for hash tables, such as those provided in java.util.

Overrides:

hashCode in class Object

Returns:

an integer hash code for the receiver

See Also:

Hashtable

isLocked

public boolean isLocked()

Answer if the lock is unexpired.

Returns:

boolean

isValid

public boolean isValid()
                throws LockingException

Delegate to the service.

Specified by:

isValid in interface IEntityLock

Returns:

boolean

Throws:

LockingException

release

public void release()
             throws LockingException

Delegate to the service.

Specified by:

release in interface IEntityLock

Throws:

LockingException

renew

public void renew()
           throws LockingException

Delegate to the service.

Specified by:

renew in interface IEntityLock

Throws:

LockingException

renew

public void renew(int duration)
           throws LockingException

Delegate to the service.

Specified by:

renew in interface IEntityLock

Throws:

LockingException

toString

public String toString()

Returns a String that represents the value of this object.

Overrides:

toString in class Object

Returns:

a string representation of the receiver