Examples of org.apache.commons.transaction.locking.GenericLock

Package org.apache.commons.transaction.locking

Examples of org.apache.commons.transaction.locking.GenericLock

org.apache.commons.transaction.locking.GenericLock
A generic implementaion of a simple multi level lock.
The idea is to have an ascending number of lock levels ranging from 0 to maxLockLevel as specified in {@link #GenericLock(Object,int,LoggerFacade)}: the higher the lock level the stronger and more restrictive the lock. To determine which lock may coexist with other locks you have to imagine matching pairs of lock levels. For each pair both parts allow for all lock levels less than or equal to the matching other part. Pairs are composed by the lowest and highest level not yet part of a pair and successively applying this method until no lock level is left. For an even amount of levels each level is part of exactly one pair. For an odd amount the middle level is paired with itself. The highst lock level may coexist with the lowest one (0) which by definition means NO LOCK. This implies that you will have to specify at least one other lock level and thus set maxLockLevel to at least 1.

Although this may sound complicated, in practice this is quite simple. Let us imagine you have three lock levels:
- 0: NO LOCK (always needed by the implementation of this lock)
- 1: SHARED
- 2: EXCLUSIVE
Accordingly, you will have to set maxLockLevel to 2. Now, there are two pairs of levels
- NO LOCK with EXCLUSIVE
- SHARED with SHARED
This means when the current highest lock level is NO LOCK everything less or equal to EXCLUSIVE is allowed - which means every other lock level. On the other side EXCLUSIVE allows exacly for NO LOCK - which means nothing else. In conclusion, SHARED allows for SHARED or NO LOCK, but not for EXCLUSIVE. To make this very clear have a look at this table, where o means compatible or can coexist and x means incompatible or can not coexist:

NO LOCK SHARED EXCLUSIVE

NO LOCK o o o

SHARED o o x

EXCLUSIVE o x x

General limitations include:
- You are restricted to the scheme described above
- There are no preferences configurable for lock levels. This means whenever more than one party waits for a lock you can not specify which one is to be preferred. Under certain circumstances I might be nice to have the opportunity to give priority to parties either applying for higher or lower lock levels. It might even be desirable not only to give priority to higher or lower locks, but to a special level. For example you do not want to prefer higher lock levels, but exactly lock level 3 which might stand for WRITE access.
- It is not possible to represent hierarchical locks, i.e. locks having descendants that are locked whenever the lock itself is locked. Consequently, there also is no notion of an intention lock.
- You can not specify a timeframe for the validity of a lock. This means an owner of a thread can never lose a lock except when actively releasing it. This is bad when an owner either forgets to release a lock or is not able to do so due to error states or abnormal termination.
@version $Revision: 1.2 $

        // no need to implement suspend and resume here as tlocks will not be used with external transactions 
        if (locks.get() == null) return;


        Xid txId = (Xid) activeTransactionBranch.get();
        for (Iterator it = ((HashSet)locks.get()).iterator(); it.hasNext();) {
            GenericLock lock = (GenericLock) it.next();
            lock.release(txId);
            getLogger().log(
                "Release lock: " + txId + " released " + lock.getResourceId().toString(),
                LOG_CHANNEL,
                Logger.DEBUG);
        }
    }

