ReentrantLock Klasse

Definition

Namespace:: Java.Util.Concurrent.Locks

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ein erneuter gegenseitiger Ausschluss Lock mit demselben grundlegenden Verhalten und derselben Semantik wie die implizite Monitorsperre, auf die mithilfe von synchronized Methoden und Anweisungen zugegriffen wird, aber mit erweiterten Funktionen.

[Android.Runtime.Register("java/util/concurrent/locks/ReentrantLock", DoNotGenerateAcw=true)]
public class ReentrantLock : Java.Lang.Object, IDisposable, Java.IO.ISerializable, Java.Util.Concurrent.Locks.ILock

[<Android.Runtime.Register("java/util/concurrent/locks/ReentrantLock", DoNotGenerateAcw=true)>]
type ReentrantLock = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface ILock

Vererbung: Object

JavaObject

Object
ReentrantLock

Attribute: RegisterAttribute

Implementiert: IJavaObject IJavaPeerable ISerializable ILock IDisposable

Hinweise

A ReentrantLock ist <em>owned</em> by the thread last erfolgreich locking, but not yet unlocking it. Ein Thread, der aufgerufen lock wird, wird zurückgegeben und die Sperre erfolgreich erworben, wenn die Sperre nicht im Besitz eines anderen Threads ist. Die Methode wird sofort zurückgegeben, wenn der aktuelle Thread bereits über die Sperre verfügt. Dies kann mithilfe von Methoden #isHeldByCurrentThreadund #getHoldCount.

Der Konstruktor für diese Klasse akzeptiert einen optionalen <em>fairness</em-Parameter> . Wenn diese Einstellung festgelegt trueist, bevorzugen Sperren das Gewähren des Zugriffs auf den längsten Wartethread. Andernfalls garantiert diese Sperre keine bestimmte Zugriffsreihenfolge. Programme mit fairen Sperren, auf die von vielen Threads zugegriffen wird, zeigen möglicherweise einen niedrigeren Gesamtdurchsatz an (d. h. langsamer, oft langsamer) als diejenigen, die die Standardeinstellung verwenden, aber in Zeiten kleinere Varianzen aufweisen, um Sperren zu erhalten und zu garantieren, dass keine Verhungerung besteht. Beachten Sie jedoch, dass die Fairness von Sperren nicht die Fairness der Threadplanung garantiert. Daher kann eine von vielen Threads, die eine faire Sperre verwenden, mehrmals nacheinander erhalten, während andere aktive Threads nicht vorankommen und die Sperre derzeit nicht halten. Beachten Sie außerdem, dass die unbezeitigte #tryLock() Methode die Fairnesseinstellung nicht berücksichtigt. Es wird erfolgreich ausgeführt, wenn die Sperre auch dann verfügbar ist, wenn andere Threads warten.

Es wird empfohlen, <immer></em> sofort einem Aufruf lock mit einem try Block zu folgen, in der Regel in einem Vor-/Nachbau, z. B.:

{@code
            class X {
              private final ReentrantLock lock = new ReentrantLock();
              // ...

              public void m() {
                lock.lock();  // block until condition holds
                try {
                  // ... method body
                } finally {
                  lock.unlock();
                }
              }
            }}

Zusätzlich zur Implementierung der Lock Schnittstelle definiert diese Klasse eine Reihe von public Methoden protected zum Überprüfen des Zustands der Sperre. Einige dieser Methoden sind nur für Instrumentierung und Überwachung nützlich.

Die Serialisierung dieser Klasse verhält sich auf die gleiche Weise wie integrierte Sperren: Eine deserialisierte Sperre befindet sich unabhängig vom Zustand der Serialisierung im nicht gesperrten Zustand.

Diese Sperre unterstützt maximal 2147483647 rekursive Sperren durch denselben Thread. Versuche, diesen Grenzwert zu überschreiten, führen zu Error Auslösern von Sperrmethoden.

Hinzugefügt in 1.5.

Java Dokumentation für java.util.concurrent.locks.ReentrantLock.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Konstruktoren

Name	Beschreibung
ReentrantLock()	Erstellt eine Instanz von `ReentrantLock`.
ReentrantLock(Boolean)	Erstellt eine Instanz mit `ReentrantLock` der gegebenen Fairnessrichtlinie.
ReentrantLock(IntPtr, JniHandleOwnership)	Ein Konstruktor, der beim Erstellen verwalteter Darstellungen von JNI-Objekten verwendet wird; wird von der Laufzeit aufgerufen.

Eigenschaften

