ReentrantReadWriteLock (Платформа Java SE 8 b92)

java.lang. Объект
- java.util.concurrent.locks.ReentrantReadWriteLock

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

Сериализуемый, ReadWriteLock
```
public class ReentrantReadWriteLock
extends Object
implements ReadWriteLock, Serializable
```
Реализация ReadWriteLock поддержка подобной семантики к ReentrantLock.
У этого class есть следующие свойства:
- Порядок сбора
  Этот class не налагает привилегированное упорядочивание читателя или писателя для доступа блокировки. Однако, это действительно поддерживает дополнительную политику справедливости.
  
  Несправедливый режим (значение по умолчанию)
  Когда создано как неярмарка (значение по умолчанию), порядок записи в чтение и блокировку записи является неуказанным согласно ограничениям повторной входимости. Несправедливая блокировка, с которой непрерывно спорят, может неопределенно отложить один или более потоков читателя или писателя, но будет обычно иметь более высокую пропускную способность чем справедливая блокировка.
  
  Справедливый режим
  Когда создано как ярмарка, потоки борются за запись, используя приблизительно политика порядка прибытия. Когда в настоящий момент сохраненная блокировка будет выпущена, или дольше всего ожидающий единственный поток писателя будет присвоен блокировка записи, или если будет группа потоков читателя, ожидающих дольше чем все потоки писателя ожидания, то та группа будет присвоена блокировка чтения.
  Поток, который пытается получить справедливую блокировку чтения (неповторно используемо), блокирует, если или блокировка записи будет сохранена, или есть поток писателя ожидания. Поток не будет получать блокировку чтения до окончания самого старого, в настоящий момент поток писателя ожидания получил и выпустил блокировку записи. Конечно, если писатель ожидания откажется от ожидать, оставляя один или более потоков читателя как самые длинные официанты в очереди со свободной блокировкой записи, то те читатели будут присвоены блокировка чтения.
  Поток, который пытается получить справедливую блокировку записи (неповторно используемо), блокирует, если оба, которых блокировка чтения и пишет блокировке, не будут свободны (который подразумевает, что нет никаких потоков ожидания). (Отметьте что неблокирование ReentrantReadWriteLock.ReadLock.tryLock() и ReentrantReadWriteLock.WriteLock.tryLock() методы не соблюдают эту справедливую установку и сразу получат блокировку, если это возможно, независимо от потоков ожидания.)
- Повторная входимость
  Эта блокировка позволяет и читателям и писателям повторно получать чтение, или запись привязывает стиль a ReentrantLock. Неповторно используемым читателям не разрешают, пока все блокировки записи, сохраненные потоком записи, не были выпущены.
  Дополнительно, писатель может получить блокировку чтения, но не наоборот. Среди других приложений повторная входимость может быть полезной, когда блокировки записи сохранены во время вызовов или обратных вызовов к методам, которые выполняют чтения под блокировками чтения. Если читатель попытается получить блокировку записи, то она никогда не будет успешно выполняться.
- Понижение блокировки
  Повторная входимость также позволяет понижать от блокировки записи до блокировки чтения, получая блокировку записи, тогда блокировка чтения и затем выпуская блокировку записи. Однако, обновление от блокировки чтения до блокировки записи не возможно.
- Прерывание сбора блокировки
  Блокировка чтения и запись блокируют оба прерывания поддержки во время сбора блокировки.
- Condition поддержка
  Блокировка записи обеспечивает a Condition реализация, которая ведет себя таким же образом, относительно блокировки записи, как Condition реализация, обеспеченная ReentrantLock.newCondition() делает для ReentrantLock. Это Condition может, конечно, только использоваться с блокировкой записи.
  Блокировка чтения не поддерживает a Condition и readLock().newCondition() броски UnsupportedOperationException.
- Инструментарий
  Этот class поддерживает методы, чтобы определить, сохранены ли блокировки или спорили. Эти методы разрабатываются для состояния системы контроля, не для управления синхронизацией.
