ReentrantReadWriteLock. WriteLock (Платформа Java SE 7)

java.lang. Объект
- java.util.concurrent.locks.ReentrantReadWriteLock.WriteLock

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

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

Включение класса:

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()` Попытки выпустить эту блокировку.

Методы 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 в классе Object
    
    Возвраты:
    строка, идентифицирующая эту блокировку, так же как ее состояние блокировки
  - isHeldByCurrentThread
```
public boolean isHeldByCurrentThread()
```
    Запросы, если эта блокировка записи сохранена текущим потоком. Идентичный в действительности ReentrantReadWriteLock.isWriteLockedByCurrentThread().
    
    Возвраты:
    true если текущий поток содержит эту блокировку и false иначе
    С тех пор:
    
    1.6
  - getHoldCount
```
public int getHoldCount()
```
    Запрашивает число, держится эта блокировка записи текущим потоком. У потока есть держание блокировки для каждого действия блокировки, которое не является соответствующим разблокировать действием. Идентичный в действительности ReentrantReadWriteLock.getWriteHoldCount().
    
    Возвраты:
    число держится эта блокировка текущим потоком, или нуль, если эта блокировка не сохранена текущим потоком
    С тех пор:
    
    1.6

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс ReentrantReadWriteLock. WriteLock

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

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

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

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

ReentrantReadWriteLock. WriteLock

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

блокировка

lockInterruptibly

tryLock

tryLock

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

newCondition

toString

isHeldByCurrentThread

getHoldCount