语言

ReentrantReadWriteLock.ReentrantReadLock.TryLock 方法

定义

重载

名称 说明
TryLock()

仅当写入锁在调用时不由另一个线程持有时,才获取读取锁。

TryLock(Int64, TimeUnit)

如果写入锁不在给定的等待时间内由另一个线程持有,并且当前线程尚未中断 Thread#中断,则获取读取锁。

TryLock()

仅当写入锁在调用时不由另一个线程持有时,才获取读取锁。

[Android.Runtime.Register("tryLock", "()Z", "GetTryLockHandler")]
public virtual bool TryLock();
[<Android.Runtime.Register("tryLock", "()Z", "GetTryLockHandler")>]
abstract member TryLock : unit -> bool
override this.TryLock : unit -> bool

返回

true 如果已获取读取锁,则为

实现

特性

注解

仅当写入锁在调用时不由另一个线程持有时,才获取读取锁。

如果写入锁不由另一个线程持有,并立即返回值 true,则获取读取锁。 即使此锁已设置为使用公平排序策略,调用将tryLock()立即获取读取锁(如果可用),不管其他线程当前是否正在等待读取锁。 这种“禁止”行为在某些情况下可能很有用,即使它打破公平性。 如果要遵守此锁的公平性设置,请使用 #tryLock(long, TimeUnit) tryLock(0, TimeUnit.SECONDS) 几乎等效的(它还检测到中断)。

如果写入锁由另一个线程保留,则此方法将立即返回值 false。

Java文档java.util.concurrent.locks.ReentrantReadWriteLock.ReadLock.tryLock()。

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于

TryLock(Int64, TimeUnit)

如果写入锁不在给定的等待时间内由另一个线程持有,并且当前线程尚未中断 Thread#中断,则获取读取锁。

[Android.Runtime.Register("tryLock", "(JLjava/util/concurrent/TimeUnit;)Z", "GetTryLock_JLjava_util_concurrent_TimeUnit_Handler")]
public virtual bool TryLock(long timeout, Java.Util.Concurrent.TimeUnit? unit);
[<Android.Runtime.Register("tryLock", "(JLjava/util/concurrent/TimeUnit;)Z", "GetTryLock_JLjava_util_concurrent_TimeUnit_Handler")>]
abstract member TryLock : int64 * Java.Util.Concurrent.TimeUnit -> bool
override this.TryLock : int64 * Java.Util.Concurrent.TimeUnit -> bool

参数

timeout
Int64

等待读取锁的时间

unit
TimeUnit

超时参数的时间单位

返回

true 如果已获取读取锁,则为

实现

特性

例外

如果当前线程中断

如果时间单位为 null,则为

注解

如果写入锁不在给定的等待时间内由另一个线程持有,并且当前线程尚未中断 Thread#中断,则获取读取锁。

如果写入锁不由另一个线程持有,并立即返回值 true,则获取读取锁。 如果此锁已设置为使用公平排序策略,则如果任何其他线程正在等待锁, 则不会 获取可用锁。 这与 #tryLock() 方法形成鲜明对比。 如果想要允许对公平锁进行禁止的计时, tryLock 则将计时和未计时的表单合并在一起:

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

如果写入锁由另一个线程持有,则当前线程出于线程计划目的而禁用,并处于休眠状态,直到发生以下三件事之一:

<ul>

<li>当前线程获取读取锁;或

<li>其他一些线程 Thread#中断中断当前线程;或

<li>指定的等待时间已过。

</ul>

如果获取读取锁,则返回该值 true 。

如果当前线程:

<ul>

<li>在进入此方法时设置了中断状态;或

<li>是线程#中断在获取读取锁时中断的,

<然后InterruptedException引发 /ul>,并清除当前线程的中断状态。

如果指定的等待时间已过,则返回该值 false 。 如果时间小于或等于零,则该方法根本不会等待。

在此实现中,由于此方法是显式中断点,因此优先于响应对锁的正常或重新进入获取的中断,并报告等待时间的运行时间。

Java文档java.util.concurrent.locks.ReentrantReadWriteLock.ReadLock.tryLock(long, java.util.concurrent.TimeUnit)。

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于