Класс 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 =" и количество удерживаемых блокировок чтения.