org.quartz.impl.jdbcjobstore
Class SimpleSemaphore

java.lang.Object
  org.quartz.impl.jdbcjobstore.SimpleSemaphore

All Implemented Interfaces:

Semaphore

public class SimpleSemaphore
extends java.lang.Object
implements Semaphore

Internal in-memory lock handler for providing thread/resource locking in order to protect resources from being altered by multiple threads at the same time.

Author:

jhouse

Constructor Summary

SimpleSemaphore()

Method Summary

protected org.slf4j.Logger	getLog()
boolean	isLockOwner(java.sql.Connection conn, java.lang.String lockName) Determine whether the calling thread owns a lock on the identified resource.
boolean	obtainLock(java.sql.Connection conn, java.lang.String lockName) Grants a lock on the identified resource to the calling thread (blocking until it is available).
void	releaseLock(java.sql.Connection conn, java.lang.String lockName) Release the lock on the identified resource if it is held by the calling thread.
boolean	requiresConnection() This Semaphore implementation does not use the database.

Methods inherited from class java.lang.Object

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

Constructor Detail

SimpleSemaphore

public SimpleSemaphore()

Method Detail

getLog

protected org.slf4j.Logger getLog()

obtainLock

public boolean obtainLock(java.sql.Connection conn,
                          java.lang.String lockName)

Grants a lock on the identified resource to the calling thread (blocking until it is available).

Specified by:

obtainLock in interface Semaphore

Parameters:

conn - Database connection used to establish lock. Can be null if Semaphore.requiresConnection() returns false.

Returns:

true if the lock was obtained.

releaseLock

public void releaseLock(java.sql.Connection conn,
                        java.lang.String lockName)

Release the lock on the identified resource if it is held by the calling thread.

Specified by:

releaseLock in interface Semaphore

Parameters:

conn - Database connection used to establish lock. Can be null if Semaphore.requiresConnection() returns false.

isLockOwner

public boolean isLockOwner(java.sql.Connection conn,
                           java.lang.String lockName)

Determine whether the calling thread owns a lock on the identified resource.

Specified by:

isLockOwner in interface Semaphore

Parameters:

conn - Database connection used to establish lock. Can be null if Semaphore.requiresConnection() returns false.

requiresConnection

public boolean requiresConnection()

This Semaphore implementation does not use the database.

Specified by:

requiresConnection in interface Semaphore

See Also:

Semaphore.isLockOwner(Connection, String), Semaphore.obtainLock(Connection, String), Semaphore.releaseLock(Connection, String)