Класс ReentrantReadWriteLock.WriteLock

protected WriteLock(ReentrantReadWriteLock lock)

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

public void lock()

Захватывает блокировку записи.

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

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

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

public void lockInterruptibly() throws InterruptedException

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

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

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

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

• Текущий поток захватывает блокировку записи; или
• Другой поток прерывает текущий поток.

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

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

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

выбрасывается InterruptedException, а флаг прерывания текущего потока сбрасывается.

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

public boolean tryLock()

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

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

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

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

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

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

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

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

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

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

• Текущий поток захватывает блокировку записи; или
• Другой поток прерывает текущий поток; или
• Истекает заданное время ожидания

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

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

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

выбрасывается InterruptedException, а флаг прерывания текущего потока сбрасывается.

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

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

public void unlock()

Предпринимает попытку освободить эту блокировку.

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

public Condition newCondition()

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

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

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

public String toString()

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

public boolean isHeldByCurrentThread()

Проверяет, удерживается ли эта блокировка записи текущим потоком. По своему действию идентичен методу ReentrantReadWriteLock.isWriteLockedByCurrentThread().

public int getHoldCount()

Определяет количество захватов этой блокировки записи текущим потоком. Поток удерживает блокировку для каждого действия захвата, которому не соответствует действие освобождения. По своему действию идентичен методу ReentrantReadWriteLock.getWriteHoldCount().