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