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