Класс 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()

public boolean isHeldByCurrentThread()

public int getHoldCount()