java.util.concurrent.locks

Класс ReentrantReadWriteLock. ReadLock

java.lang. Объект

java.util.concurrent.locks.ReentrantReadWriteLock.ReadLock

Все Реализованные Интерфейсы:

Сериализуемый, Блокировка

Включение класса:

ReentrantReadWriteLock

public static class ReentrantReadWriteLock.ReadLock
extends Object
implements Lock, Serializable

Блокировка возвратилась методом ReentrantReadWriteLock.readLock().

См. Также:

Сериализированная Форма

Сводка конструктора

Конструкторы

Модификатор	Конструктор и Описание
protected	ReentrantReadWriteLock.ReadLock(ReentrantReadWriteLock lock) Конструктор для использования подклассами

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
void	lock() Получает блокировку чтения.
void	lockInterruptibly() Получает блокировку чтения, если текущий поток не прерывается.
Условие	newCondition() Броски UnsupportedOperationException потому что ReadLocks не поддерживайте условия.
Строка	toString() Возвращает строку, идентифицирующую эту блокировку, так же как ее состояние блокировки.
boolean	tryLock() Получает блокировку чтения, только если блокировка записи не сохранена другим потоком во время вызова.
boolean	tryLock(long timeout, TimeUnit unit) Получает блокировку чтения, если блокировка записи не сохранена другим потоком в пределах данного времени ожидания, и текущий поток не был прерван.
void	unlock() Попытки выпустить эту блокировку.

Методы java.lang унаследованный от класса. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Деталь конструктора

ReentrantReadWriteLock. ReadLock

protected ReentrantReadWriteLock.ReadLock(ReentrantReadWriteLock lock)

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

Параметры:

lock - внешний объект блокировки

Броски:

NullPointerException - если блокировка является нулем

Деталь метода

блокировка

public void lock()

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

Получает блокировку чтения, если блокировка записи не сохранена другим потоком и возвратами сразу.

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

Определенный:

lock в интерфейсе Lock

lockInterruptibly

public void lockInterruptibly()
                       throws InterruptedException

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

Получает блокировку чтения, если блокировка записи не сохранена другим потоком и возвратами сразу.

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

• Блокировка чтения получается текущим потоком; или
• Некоторый другой поток прерывает текущий поток.

Если текущий поток:

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

тогда InterruptedException бросается и прерванное состояние текущего потока очищается.

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

Определенный:

lockInterruptibly в интерфейсе Lock

Броски:

InterruptedException - если текущий поток прерывается

tryLock

public boolean tryLock()

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

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

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

Определенный:

tryLock в интерфейсе Lock

Возвраты:

true если блокировка чтения была получена

tryLock

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

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

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

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

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

• Блокировка чтения получается текущим потоком; или
• Некоторый другой поток прерывает текущий поток; или
• Указанное время ожидания протекает.

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

Если текущий поток:

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

тогда InterruptedException бросается и прерванное состояние текущего потока очищается.

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

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

Определенный:

tryLock в интерфейсе Lock

Параметры:

timeout - время, чтобы ожидать блокировки чтения

unit - единица измерения времени параметра тайм-аута

Возвраты:

true если блокировка чтения была получена

Броски:

InterruptedException - если текущий поток прерывается

NullPointerException - если единица измерения времени является нулем

разблокировать

public void unlock()

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

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

Определенный:

unlock в интерфейсе Lock

newCondition

public Condition newCondition()

Броски UnsupportedOperationException потому что ReadLocks не поддерживайте условия.

Определенный:

newCondition в интерфейсе Lock

Возвраты:

Новое Condition экземпляр для этого Lock экземпляр

Броски:

UnsupportedOperationException - всегда

toString

public String toString()

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

Переопределения:

toString в классе Object

Возвраты:

строка, идентифицирующая эту блокировку, так же как ее состояние блокировки