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