Сериализация этого class ведет себя таким же образом как встроенные блокировки: десериализованная блокировка находится в разблокированном состоянии, независимо от его состояния когда сериализировано.
Демонстрационные использования. Вот эскиз кода, показывающий, как выполнить блокировку, понижая после обновления кэша (обработка исключений особенно хитра, обрабатывая многократные блокировки невложенным способом):
```
 
 class CachedData {
   Object data;
   volatile boolean cacheValid;
   final ReentrantReadWriteLock rwl = new ReentrantReadWriteLock();

   void processCachedData() {
     rwl.readLock().lock();
     if (!cacheValid) {
       // Must release read lock before acquiring write lock
       rwl.readLock().unlock();
       rwl.writeLock().lock();
       try {
         // Recheck state because another thread might have
         // acquired write lock and changed state before we did.
         if (!cacheValid) {
           data = ...
           cacheValid = true;
         }
         // Downgrade by acquiring read lock before releasing write lock
         rwl.readLock().lock();
       } finally {
         rwl.writeLock().unlock(); // Unlock write, still hold read
       }
     }

     try {
       use(data);
     } finally {
       rwl.readLock().unlock();
     }
   }
 }
```
ReentrantReadWriteLocks может использоваться, чтобы улучшить параллелизм в некотором использовании некоторых видов Наборов. Это обычно стоит только, когда наборы, как ожидают, будут большими, получаются доступ большим количеством потоков читателя чем потоки писателя, и влекут за собой операции с издержками, которые перевешивают издержки синхронизации. Например, вот class, используя TreeMap, который, как ожидают, будет крупным и одновременно полученным доступ.
```
 
 class RWDictionary {
   private final Map<String, Data> m = new TreeMap<String, Data>();
   private final ReentrantReadWriteLock rwl = new ReentrantReadWriteLock();
   private final Lock r = rwl.readLock();
   private final Lock w = rwl.writeLock();

   public Data get(String key) {
     r.lock();
     try { return m.get(key); }
     finally { r.unlock(); }
   }
   public String[] allKeys() {
     r.lock();
     try { return m.keySet().toArray(); }
     finally { r.unlock(); }
   }
   public Data put(String key, Data value) {
     w.lock();
     try { return m.put(key, value); }
     finally { w.unlock(); }
   }
   public void clear() {
     w.lock();
     try { m.clear(); }
     finally { w.unlock(); }
   }
 }
```
Примечания реализации

Эта блокировка поддерживает максимум 65535 рекурсивных блокировок записи и 65535 блокировок чтения. Попытки превысить эти пределы приводят к Error броски от блокировки методов.
С тех пор:

1.5

См. Также:

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

Вложенная Сводка Класса

Вложенные Классы
Модификатор и Тип	Класс и Описание
`static class`	`ReentrantReadWriteLock. ReadLock` Блокировка возвратилась методом `readLock()`.
`static class`	`ReentrantReadWriteLock. WriteLock` Блокировка возвратилась методом `writeLock()`.

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

Конструкторы
Конструктор и Описание
`ReentrantReadWriteLock()` Создает новое `ReentrantReadWriteLock` со значением по умолчанию (несправедливое) упорядочивание свойств.
`ReentrantReadWriteLock(boolean fair)` Создает новое `ReentrantReadWriteLock` с данной политикой справедливости.

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

