語言

ReentrantReadWriteLock.ReentrantReadLock.TryLock 方法

定義

多載

名稱 Description
TryLock()

只有當呼叫時寫鎖未被其他執行緒持有時,才會取得讀取鎖。

TryLock(Int64, TimeUnit)

若在指定等待時間內未被其他執行緒持有寫入鎖,且當前執行緒未被 Thread#interrupt 中斷,則取得讀取鎖。

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#interrupt 中斷,則取得讀取鎖。

[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 如果已取得讀取鎖

實作

屬性

例外狀況

如果目前執行緒被中斷

若時間單位為零

備註

若在指定等待時間內未被其他執行緒持有寫入鎖,且當前執行緒未被 Thread#interrupt 中斷,則取得讀取鎖。

若寫鎖未被其他執行緒持有,則取得讀取鎖,並立即返回值 true。 如果此鎖已設定為使用公平排序策略,則若有其他執行緒等待該鎖,則 不會 取得可用的鎖。 這與方法 #tryLock() 形成對比。 如果你想要一個允許衝撞公平鎖的計時 tryLock 表單,那就把計時和非計時表合併一起:

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

若寫入鎖由另一執行緒持有,則目前執行緒將因排程而停用,並處於休眠狀態,直到以下三種情況之一發生:

<UL>

<li>讀取鎖由目前執行緒取得;或

<li>其他執行緒 Thread#interrupt 中斷目前執行緒;或

<li>指定的等待時間已過。

</ul>

若讀取鎖被取得,則回傳該值 true 。

如果目前的討論串:

<UL>

<li>在進入此方法時已設定其中斷狀態;或

<li>是在取得讀取鎖時被中斷的 Thread#interrupt,

<接著InterruptedException拋出 /ul>,並清除當前執行緒的中斷狀態。

若等待時間達到指定時間,則會回傳該值 false 。 若時間小於或等於零,該方法將完全不等待。

在此實作中,由於此方法為明確的中斷點,優先回應中斷而非正常或重入鎖定,且優先回報等待時間的經過。

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

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

適用於