Класс 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(). Если требуется, чтобы timed-вариант 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().