compact1, compact2, compact3

java.util.concurrent.locks

Класс ReentrantReadWriteLock. WriteLock

java.lang. Объект

java.util.concurrent.locks.ReentrantReadWriteLock.WriteLock

Все Реализованные Интерфейсы:

Сериализуемый, Блокировка

Включение class:

ReentrantReadWriteLock

public static class ReentrantReadWriteLock.WriteLock
extends Object
implements Lock, Serializable

Блокировка возвратилась методом ReentrantReadWriteLock.writeLock().

См. Также:

Сериализированная Форма

Сводка конструктора

Конструкторы

Модификатор	Конструктор и Описание
protected	ReentrantReadWriteLock.WriteLock(ReentrantReadWriteLock lock) Конструктор для использования подклассами

Сводка метода

Модификатор и Тип	Метод и Описание
int	getHoldCount() Запрашивает число, держится эта блокировка записи текущим потоком.
boolean	isHeldByCurrentThread() Запросы, если эта блокировка записи сохранена текущим потоком.
void	lock() Получает блокировку записи.
void	lockInterruptibly() Получает блокировку записи, если текущий поток не прерывается.
Условие	newCondition() Возвраты a Condition экземпляр для использования с этим Lock экземпляр.
Строка	toString() Возвращает строку, идентифицирующую эту блокировку, так же как ее состояние блокировки.
boolean	tryLock() Получает блокировку записи, только если она не сохранена другим потоком во время вызова.
boolean	tryLock(long timeout, TimeUnit unit) Получает блокировку записи, если она не сохранена другим потоком в пределах данного времени ожидания, и текущий поток не был прерван.
void	unlock() Попытки выпустить эту блокировку.

Методы, наследованные от class java.lang. Объект

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

Деталь конструктора

ReentrantReadWriteLock. WriteLock

protected ReentrantReadWriteLock.WriteLock(ReentrantReadWriteLock lock)

Конструктор для использования подклассами

Параметры:

lock - внешний объект блокировки

Броски:

NullPointerException - если блокировка является нулем

Деталь метода

блокировка

public void lock()

Получает блокировку записи.

Получает блокировку записи, если ни чтение, ни блокировка записи не сохранены другим потоком, и сразу возвращается, устанавливая блокировку записи содержит количество одному.

Если текущий поток уже содержит блокировку записи тогда, количество хранения постепенно увеличивается одним, и метод сразу возвращается.

Если блокировка сохранена другим потоком тогда, текущий поток становится отключенным в целях планирования потоков и бездействует, пока блокировка записи не была получена, в котором времени блокировка записи содержат количество, устанавливается в одного.

Определенный:

lock в интерфейсе Lock

lockInterruptibly

public void lockInterruptibly()
                       throws InterruptedException

Получает блокировку записи, если текущий поток не прерывается.

Получает блокировку записи, если ни чтение, ни блокировка записи не сохранены другим потоком, и сразу возвращается, устанавливая блокировку записи содержит количество одному.

Если текущий поток уже содержит эту блокировку тогда, количество хранения постепенно увеличивается одним, и метод сразу возвращается.

Если блокировка сохранена другим потоком тогда, текущий поток становится отключенным в целях планирования потоков и бездействует, пока одна из двух вещей не происходит:

• Блокировка записи получается текущим потоком; или
• Некоторый другой поток прерывает текущий поток.

Если блокировка записи получается текущим потоком тогда, блокировка содержит количество, устанавливается в одного.

Если текущий поток:

• установили его прерванное состояние на записи в этот метод; или
• прерывается, получая блокировку записи,

тогда InterruptedException бросается и прерванное состояние текущего потока очищается.

В этой реализации, поскольку этот метод является явной точкой прерывания, предпочтение дается отвечанию на прерывание по нормальному или повторно используемому сбору блокировки.

Определенный:

lockInterruptibly в интерфейсе Lock

Броски:

InterruptedException - если текущий поток прерывается

tryLock

public boolean tryLock()

Получает блокировку записи, только если она не сохранена другим потоком во время вызова.

Получает блокировку записи, если ни чтение, ни блокировка записи не сохранены другим потоком, и сразу возвращается со значением true, установка блокировки записи содержит количество одному. Даже когда эта блокировка была установлена использовать справедливую политику упорядочивания, звонок tryLock() сразу получит блокировку, если это будет доступно, ожидают ли другие потоки в настоящий момент блокировки записи. Это поведение "неуклюжей походки" может быть полезным при определенных обстоятельствах, даже при том, что оно повреждает справедливость. Если Вы хотите соблюдать установку справедливости для этой блокировки, то используйте tryLock(0, TimeUnit.SECONDS) который почти эквивалентен (это также обнаруживает прерывание).

Если текущий поток уже содержит эту блокировку тогда, количество хранения постепенно увеличивается одним и возвратами метода true.

Если блокировка будет сохранена другим потоком тогда, то этот метод сразу возвратится со значением false.

Определенный:

tryLock в интерфейсе Lock

Возвраты:

true если блокировка была свободна и была получена текущим потоком, или блокировка записи была уже сохранена текущим потоком; и false иначе.

tryLock

public boolean tryLock(long timeout,
                       TimeUnit unit)
                throws InterruptedException

Получает блокировку записи, если она не сохранена другим потоком в пределах данного времени ожидания, и текущий поток не был прерван.

