Package org.jboss.threads

Class SpinLock

java.lang.Object

org.jboss.threads.SpinLock

All Implemented Interfaces:

Lock, ExtendedLock

public class SpinLock
extends Object
implements ExtendedLock

A spin lock. Such locks are designed to only be held for a very short time - for example, long enough to compare and swap two fields.

Spin locks do not support conditions, and they do not support timed waiting. Normally only the uninterruptible lock, tryLock, and unlock methods should be used to control the lock.

Constructor Summary

Constructors

Constructor	Description
SpinLock()	Construct a new instance.

Method Summary

Modifier and Type	Method	Description
boolean	isFair()	Determine if this lock is fair.
boolean	isHeldByCurrentThread()	Determine if this spin lock is held by the calling thread.
boolean	isLocked()	Determine if this spin lock is held.
void	lock()	Acquire the lock by spinning until it is held.
void	lockInterruptibly()
Condition	newCondition()
boolean	tryLock()
boolean	tryLock(long time, TimeUnit unit)
void	unlock()

Methods inherited from class java.lang.Object

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

Constructor Detail

SpinLock

public SpinLock()

Construct a new instance.

Method Detail

isLocked

public boolean isLocked()

Determine if this spin lock is held. Useful for assertions.

Specified by:

isLocked in interface ExtendedLock

Returns:

true if the lock is held by any thread, false otherwise

isHeldByCurrentThread

public boolean isHeldByCurrentThread()

Determine if this spin lock is held by the calling thread. Useful for assertions.

Specified by:

isHeldByCurrentThread in interface ExtendedLock

Returns:

true if the lock is held by the calling thread, false otherwise

isFair

public boolean isFair()

Determine if this lock is fair.

Specified by:

isFair in interface ExtendedLock

Returns:

true; the lock is fair

lock

public void lock()

Acquire the lock by spinning until it is held.

Specified by:

lock in interface Lock

lockInterruptibly

public void lockInterruptibly()
                       throws InterruptedException

Specified by:

lockInterruptibly in interface Lock

Throws:

InterruptedException

tryLock

public boolean tryLock()

Specified by:

tryLock in interface Lock

tryLock

public boolean tryLock(long time,
                       TimeUnit unit)

Specified by:

tryLock in interface Lock

unlock

public void unlock()

Specified by:

unlock in interface Lock

newCondition

public Condition newCondition()

Specified by:

newCondition in interface Lock