Все Методы Методы экземпляра Конкретные Методы
Модификатор и Тип	Метод и Описание
`protected Thread`	`getOwner()` Возвращает поток, которому в настоящий момент принадлежит блокировка записи, или `null` если не принадлежавший.
`protected Collection<Thread>`	`getQueuedReaderThreads()` Возвращает набор, содержащий потоки, которые могут ожидать, чтобы получить блокировку чтения.
`protected Collection<Thread>`	`getQueuedThreads()` Возвращает набор, содержащий потоки, которые могут ожидать, чтобы получить или чтение или блокировку записи.
`protected Collection<Thread>`	`getQueuedWriterThreads()` Возвращает набор, содержащий потоки, которые могут ожидать, чтобы получить блокировку записи.
`int`	`getQueueLength()` Возвращает оценку числа потоков, ожидающих, чтобы получить или чтение или блокировку записи.
`int`	`getReadHoldCount()` Запросы число повторно используемого чтения держатся эта блокировка текущим потоком.
`int`	`getReadLockCount()` Запрашивает число блокировок чтения, сохраненных для этой блокировки.
`protected Collection<Thread>`	`getWaitingThreads(Condition condition)` Возвращает набор, содержащий те потоки, которые могут ожидать на данном условии, связанном с блокировкой записи.
`int`	`getWaitQueueLength(Condition condition)` Возвращает оценку числа потоков, ожидающих на данном условии, связанном с блокировкой записи.
`int`	`getWriteHoldCount()` Запросы число повторно используемой записи держатся эта блокировка текущим потоком.
`boolean`	`hasQueuedThread(Thread thread)` Запросы, ожидает ли данный поток, чтобы получить или чтение или блокировку записи.
`boolean`	`hasQueuedThreads()` Запросы, ожидают ли какие-либо потоки, чтобы получить блокировка записи или чтение.
`boolean`	`hasWaiters(Condition condition)` Запросы, ожидают ли какие-либо потоки на данном условии, связанном с блокировкой записи.
`boolean`	`isFair()` Возвраты `true` если у этой блокировки есть истина набора справедливости.
`boolean`	`isWriteLocked()` Запросы, если блокировка записи сохранена каким-либо потоком.
`boolean`	`isWriteLockedByCurrentThread()` Запросы, если блокировка записи сохранена текущим потоком.
`ReentrantReadWriteLock. ReadLock`	`readLock()` Возвращает блокировку, используемую для того, чтобы читать.
`Строка`	`toString()` Возвращает строку, идентифицирующую эту блокировку, так же как ее состояние блокировки.
`ReentrantReadWriteLock. WriteLock`	`writeLock()` Возвращает блокировку, используемую для того, чтобы записать.

Методы, наследованные от class java.lang. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Деталь конструктора
  - ReentrantReadWriteLock
```
public ReentrantReadWriteLock()
```
    Создает новое ReentrantReadWriteLock со значением по умолчанию (несправедливое) упорядочивание свойств.
  - ReentrantReadWriteLock
```
public ReentrantReadWriteLock(boolean fair)
```
    Создает новое ReentrantReadWriteLock с данной политикой справедливости.
    
    Параметры:
    
    fair - true если эта блокировка должна использовать справедливую политику упорядочивания
- Деталь метода
  - writeLock
```
public ReentrantReadWriteLock.WriteLock writeLock()
```
    Описание скопировало с интерфейса: ReadWriteLock
    
    Возвращает блокировку, используемую для того, чтобы записать.
    
    Определенный:
    
    writeLock в интерфейсе ReadWriteLock
    
    Возвраты:
    
    блокировка используется для того, чтобы записать.
  - readLock
```
public ReentrantReadWriteLock.ReadLock readLock()
```
    Описание скопировало с интерфейса: ReadWriteLock
    
    Возвращает блокировку, используемую для того, чтобы читать.
    
    Определенный:
    
    readLock в интерфейсе ReadWriteLock
    
    Возвраты:
    
    блокировка используется для того, чтобы читать.
  - isFair
```
public final boolean isFair()
```
    Возвраты true если у этой блокировки есть истина набора справедливости.
    
    Возвраты:
    
    true если у этой блокировки есть истина набора справедливости
  - getOwner
```
protected Thread getOwner()
```
    Возвращает поток, которому в настоящий момент принадлежит блокировка записи, или null если не принадлежавший. Когда этот метод вызывает поток, который не является владельцем, возвращаемое значение отражает приближение максимальных усилий текущего состояния блокировки. Например, владелец может быть на мгновение null даже если есть потоки, пытающиеся получать блокировку, но еще не сделали так. Этот метод разрабатывается, чтобы облегчить конструкцию подклассов, которые предоставляют более обширные контрольные услуги блокировки.
    
    Возвраты:
    
    владелец, или null если не принадлежавший
  - getReadLockCount