Name	Beschreibung
Class	Gibt die Laufzeitklasse dieses Werts `Object`zurück. (Geerbt von Object)
Handle	Das Handle für die zugrunde liegende Android-Instanz. (Geerbt von Object)
HasQueuedThreads	Fragt ab, ob Threads darauf warten, diese Sperre abzurufen.
HoldCount	Fragt die Anzahl der Haltebereiche für diese Sperre durch den aktuellen Thread ab.
IsFair	Gibt zurück `true` , wenn diese Sperre "Fairness" auf "true" festgelegt hat.
IsHeldByCurrentThread	Fragt ab, ob diese Sperre vom aktuellen Thread gehalten wird.
IsLocked	Abfragen, wenn diese Sperre von einem beliebigen Thread gehalten wird.
JniIdentityHashCode	Ruft den Identitätshashcode ab, der diesem Java Peer von der Interop-Laufzeit zugewiesen ist. (Geerbt von Object)
JniManagedPeerState	Ein erneuter gegenseitiger Ausschluss `Lock` mit demselben grundlegenden Verhalten und derselben Semantik wie die implizite Monitorsperre, auf die mithilfe von `synchronized` Methoden und Anweisungen zugegriffen wird, aber mit erweiterten Funktionen. (Geerbt von JavaObject)
JniPeerMembers	Ruft die JNI-Metadaten ab, die zum Aufrufen von Mitgliedern dieses Java Peers verwendet werden.
Owner	Gibt den Thread zurück, der derzeit über diese Sperre verfügt oder `null` nicht im Besitz ist.
PeerReference	Ruft den JNI-Objektverweis für diesen Java Peer ab. (Geerbt von Object)
QueuedThreads	Gibt eine Auflistung zurück, die Threads enthält, die auf den Erwerb dieser Sperre warten können.
QueueLength	Gibt eine Schätzung der Anzahl der Threads zurück, die auf den Erwerb dieser Sperre warten.
ThresholdClass	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.
ThresholdType	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.

Methoden