View Full Code Here

    public void exclusiveTransientLock(String uri)
      throws ServiceAccessException {
    Xid txId = (Xid) activeTransactionBranch.get();
    if (txId != null) {
      try {
        GenericLock lock = (GenericLock) lockManager
            .atomicGetOrCreateLock(uri);
        if (lock.getLockLevel(txId) != 1) {
          Object owner = lock.getOwner();
          getLogger()
              .log(
                  "Try lock: "
                      + txId
                      + " tries "
                      + uri
                      + (owner != null ? " ---> "
                          + owner.toString()
                          + " has it" : ""),
                  LOG_CHANNEL, Logger.DEBUG);
          if (!lock.acquire(txId, 1, true, true, timeout)) {
            throw new ServiceAccessException(this,
                new ConflictException(uri));
          }
          ((HashSet) locks.get()).add(lock);
          getLogger().log("Has lock: " + txId + " locks " + uri,

View Full Code Here

     * @param setFactory factory for temporary sets
     */
    public PessimisticMapWrapper(Map wrapped, MapFactory mapFactory, SetFactory setFactory, LoggerFacade logger) {
        super(wrapped, mapFactory, setFactory);
        lockManager = new GenericLockManager(WRITE, logger);
        globalLock = new GenericLock(GLOBAL_LOCK_NAME, WRITE, logger);
    }

View Full Code Here

     */
    public void lock(Object ownerId, Object resourceId, int targetLockLevel, int compatibility,
                     boolean preferred, long timeoutMSecs, Object isolationId) throws LockException
    {
        timeoutCheck(ownerId);
        GenericLock lock = atomicGetOrCreateLock(resourceId, isolationId);
        super.doLock(lock, ownerId, resourceId, targetLockLevel, compatibility, preferred, timeoutMSecs);
    }

View Full Code Here

    {
        synchronized(globalLocks)
        {
            if(isolationId != null)
            {
                GenericLock lock = createIsolationLevel(resourceId, isolationId, logger);
                globalLocks.put(resourceId, lock);
                return lock;
            }
            else
            {
                GenericLock lock = new GenericLock(resourceId, maxLockLevel, logger);
                globalLocks.put(resourceId, lock);
                return lock;
            }
        }
    }

View Full Code Here

     */
    public void lock(Object ownerId, Object resourceId, int targetLockLevel, int compatibility,
                     boolean preferred, long timeoutMSecs, Object isolationId) throws LockException
    {
        timeoutCheck(ownerId);
        GenericLock lock = (GenericLock) atomicGetOrCreateLock(resourceId, isolationId);
        super.doLock(lock, ownerId, resourceId, targetLockLevel, compatibility, preferred, timeoutMSecs);
    }

View Full Code Here

    {
        synchronized(globalLocks)
        {
            if(isolationId != null)
            {
                GenericLock lock = createIsolationLevel(resourceId, isolationId, logger);
                globalLocks.put(resourceId, lock);
                return lock;
            }
            else
            {
                GenericLock lock = new GenericLock(resourceId, maxLockLevel, logger);
                globalLocks.put(resourceId, lock);
                return lock;
            }
        }
    }

View Full Code Here

            freeLocks();
        }


        public synchronized void upgradeLockToCommit() throws ResourceManagerException {
            for (Iterator it =  lockManager.getAll(txId).iterator(); it.hasNext();) {
                GenericLock lock = (GenericLock) it.next();
                // only upgrade if we had write access
                if (lock.getLockLevel(txId) == LOCK_EXCLUSIVE) {
                    try {
                        // in case of deadlocks, make failure of non-committing tx more likely
                        if (!lock
                            .acquire(
                                txId,
                                LOCK_COMMIT,
                                true,
                                true,
                                getDefaultTransactionTimeout() * DEFAULT_COMMIT_TIMEOUT_FACTOR)) {
                            throw new ResourceManagerException(
                                "Could not upgrade to commit lock for resource at '"
                                    + lock.getResourceId().toString()
                                    + "'",
                                ERR_NO_LOCK,
                                txId);
                        }
                    } catch (InterruptedException e) {

View Full Code Here

            buf.append(Long.toString(startTime)).append('\n');
            if (debug) {
                buf.append("----- Lock Debug Info -----\n");
                
                for (Iterator it = lockManager.getAll(txId).iterator(); it.hasNext();) {
                    GenericLock lock = (GenericLock) it.next();
                    buf.append(lock.toString()+"\n");
                }
                
            }
            return buf.toString();
        }

View Full Code Here

            freeLocks();
        }


        public synchronized void upgradeLockToCommit() throws ResourceManagerException {
            for (Iterator it =  lockManager.getAll(txId).iterator(); it.hasNext();) {
                GenericLock lock = (GenericLock) it.next();
                // only upgrade if we had write access
                if (lock.getLockLevel(txId) == LOCK_EXCLUSIVE) {
                    try {
                        // in case of deadlocks, make failure of non-committing tx more likely
                        if (!lock
                            .acquire(
                                txId,
                                LOCK_COMMIT,
                                true,
                                true,
                                getDefaultTransactionTimeout() * DEFAULT_COMMIT_TIMEOUT_FACTOR)) {
                            throw new ResourceManagerException(
                                "Could not upgrade to commit lock for resource at '"
                                    + lock.getResourceId().toString()
                                    + "'",
                                ERR_NO_LOCK,
                                txId);
                        }
                    } catch (InterruptedException e) {

View Full Code Here

0 1

TOP

Related Classes of org.apache.commons.transaction.locking.GenericLock

org.apache.commons.transaction.file.FileResourceManager$TransactionContext

org.apache.commons.transaction.memory.PessimisticMapWrapper

org.apache.ojb.broker.locking.CommonsOJBLockManager

org.apache.slide.store.ExtendedStore

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.

	NO LOCK	SHARED	EXCLUSIVE
NO LOCK	o	o	o
SHARED	o	o	x
EXCLUSIVE	o	x	x