ReentrantReadWriteLock.ReadLock (Java Platform SE 8 )

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

All Implemented Interfaces:

Serializable ， Lock

Enclosing class:

ReentrantReadWriteLock
```
public static class ReentrantReadWriteLock.ReadLock
extends Object
implements Lock, Serializable
```
该锁由方法 ReentrantReadWriteLock.readLock()返回。

另请参见：

Serialized Form

构造方法摘要

构造方法
Modifier	Constructor and Description
`protected`	`ReadLock(ReentrantReadWriteLock lock)` 子类使用的构造方法

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`void`	`lock()` 获取读锁。
`void`	`lockInterruptibly()` 获取读锁定，除非当前线程为 interrupted 。
`Condition`	`newCondition()` `UnsupportedOperationException`因为 `ReadLocks`不支持条件。
`String`	`toString()` 返回一个标识此锁的字符串以及其锁定状态。
`boolean`	`tryLock()` 只有在调用时写锁定不被其他线程占用才能获取读锁。
`boolean`	`tryLock(long timeout, TimeUnit unit)` 如果写锁定在给定等待时间内未被另一个线程占用，并且当前线程尚未 interrupted，则获取读锁。
`void`	`unlock()` 尝试释放此锁。

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

- 构造方法详细信息
  - ReadLock
```
protected ReadLock(ReentrantReadWriteLock lock)
```
    子类使用的构造方法
    
    参数
    
    lock - 外锁对象
    
    异常
    
    NullPointerException - 如果锁为空
- 方法详细信息
  - lock
```
public void lock()
```
    获取读锁。
    如果写锁定不被另一个线程占用并立即返回，则获取读取锁定。
    
    如果写锁定由另一个线程保存，则当前线程将被禁用以进行线程调度，并处于休眠状态，直到获取读取锁定为止。
    
    Specified by:
    
    lock在界面 Lock
  - lockInterruptibly
```
public void lockInterruptibly()
                       throws InterruptedException
```
    获取读锁定，除非当前线程是interrupted 。
    如果写锁定不被另一个线程占用并立即返回，则获取读取锁定。
    
    如果写锁定由另一个线程保存，则当前线程将被禁用以进行线程调度，并且处于休眠状态，直到发生两件事情之一：
    - 读锁定由当前线程获取; 要么
    - 一些其他线程当前线程interrupts 。
    如果当前线程：
    - 在进入该方法时设置了中断状态; 要么
    - 是interrupted同时获取读锁，
    然后InterruptedException被关上，当前线程的中断状态被清除。
    在该实现中，由于该方法是明确的中断点，所以优先考虑通过锁定正常或可重入的采集来响应中断。
    Specified by:
    
    lockInterruptibly在界面 Lock
    
    异常
    
    InterruptedException - 当前线程是否中断
  - tryLock
```
public boolean tryLock()
```
    只有在调用时写锁定不被其他线程占用才能获取读锁。
    如果写锁定不被另一个线程占用，则获取读锁定，并立即返回值为true 。即使此锁已设置为使用合理的订购策略，如果可用，则呼叫tryLock() 将立即获取读锁定，无论其他线程是否正在等待读锁定。这种“趸船”行为在某些情况下是有用的，尽管它打破了公平。如果你希望遵守公平设置此锁，然后用tryLock(0, TimeUnit.SECONDS) 这几乎是等效的（它也检测中断）。
    
    如果写锁定由另一个线程持有，则该方法将立即返回值为false 。
    
    Specified by:
    
    tryLock在界面 Lock
    
    结果
    
    true如果读锁被获取
  - tryLock
```
public boolean tryLock(long timeout,
                       TimeUnit unit)
                throws InterruptedException
```
    如果写锁定在给定等待时间内没有被另一个线程占用，并且当前线程尚未被保留，则获取读锁定interrupted 。
    如果写锁定不被另一个线程占用，则获取读锁定，并立即返回值为true 。如果此锁已设置为使用合理的排序策略，则如果任何其他线程正在等待锁定， 则不会获取可用的锁。这与tryLock()方法相反。如果你想要一个定时的tryLock确实允许在公平的锁上的tryLock ，那么将定时和非定时的形式结合在一起：
```
   if (lock.tryLock() || lock.tryLock(timeout, unit)) { ... } 
```
    如果写锁定由另一个线程保存，则当前线程将被禁用以进行线程调度，并且处于休眠状态，直至发生三件事情之一：
    - 读锁定由当前线程获取; 要么
    - 一些其他线程当前线程interrupts ; 要么
    - 指定的等待时间过去了。
    如果读取锁定，则返回值true 。
    
    如果当前线程：
    - 在进入该方法时设置了中断状态; 要么
    - 是interrupted同时获取读锁，
    然后InterruptedException被关上，当前线程的中断状态被清除。
    如果指定的等待时间过去，则返回值false 。如果时间小于或等于零，该方法根本不会等待。
    
    在这种实现中，由于该方法是明确的中断点，所以优先考虑响应中断超过正常或可重入的锁的获取，并且报告等待时间的过去。
    Specified by:
    
    tryLock在界面 Lock
    
    参数
    
    timeout - 等待读锁的时间
    
    unit - 超时参数的时间单位
    
    结果
    
    true如果读取锁被获取
    
    异常
    
    InterruptedException - 当前线程是否中断
    
    NullPointerException - 如果时间单位为空
  - unlock
```
public void unlock()
```
    尝试释放此锁。
    如果读取器的数量现在为零，则锁定可用于写入锁定尝试。
    
    Specified by:
    
    unlock在界面 Lock
  - newCondition
```
public Condition newCondition()
```
    UnsupportedOperationException因为 ReadLocks不支持条件。
    
    Specified by:
    
    newCondition在界面 Lock
    
    结果
    
    一个新的Condition实例为这个Lock实例
    
    异常
    
    UnsupportedOperationException - 永远
  - toString
```
public String toString()
```
    返回一个标识此锁的字符串以及其锁定状态。括号中的状态包括字符串"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.ReadLock

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

构造方法详细信息

ReadLock

方法详细信息

lock

lockInterruptibly

tryLock

tryLock

unlock

newCondition

toString