public static class J2SE14ReadWriteLock.WriteLock extends java.lang.Object implements Lock, java.io.Serializable
J2SE14ReadWriteLock.writeLock()
.Modifier | Constructor and Description |
---|---|
protected |
WriteLock(J2SE14ReadWriteLock lock)
Constructor for use by subclasses
|
Modifier and Type | Method and Description |
---|---|
int |
getHoldCount()
Queries the number of holds on this write lock by the current
thread.
|
boolean |
isHeldByCurrentThread()
Queries if this write lock is held by the current thread.
|
void |
lock()
Acquires the write lock.
|
void |
lockInterruptibly()
Acquires the write lock unless the current thread is
interrupted.
|
java.lang.String |
toString()
Returns a string identifying this lock, as well as its lock
state.
|
boolean |
tryLock()
Acquires the write lock only if it is not held by another thread
at the time of invocation.
|
void |
unlock()
Attempts to release this lock.
|
protected WriteLock(J2SE14ReadWriteLock lock)
lock
- the outer lock objectjava.lang.NullPointerException
- if the lock is nullpublic void lock()
Acquires the write lock if neither the read nor write lock are held by another thread and returns immediately, setting the write lock hold count to one.
If the current thread already holds the write lock then the hold count is incremented by one and the method returns immediately.
If the lock is held by another thread then the current thread becomes disabled for thread scheduling purposes and lies dormant until the write lock has been acquired, at which time the write lock hold count is set to one.
public void lockInterruptibly() throws java.lang.InterruptedException
Acquires the write lock if neither the read nor write lock are held by another thread and returns immediately, setting the write lock hold count to one.
If the current thread already holds this lock then the hold count is incremented by one and the method returns immediately.
If the lock is held by another thread then the current thread becomes disabled for thread scheduling purposes and lies dormant until one of two things happens:
If the write lock is acquired by the current thread then the lock hold count is set to one.
If the current thread:
InterruptedException
is thrown and the current
thread's interrupted status is cleared.
In this implementation, as this method is an explicit interruption point, preference is given to responding to the interrupt over normal or reentrant acquisition of the lock.
java.lang.InterruptedException
- if the current thread is interruptedpublic boolean tryLock()
Acquires the write lock if neither the read nor write lock
are held by another thread
and returns immediately with the value true
,
setting the write lock hold count to one. Even when this lock has
been set to use a fair ordering policy, a call to
tryLock()
will immediately acquire the
lock if it is available, whether or not other threads are
currently waiting for the write lock. This "barging"
behavior can be useful in certain circumstances, even
though it breaks fairness.
If the current thread already holds this lock then the
hold count is incremented by one and the method returns
true
.
If the lock is held by another thread then this method
will return immediately with the value false
.
public void unlock()
If the current thread is the holder of this lock then
the hold count is decremented. If the hold count is now
zero then the lock is released. If the current thread is
not the holder of this lock then IllegalMonitorStateException
is thrown.
public java.lang.String toString()
"Unlocked"
or the String "Locked by"
followed by the name of the owning thread.toString
in class java.lang.Object
public boolean isHeldByCurrentThread()
java.util.concurrent.locks.ReentrantReadWriteLock#isWriteLockedByCurrentThread
.true
if the current thread holds this lock and
false
otherwisepublic int getHoldCount()
ReentrantReadWriteLock#getWriteHoldCount
.Glazed Lists, Copyright © 2003 publicobject.com, O'Dell Engineering.
Documentation build by buildd at 2016-05-16 17:00