Name	Beschreibung
Clone()	Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	Ein erneuter gegenseitiger Ausschluss `Lock` mit demselben grundlegenden Verhalten und derselben Semantik wie die implizite Monitorsperre, auf die mithilfe von `synchronized` Methoden und Anweisungen zugegriffen wird, aber mit erweiterten Funktionen. (Geerbt von JavaObject)
Dispose()	Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object)
Dispose(Boolean)	Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object)
DisposeUnlessReferenced()	Ein erneuter gegenseitiger Ausschluss `Lock` mit demselben grundlegenden Verhalten und derselben Semantik wie die implizite Monitorsperre, auf die mithilfe von `synchronized` Methoden und Anweisungen zugegriffen wird, aber mit erweiterten Funktionen. (Geerbt von JavaObject)
Equals(Object)	Ein erneuter gegenseitiger Ausschluss `Lock` mit demselben grundlegenden Verhalten und derselben Semantik wie die implizite Monitorsperre, auf die mithilfe von `synchronized` Methoden und Anweisungen zugegriffen wird, aber mit erweiterten Funktionen. (Geerbt von JavaObject)
Equals(Object)	Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist. (Geerbt von Object)
GetHashCode()	Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object)
GetWaitingThreads(ICondition)	Gibt eine Auflistung zurück, die diese Threads enthält, die möglicherweise auf die angegebene Bedingung warten, die dieser Sperre zugeordnet ist.
GetWaitQueueLength(ICondition)	Gibt eine Schätzung der Anzahl der Threads zurück, die auf die angegebene Bedingung warten, die dieser Sperre zugeordnet ist.
HasQueuedThread(Thread)	Fragt ab, ob der angegebene Thread auf den Erwerb dieser Sperre wartet.
HasWaiters(ICondition)	Fragt ab, ob Threads auf die angegebene Bedingung warten, die dieser Sperre zugeordnet ist.
JavaFinalize()	Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection bestimmt, dass keine weiteren Verweise auf das Objekt vorhanden sind. (Geerbt von Object)
Lock()	Erwirbt die Sperre.
LockInterruptibly()	Erwirbt die Sperre, es sei denn, der aktuelle Thread ist Thread#interrupt unterbrochen.
NewCondition()	Gibt eine `Condition` Instanz für die Verwendung mit dieser `Lock` Instanz zurück.
Notify()	Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet. (Geerbt von Object)
NotifyAll()	Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten. (Geerbt von Object)
SetHandle(IntPtr, JniHandleOwnership)	Legt die Handle-Eigenschaft fest. (Geerbt von Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Ein erneuter gegenseitiger Ausschluss `Lock` mit demselben grundlegenden Verhalten und derselben Semantik wie die implizite Monitorsperre, auf die mithilfe von `synchronized` Methoden und Anweisungen zugegriffen wird, aber mit erweiterten Funktionen. (Geerbt von JavaObject)
ToArray<T>()	Erstellt ein verwaltetes Array aus diesem Java Arraywrapper. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object)
TryLock()	Erwirbt die Sperre nur, wenn sie zum Zeitpunkt des Aufrufs nicht von einem anderen Thread gehalten wird.
TryLock(Int64, TimeUnit)	Erwirbt die Sperre, wenn sie nicht von einem anderen Thread innerhalb der angegebenen Wartezeit gehalten wird und der aktuelle Thread nicht unterbrochen wurde.
Unlock()	Versucht, diese Sperre freizugeben.
UnregisterFromRuntime()	Hebt die Registrierung dieses Java Peers aus der Interop-Laufzeit auf. (Geerbt von Object)
Wait()	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch em benachrichtigt/em< oder >em<unterbrochen>/em<.><> (Geerbt von Object)
Wait(Int64, Int32)	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
Wait(Int64)	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IJavaPeerable.Disposed()	Ein erneuter gegenseitiger Ausschluss `Lock` mit demselben grundlegenden Verhalten und derselben Semantik wie die implizite Monitorsperre, auf die mithilfe von `synchronized` Methoden und Anweisungen zugegriffen wird, aber mit erweiterten Funktionen. (Geerbt von JavaObject)
IJavaPeerable.Finalized()	Ein erneuter gegenseitiger Ausschluss `Lock` mit demselben grundlegenden Verhalten und derselben Semantik wie die implizite Monitorsperre, auf die mithilfe von `synchronized` Methoden und Anweisungen zugegriffen wird, aber mit erweiterten Funktionen. (Geerbt von JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	Ein erneuter gegenseitiger Ausschluss `Lock` mit demselben grundlegenden Verhalten und derselben Semantik wie die implizite Monitorsperre, auf die mithilfe von `synchronized` Methoden und Anweisungen zugegriffen wird, aber mit erweiterten Funktionen. (Geerbt von JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Ein erneuter gegenseitiger Ausschluss `Lock` mit demselben grundlegenden Verhalten und derselben Semantik wie die implizite Monitorsperre, auf die mithilfe von `synchronized` Methoden und Anweisungen zugegriffen wird, aber mit erweiterten Funktionen. (Geerbt von JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Ein erneuter gegenseitiger Ausschluss `Lock` mit demselben grundlegenden Verhalten und derselben Semantik wie die implizite Monitorsperre, auf die mithilfe von `synchronized` Methoden und Anweisungen zugegriffen wird, aber mit erweiterten Funktionen. (Geerbt von JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Ein erneuter gegenseitiger Ausschluss `Lock` mit demselben grundlegenden Verhalten und derselben Semantik wie die implizite Monitorsperre, auf die mithilfe von `synchronized` Methoden und Anweisungen zugegriffen wird, aber mit erweiterten Funktionen. (Geerbt von JavaObject)
IJavaPeerable.UnregisterFromRuntime()	Ein erneuter gegenseitiger Ausschluss `Lock` mit demselben grundlegenden Verhalten und derselben Semantik wie die implizite Monitorsperre, auf die mithilfe von `synchronized` Methoden und Anweisungen zugegriffen wird, aber mit erweiterten Funktionen.

Erweiterungsmethoden

Name	Beschreibung
GetJniTypeName(IJavaPeerable)	Ruft den JNI-Namen des Typs der Instanz `self`ab.
JavaAs<TResult>(IJavaPeerable)	Versuchen Sie, die Eingabe `self`zu `TResult` erzwingen, und überprüfen Sie, ob die Koersion auf der Java Seite gültig ist.
JavaCast<TResult>(IJavaObject)	Führt eine android-laufzeitgecheckte Typkonvertierung aus.
JavaCast<TResult>(IJavaObject)	Ein erneuter gegenseitiger Ausschluss `Lock` mit demselben grundlegenden Verhalten und derselben Semantik wie die implizite Monitorsperre, auf die mithilfe von `synchronized` Methoden und Anweisungen zugegriffen wird, aber mit erweiterten Funktionen.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Versuchen Sie, die Eingabe `self`zu `TResult` erzwingen, und überprüfen Sie, ob die Koersion auf der Java Seite gültig ist.

Gilt für: