ReentrantReadWriteLock (Java Platform SE 8 )

java.lang.Object
- java.util.concurrent.locks.ReentrantReadWriteLock

All Implemented Interfaces:

Serializable， ReadWriteLock
```
public class ReentrantReadWriteLock
extends Object
implements ReadWriteLock, Serializable
```
ReadWriteLock支持类似的语义 ReentrantLock实现。
此类具有以下属性：
- 习得顺序
  此类不会强制读写器或写者优先顺序为锁访问。然而，它确实支持一个可选的公平性政策。
  
  非公平模式（默认）
  
  当构建非公平（默认），进入以读写锁是不确定的，受约束的可重入性。一个nonfair锁，不断争辩可能会无限期推迟一个或更多的读者或作家的线程，但通常会有更高的吞吐量比公平锁。
  
  公平模式
  
  当构建公平时，线程争夺进入使用约到达订单策略。当当前举行的锁被释放，无论是最长的等待单写入线程将被分配的写锁，或如果有一组读者线程等待比所有等待写线程等待更长的时间，该组将被分配的读锁。
  一个线程试图获得一个公平的读锁（非可重入）将块如果写锁，或有一个等待写线程。线程将无法获得读锁，直到最古老的当前等待的作家线程已经获得并释放了写锁。当然，如果一个等待的作者放弃它的等待，留下一个或多个读线程作为队列中最长的服务队列中的写锁，那么这些读者将被分配读锁。
  
  一个线程试图获得一个公平的写锁（非可重入）将阻止除非双方的读锁和写锁是免费的（这意味着没有等待的线程）。（注：非阻塞ReentrantReadWriteLock.ReadLock.tryLock()和ReentrantReadWriteLock.WriteLock.tryLock()方法不尊重这种公平设置，将立即获得锁，如果它是可能的，无论等待的线程。）
- 可重入
  这锁让读者和作家重新阅读或在一个ReentrantLock风格写锁。不可重入的读者是不允许直到所有写的写线程持有的锁被释放。
  此外，一个作家可以获得读锁，但不是反之亦然。在其他应用程序中，可重入性可能是有用的当写锁调用或回调方法执行期间举行读下读锁。如果一个读者试图获得写锁，它将永远不会成功。
- 锁降级
  可重入性，也允许降级的写锁，读锁，通过获取写锁，那么读锁，然后释放写锁。然而，从一个读锁升级为写锁不可能。
- 锁定捕获中断
  锁捕获过程中的读锁和写锁两个支持中断。
- Condition支持
  写入锁提供了一个Condition实施的行为，以同样的方式，相对于写锁，由ReentrantLock.newCondition()的Condition实现对ReentrantLock。当然这Condition可以，只能用写锁。
  读锁不支持Condition和readLock().newCondition()抛出UnsupportedOperationException。
- 仪器仪表
  该类支持方法来确定锁是否被保持或竞争。这些方法是专为监控系统状态而设计的，不用于同步控制。
这类的序列化的行为以同样的方式作为一个反序列化内置锁：锁处于解锁状态，无论其状态序列化时。

示例用法。下面的代码展示了如何更新缓存草图完成后锁降级（异常处理特别棘手时，在一个非嵌套的方式处理多个锁）：
```
 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 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超出这些限制的结果将从锁定的方法。
从以下版本开始：

一点五

另请参见：

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`ReentrantReadWriteLock.ReadLock` 方法返回的 `readLock()`锁。
`static class`	`ReentrantReadWriteLock.WriteLock` 方法返回的 `writeLock()`锁。

构造方法摘要

构造方法
Constructor and Description
`ReentrantReadWriteLock()` 创建默认的一个新的 `ReentrantReadWriteLock`（nonfair）排序性能。
`ReentrantReadWriteLock(boolean fair)` 创建具有给定的公平政策的一个新的 `ReentrantReadWriteLock`。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`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`如果锁已经公平设置为true。
`boolean`	`isWriteLocked()` 查询如果写锁是由任何线程举行。
`boolean`	`isWriteLockedByCurrentThread()` 查询如果写锁是由当前线程举行的。
`ReentrantReadWriteLock.ReadLock`	`readLock()` 返回用于读取的锁。
`String`	`toString()` 返回一个确定此锁的字符串，以及它的锁状态。
`ReentrantReadWriteLock.WriteLock`	`writeLock()` 返回用于写入的锁。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - ReentrantReadWriteLock
```
public ReentrantReadWriteLock()
```
    创建默认的一个新的 ReentrantReadWriteLock（nonfair）排序性能。
  - ReentrantReadWriteLock
```
public ReentrantReadWriteLock(boolean fair)
```
    创建具有给定的公平政策的一个新的 ReentrantReadWriteLock。
    
    参数
    
    fair - true如果锁应该用一个公平的订货策略
- 方法详细信息
  - writeLock
```
public ReentrantReadWriteLock.WriteLock writeLock()
```
    从接口复制的描述： ReadWriteLock
    
    返回用于写入的锁。
    
    Specified by:
    
    writeLock 接口 ReadWriteLock
    
    结果
    
    用于书写的锁
  - readLock
```
public ReentrantReadWriteLock.ReadLock readLock()
```
    从接口复制的描述： ReadWriteLock
    
    返回用于读取的锁。
    
    Specified by:
    
    readLock 接口 ReadWriteLock
    
    结果
    
    用于阅读的锁
  - isFair
```
public final boolean isFair()
```
    返回 true如果锁已经公平设置为true。
    
    结果
    
    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()
```
    查询的折返阅读次数，持有这个锁的当前线程。一个读线程具有一个保持在一个锁上的每个锁动作，不匹配的解锁动作。
    
    结果
    
    由当前线程保持的读锁的数量，或是零，如果读锁不被当前线程所持有
    
    从以下版本开始：
    
    一点六
  - getQueuedWriterThreads