```
public int getReadLockCount()
```
    Запрашивает число блокировок чтения, сохраненных для этой блокировки. Этот метод разрабатывается для использования в состоянии системы контроля, не для управления синхронизацией.
    
    Возвраты:
    
    число блокировок чтения сохранено.
  - isWriteLocked
```
public boolean isWriteLocked()
```
    Запросы, если блокировка записи сохранена каким-либо потоком. Этот метод разрабатывается для использования в состоянии системы контроля, не для управления синхронизацией.
    
    Возвраты:
    
    true если какой-либо поток содержит блокировку записи и false иначе
  - isWriteLockedByCurrentThread
```
public boolean isWriteLockedByCurrentThread()
```
    Запросы, если блокировка записи сохранена текущим потоком.
    
    Возвраты:
    
    true если текущий поток содержит блокировку записи и false иначе
  - getWriteHoldCount
```
public int getWriteHoldCount()
```
    Запросы число повторно используемой записи держатся эта блокировка текущим потоком. У потока писателя есть держание блокировки для каждого действия блокировки, которое не является соответствующим разблокировать действием.
    
    Возвраты:
    
    число держится блокировка записи текущим потоком, или нуль, если блокировка записи не сохранена текущим потоком
  - getReadHoldCount
```
public int getReadHoldCount()
```
    Запросы число повторно используемого чтения держатся эта блокировка текущим потоком. У потока читателя есть держание блокировки для каждого действия блокировки, которое не является соответствующим разблокировать действием.
    
    Возвраты:
    
    число держится блокировка чтения текущим потоком, или нуль, если блокировка чтения не сохранена текущим потоком
    
    С тех пор:
    
    1.6
  - getQueuedWriterThreads
```
protected Collection<Thread> getQueuedWriterThreads()
```
    Возвращает набор, содержащий потоки, которые могут ожидать, чтобы получить блокировку записи. Поскольку фактический набор потоков может измениться динамически, создавая этот результат, возвращенный набор является только оценкой максимальных усилий. Элементы возвращенного набора без определенного порядка. Этот метод разрабатывается, чтобы облегчить конструкцию подклассов, которые предоставляют более обширные контрольные услуги блокировки.
    
    Возвраты:
    
    набор потоков
  - getQueuedReaderThreads
```
protected Collection<Thread> getQueuedReaderThreads()
```
    Возвращает набор, содержащий потоки, которые могут ожидать, чтобы получить блокировку чтения. Поскольку фактический набор потоков может измениться динамически, создавая этот результат, возвращенный набор является только оценкой максимальных усилий. Элементы возвращенного набора без определенного порядка. Этот метод разрабатывается, чтобы облегчить конструкцию подклассов, которые предоставляют более обширные контрольные услуги блокировки.
    
    Возвраты:
    
    набор потоков
  - hasQueuedThreads
```
public final boolean hasQueuedThreads()
```
    Запросы, ожидают ли какие-либо потоки, чтобы получить блокировка записи или чтение. Отметьте это, потому что отмены могут произойти в любое время, a true возврат не гарантирует, что любой другой поток будет когда-либо получать блокировку. Этот метод разрабатывается прежде всего для использования в контроле системного состояния.
    
    Возвраты:
    
    true если могут быть другие потоки, ожидающие, чтобы получить блокировку
  - hasQueuedThread
```
public final boolean hasQueuedThread(Thread thread)
```
    Запросы, ожидает ли данный поток, чтобы получить или чтение или блокировку записи. Отметьте это, потому что отмены могут произойти в любое время, a true возврат не гарантирует, что этот поток будет когда-либо получать блокировку. Этот метод разрабатывается прежде всего для использования в контроле системного состояния.
    
    Параметры:
    
    thread - поток
    
    Возвраты:
    
    true если данный поток ставится в очередь, ожидая этой блокировки
    
    Броски:
    
    NullPointerException - если поток является нулем
  - getQueueLength
```
public final int getQueueLength()
```
    Возвращает оценку числа потоков, ожидающих, чтобы получить или чтение или блокировку записи. Значение является только оценкой, потому что число потоков может измениться динамически, в то время как этот метод пересекает внутренние структуры данных. Этот метод разрабатывается для использования в контроле системного состояния, не для управления синхронизацией.
    
    Возвраты:
    
    предполагаемое число потоков, ожидающих этой блокировки
  - getQueuedThreads
