Класс ReentrantReadWriteLock.ReadLock

protected ReadLock(ReentrantReadWriteLock lock)

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

public void lock()

Приобретает чтение блокировки.

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

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

public void lockInterruptibly() throws InterruptedException

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

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

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

• Блокировка чтения приобретена текущей нитью; или
• Другая нить прерывает текущую нить.

Если текущая нить:

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

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

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

public boolean tryLock()

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

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

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

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

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

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

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

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

• Блокировка чтения приобретена текущей нитью; или
• Другая нить прерывает текущую нить; или
• Заданное время ожидания истекло.

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

Если текущая нить:

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

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

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

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

public void unlock()

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

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

public Condition newCondition()

Выбрасывает UnsupportedOperationException, потому что ReadLocks не поддерживают условия.

public String toString()

Возвращает строку, идентифицирующую эту блокировку, а также её состояние блокировки. Состояние, в скобках, включает строку "Read locks =", за которой следует количество удерживаемых блокировок чтения.