```
protected Collection<Thread> getQueuedWriterThreads()
```
    返回一个包含可能等待获取写锁的线程的集合。由于实际的线程组在构建此结果时可能会动态更改，因此返回的集合只是一个最好的努力估计。返回的集合的元素没有特定的顺序。这种方法的目的是方便的子类，提供更广泛的锁定监控设施的建设。
    
    结果
    
    线程集合
  - getQueuedReaderThreads
```
protected Collection<Thread> getQueuedReaderThreads()
```
    返回一个包含可能等待获取读锁的线程的集合。由于实际的线程组在构建此结果时可能会动态更改，因此返回的集合只是一个最好的努力估计。返回的集合的元素没有特定的顺序。这种方法的目的是方便的子类，提供更广泛的锁定监控设施的建设。
    
    结果
    
    线程集合
  - hasQueuedThreads
```
public final boolean hasQueuedThreads()
```
    查询是否有任何线程等待获取读或写锁。注意，因为取消随时可能发生，一个 true返回不保证其他线程会获取一个锁。这种方法的设计主要是用于监测系统状态。
    
    结果
    
    true如果可能有其他线程等待获取锁
  - hasQueuedThread
```
public final boolean hasQueuedThread(Thread thread)
```
    查询给定线程是否等待获取读或写锁。注意，因为取消随时可能发生，一个 true回报并不保证该线程会获取一个锁。这种方法的设计主要是用于监测系统状态。
    
    参数
    
    thread -螺纹
    
    结果
    
    true如果给定线程排队等待这个锁
    
    异常
    
    NullPointerException -如果线程是无效的
  - getQueueLength
```
public final int getQueueLength()
```
    返回等待获取读写锁的线程数的估计值。价值只是一个估计值，因为线程的数量可以动态变化，而这一方法遍历内部数据结构。这种方法被设计用于监视系统状态，而不是用于同步控制。
    
    结果
    
    等待此锁的线程的估计数
  - getQueuedThreads
```
protected Collection<Thread> getQueuedThreads()
```
    返回一个包含可能等待获取读写锁的线程的集合。由于实际的线程组在构建此结果时可能会动态更改，因此返回的集合只是一个最好的努力估计。返回的集合的元素没有特定的顺序。这种方法的目的是方便的子类，提供更广泛的监控设施的建设。
    
    结果
    
    线程集合
  - hasWaiters
```
public boolean hasWaiters(Condition condition)
```
    查询是否有任何线程在与写锁关联的给定条件下等待。注意，因为超时和中断可能发生在任何时间，一个 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 方法重写，继承类 Object
    
    结果
    
    确定该锁的字符串，以及它的锁状态

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class ReentrantReadWriteLock

实现注意事项

Nested Class Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Constructor Detail

ReentrantReadWriteLock

ReentrantReadWriteLock

方法详细信息

writeLock

readLock

isFair

getOwner

getReadLockCount

isWriteLocked

isWriteLockedByCurrentThread

getWriteHoldCount

getReadHoldCount

getQueuedWriterThreads

getQueuedReaderThreads

hasQueuedThreads

hasQueuedThread

getQueueLength

getQueuedThreads

hasWaiters

getWaitQueueLength

getWaitingThreads

toString