```
protected Collection<Thread> getQueuedThreads()
```
    Возвращает набор, содержащий потоки, которые могут ожидать, чтобы получить или чтение или блокировку записи. Поскольку фактический набор потоков может измениться динамически, создавая этот результат, возвращенный набор является только оценкой максимальных усилий. Элементы возвращенного набора без определенного порядка. Этот метод разрабатывается, чтобы облегчить конструкцию подклассов, которые предоставляют более обширные контрольные услуги.
    
    Возвраты:
    
    набор потоков
  - hasWaiters
```
public boolean hasWaiters(Condition condition)
```
    Запросы, ожидают ли какие-либо потоки на данном условии, связанном с блокировкой записи. Отметьте это, потому что тайм-ауты и прерывания могут произойти в любое время, a true возврат не гарантирует что будущее signal пробудит любые потоки. Этот метод разрабатывается прежде всего для использования в контроле системного состояния.
    
    Параметры:
    
    condition - условие
    
    Возвраты:
    
    true если есть какие-либо потоки ожидания
    
    Броски:
    
    IllegalMonitorStateException - если эта блокировка не сохранена
    
    IllegalArgumentException - если данное условие не связывается с этой блокировкой
    
    NullPointerException - если условие является нулем
  - getWaitQueueLength
```
public int getWaitQueueLength(Condition condition)
```
    Возвращает оценку числа потоков, ожидающих на данном условии, связанном с блокировкой записи. Отметьте, что, потому что тайм-ауты и прерывания могут произойти в любое время, оценка служит только в качестве верхней границы на фактическом числе официантов. Этот метод разрабатывается для использования в контроле системного состояния, не для управления синхронизацией.
    
    Параметры:
    
    condition - условие
    
    Возвраты:
    
    предполагаемое число потоков ожидания
    
    Броски:
    
    IllegalMonitorStateException - если эта блокировка не сохранена
    
    IllegalArgumentException - если данное условие не связывается с этой блокировкой
    
    NullPointerException - если условие является нулем
  - getWaitingThreads
```
protected Collection<Thread> getWaitingThreads(Condition condition)
```
    Возвращает набор, содержащий те потоки, которые могут ожидать на данном условии, связанном с блокировкой записи. Поскольку фактический набор потоков может измениться динамически, создавая этот результат, возвращенный набор является только оценкой максимальных усилий. Элементы возвращенного набора без определенного порядка. Этот метод разрабатывается, чтобы облегчить конструкцию подклассов, которые предоставляют более обширные услуги мониторинга состояния.
    
    Параметры:
    
    condition - условие
    
    Возвраты:
    
    набор потоков
    
    Броски:
    
    IllegalMonitorStateException - если эта блокировка не сохранена
    
    IllegalArgumentException - если данное условие не связывается с этой блокировкой
    
    NullPointerException - если условие является нулем
  - toString
```
public String toString()
```
    Возвращает строку, идентифицирующую эту блокировку, так же как ее состояние блокировки. Состояние, в скобках, включает Строку "Write locks =" сопровождаемый числом повторно используемо сохраненных блокировок записи, и Строкой "Read locks =" сопровождаемый числом сохраненных блокировок чтения.
    
    Переопределения:
    
    toString в class Object
    
    Возвраты:
    
    строка, идентифицирующая эту блокировку, так же как ее состояние блокировки

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92

Класс ReentrantReadWriteLock

Примечания реализации

Вложенная Сводка Класса

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

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

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

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

ReentrantReadWriteLock

ReentrantReadWriteLock

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

writeLock

readLock

isFair

getOwner

getReadLockCount

isWriteLocked

isWriteLockedByCurrentThread

getWriteHoldCount

getReadHoldCount

getQueuedWriterThreads

getQueuedReaderThreads

hasQueuedThreads

hasQueuedThread

getQueueLength

getQueuedThreads

hasWaiters

getWaitQueueLength

getWaitingThreads

toString