Получает блокировку записи, если ни чтение, ни блокировка записи не сохранены другим потоком, и сразу возвращается со значением true, установка блокировки записи содержит количество одному. Если эта блокировка была установлена использовать справедливую политику упорядочивания тогда, доступная блокировка не будет получена, если какие-либо другие потоки будут ожидать блокировки записи. Это в отличие от tryLock() метод. Если Вы хотите синхронизированное tryLock это действительно разрешает неуклюже передвигаться на справедливой блокировке, тогда комбинируют синхронизированные и несинхронизированные формы вместе:

 
 if (lock.tryLock() ||
     lock.tryLock(timeout, unit)) {
   ...
 }

Если текущий поток уже содержит эту блокировку тогда, количество хранения постепенно увеличивается одним и возвратами метода true.

Если блокировка сохранена другим потоком тогда, текущий поток становится отключенным в целях планирования потоков и бездействует, пока одна из трех вещей не происходит:

• Блокировка записи получается текущим потоком; или
• Некоторый другой поток прерывает текущий поток; или
• Указанное время ожидания протекает

Если блокировка записи получается тогда значение true возвращается и блокировка записи содержат количество, устанавливается в одного.

Если текущий поток:

• установили его прерванное состояние на записи в этот метод; или
• прерывается, получая блокировку записи,

тогда InterruptedException бросается и прерванное состояние текущего потока очищается.

Если указанное время ожидания протекает тогда значение false возвращается. Если время будет меньше чем или равно нулю, то метод не будет ожидать вообще.

В этой реализации, поскольку этот метод является явной точкой прерывания, предпочтение дается отвечанию на прерывание по нормальному или повторно используемому сбору блокировки, и по созданию отчетов о протекании времени ожидания.

Определенный:

tryLock в интерфейсе Lock

Параметры:

timeout - время, чтобы ожидать блокировки записи

unit - единица измерения времени параметра тайм-аута

Возвраты:

true если блокировка была свободна и была получена текущим потоком, или блокировка записи была уже сохранена текущим потоком; и false если время ожидания, законченное перед блокировкой, могло бы быть получено.

Броски:

InterruptedException - если текущий поток прерывается

NullPointerException - если единица измерения времени является нулем

разблокировать

public void unlock()

Попытки выпустить эту блокировку.

Если текущий поток является держателем этой блокировки тогда, количество хранения постепенно уменьшается. Если количество хранения является теперь нулем тогда, блокировка выпускается. Если текущий поток не является держателем этой блокировки тогда IllegalMonitorStateException бросается.

Определенный:

unlock в интерфейсе Lock

Броски:

IllegalMonitorStateException - если текущий поток не содержит эту блокировку.

newCondition

public Condition newCondition()

Возвраты a Condition экземпляр для использования с этим Lock экземпляр.

Возвращенный Condition экземпляр поддерживает те же самые использования также, как и Object методы монитора (wait, notify, и notifyAll) когда использующийся со встроенной блокировкой монитора.

• Если эта блокировка записи не сохранена когда никто Condition метод вызывают тогда IllegalMonitorStateException бросается. (Читайте, блокировки сохранены независимо от блокировок записи, так не проверяются или влияются. Однако это - по существу всегда ошибка вызвать метод ожидания условия, когда текущий поток также получил блокировки чтения, так как другие потоки, которые могли разблокировать это, не будут в состоянии получить блокировку записи.)
• Когда методы ожидания условия вызывают, блокировка записи выпускается и, прежде, чем они возвратятся, блокировка записи повторно получается, и блокировка содержат количество, восстановленное тому, чем это было, когда метод вызвали.
• Если поток будет прерван, ожидая тогда, то ожидание завершится, InterruptedException будет брошен, и прерванное состояние потока будет очищено.
• Потоки ожидания сообщаются в порядке FIFO.
• Упорядочивание пересбора блокировки для потоков, возвращающихся из методов ожидания, является тем же самым что касается потоков, первоначально получающих блокировку, которая находится в случае значения по умолчанию, не определенном, но для справедливых блокировок одобряет те потоки, которые ожидали самое длинное.

Определенный:

newCondition в интерфейсе Lock

Возвраты:

объект Условия

toString

public String toString()

Возвращает строку, идентифицирующую эту блокировку, так же как ее состояние блокировки. Состояние, в скобках включает любого Строка "Unlocked" или Строка "Locked by" сопровождаемый именем потока обладания.

Переопределения:

toString в class Object

Возвраты:

строка, идентифицирующая эту блокировку, так же как ее состояние блокировки

isHeldByCurrentThread

public boolean isHeldByCurrentThread()

Запросы, если эта блокировка записи сохранена текущим потоком. Идентичный в действительности ReentrantReadWriteLock.isWriteLockedByCurrentThread().

Возвраты:

true если текущий поток содержит эту блокировку и false иначе

С тех пор:

1.6

getHoldCount

public int getHoldCount()

Запрашивает число, держится эта блокировка записи текущим потоком. У потока есть держание блокировки для каждого действия блокировки, которое не является соответствующим разблокировать действием. Идентичный в действительности ReentrantReadWriteLock.getWriteHoldCount().

Возвраты:

число держится эта блокировка текущим потоком, или нуль, если эта блокировка не сохранена текущим потоком

С тех пор:

1.6