com.jalios.jcms

Class StrongLockManager

java.lang.Object

com.jalios.jcms.db.BasicDBListener

com.jalios.jcms.StrongLockManager

All Implemented Interfaces:

DBConstants, DBListener, PluginComponent

public class StrongLockManager
extends BasicDBListener

This class manages StrongLock.

Since:

jcms-6.2.0

Version:

$Revision: 52696 $

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	StrongLockManager.CacheEntry

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CACHE_ENABLED_PROP
static java.lang.String	CACHE_MAX_ENTRIES_PROP
static java.lang.String	DATA_ID_FIELD
static java.lang.String	REVISION

Fields inherited from interface com.jalios.jcms.db.DBConstants

ALL_CATEGORIES_SET_FIELD, AUTH_GRP_SET_FIELD, AUTH_MBR_SET_FIELD, AUTHOR_ID_FIELD, CATEGORIES_SET_FIELD, CDATE_FIELD, CHANNEL_JCMSDB_PROP, DBDATA_URID, HAS_NO_READ_RIGHTS, HIBERNATE_MAPPING_ADATE, HIBERNATE_MAPPING_AUTHOR, HIBERNATE_MAPPING_CDATE, HIBERNATE_MAPPING_EDATE, HIBERNATE_MAPPING_MDATE, HIBERNATE_MAPPING_PDATE, HIBERNATE_MAPPING_PSTATUS, HIBERNATE_MAPPING_TITLE, HIBERNATE_MAPPING_WORKFLOW_ID, HIBERNATE_MAPPING_WORKSPACE_ID, MDATE_FIELD, PSTATUS_FIELD, ROW_ID_FIELD, SCROLL_FETCH_SIZE, WORKFLOW_ID_FIELD, WORKSPACE_ID_FIELD

Method Summary

Methods

Modifier and Type	Method and Description
boolean	canRequestUnlock(Data data, Member mbr) Returns true if the given member can request the lock (by mail).
boolean	checkLockMember(Data data, Member mbr) Returns true if the given member has locked the given data or if the data is not locked.
static StrongLockManager	getInstance()
<T extends Data> java.util.Set<T>	getLockedDataSet(java.lang.Class<T> clazz) Returns all the locked data for the given class.
<T extends Data> java.util.Set<T>	getLockedDataSet(java.lang.Class<T> clazz, boolean useCache) Returns all the locked data for the given class.
java.lang.String	getLockInfo(Data data, java.util.Locale locale) Returns a string which explains who has the lock on the given data (return "" if the data is not locked)
StrongLock	getStrongLock(Data data) Returns the StrongLock bound to given data.
StrongLock	getStrongLock(Data data, boolean useCache) Returns the StrongLock bound to given data.
boolean	isLocked(Data data) Returns true if the given data is locked.
void	lock(Data data, Member mbr) Lock the given data for the given member.
void	onPostDelete(DBData data, org.hibernate.event.PostDeleteEvent event, boolean firstTime)
void	onPostInsert(DBData data, org.hibernate.event.PostInsertEvent event, boolean firstTime)
void	onPostUpdate(DBData data, org.hibernate.event.PostUpdateEvent event, boolean firstTime)
void	refreshCacheEntry(Data data) Invalidate the cache entries for the given publication
void	requestUnlock(Data data, Member mbr, java.lang.String message) Request to unlock the given data for the given member
void	resetCache() Reset the cache.
void	unlock(Data data) Unlock the given data, without checking the member.
void	unlock(Data data, Member mbr) Unlock the given data
void	unlock(Data data, Member mbr, boolean force) Unlock the given data

Methods inherited from class com.jalios.jcms.db.BasicDBListener

getAdateFromState, getAuthorIdFromState, getCdateFromState, getEdateFromState, getMdateFromState, getPdateFromState, getPrePstatus, getPrePstatus, getPstatusFromState, hasNoChange, hasNoChange, init, onPreUpdate

Methods inherited from class java.lang.Object

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

Field Detail

REVISION

public static final java.lang.String REVISION

See Also:

Constant Field Values

CACHE_ENABLED_PROP

public static final java.lang.String CACHE_ENABLED_PROP

See Also:

Constant Field Values

CACHE_MAX_ENTRIES_PROP

public static final java.lang.String CACHE_MAX_ENTRIES_PROP

See Also:

Constant Field Values

DATA_ID_FIELD

public static final java.lang.String DATA_ID_FIELD

See Also:

Constant Field Values

Method Detail

getInstance

public static StrongLockManager getInstance()

getStrongLock

public StrongLock getStrongLock(Data data)

Returns the StrongLock bound to given data.

Parameters:

data - the data

Returns:

the StrongLock bound to given data.

Since:

jcms-6.2.0

getStrongLock

public StrongLock getStrongLock(Data data,
                       boolean useCache)

Returns the StrongLock bound to given data.

Parameters:

data - the data

useCache - indicate if the cache can be used.

Returns:

the StrongLock bound to given data.

Since:

jcms-6.2.0

isLocked

public boolean isLocked(Data data)

Returns true if the given data is locked.

Parameters:

data - the data

Returns:

true if the given data is locked.

Since:

jcms-6.2.0

getLockedDataSet

public <T extends Data> java.util.Set<T> getLockedDataSet(java.lang.Class<T> clazz)

Returns all the locked data for the given class.

Type Parameters:

T - Any Data type

Parameters:

clazz - the class

Returns:

all the locked data for the given class.

Since:

jcms-6.2.0

getLockedDataSet

public <T extends Data> java.util.Set<T> getLockedDataSet(java.lang.Class<T> clazz,
                                                 boolean useCache)

Returns all the locked data for the given class.

Type Parameters:

T - Any Data type

Parameters:

clazz - the class

useCache - use the cache if true

Returns:

all the locked data for the given class.

Since:

jcms-6.2.0

lock

public void lock(Data data,
        Member mbr)

Lock the given data for the given member.

Parameters:

data - the data

mbr - the member who puts the lock.

Since:

jcms-6.2.0

unlock

public void unlock(Data data,
          Member mbr)

Unlock the given data

Parameters:

data - the data

mbr - the member who releases the lock (only the member who has locked and the admin can release the lock).

Since:

jcms-6.2.0

unlock

public void unlock(Data data)

Unlock the given data, without checking the member.

Parameters:

data - the data

Since:

jcms-6.2.0

unlock

public void unlock(Data data,
          Member mbr,
          boolean force)

Unlock the given data

Parameters:

data - the data

mbr - the member who releases the lock

force - if false only the member who has locked and the admin can release the lock.

Since:

jcms-6.2.0

checkLockMember

public boolean checkLockMember(Data data,
                      Member mbr)

Returns true if the given member has locked the given data or if the data is not locked.

Parameters:

data - the data

mbr - the member

Returns:

true if the given member has locked the given data or if the data is not locked.

Since:

jcms-6.2.0

getLockInfo

public java.lang.String getLockInfo(Data data,
                           java.util.Locale locale)

Returns a string which explains who has the lock on the given data (return "" if the data is not locked)

Parameters:

data - the data

locale - the locale

Returns:

a string which explains who has the lock.

Since:

jcms-6.2.0

canRequestUnlock

public boolean canRequestUnlock(Data data,
                       Member mbr)

Returns true if the given member can request the lock (by mail).

Parameters:

data - the data

mbr - the member who request the lock

Returns:

true if the given member can request the lock (by mail).

Since:

jcms-8.0.0

requestUnlock

public void requestUnlock(Data data,
                 Member mbr,
                 java.lang.String message)

Request to unlock the given data for the given member

Parameters:

data - the locked data

mbr - the member who request the lock

message - a free message from the member who request the lock

Since:

jcms-8.0.0

resetCache

public void resetCache()

Reset the cache. A new cache is initialized.

Since:

jcms-6.2.0

refreshCacheEntry

public void refreshCacheEntry(Data data)

Invalidate the cache entries for the given publication

Parameters:

data - the publication id

Since:

jcms-6.2.0

onPostInsert

public void onPostInsert(DBData data,
                org.hibernate.event.PostInsertEvent event,
                boolean firstTime)

Specified by:

onPostInsert in interface DBListener

Overrides:

onPostInsert in class BasicDBListener

See Also:

DBListener.onPostInsert(DBData, PostInsertEvent, boolean)

onPostUpdate

public void onPostUpdate(DBData data,
                org.hibernate.event.PostUpdateEvent event,
                boolean firstTime)

Specified by:

onPostUpdate in interface DBListener

Overrides:

onPostUpdate in class BasicDBListener

See Also:

DBListener.onPostUpdate(DBData, PostUpdateEvent, boolean)

onPostDelete

public void onPostDelete(DBData data,
                org.hibernate.event.PostDeleteEvent event,
                boolean firstTime)

Specified by:

onPostDelete in interface DBListener

Overrides:

onPostDelete in class BasicDBListener

See Also:

DBListener.onPostDelete(DBData, PostDeleteEvent, boolean)