Exchanger Klasse

Definition

Namespace:: Java.Util.Concurrent

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 Synchronisierungspunkt, an dem Threads Elemente innerhalb von Paaren koppeln und austauschen können.

[Android.Runtime.Register("java/util/concurrent/Exchanger", DoNotGenerateAcw=true)]
[Java.Interop.JavaTypeParameters(new System.String[] { "V" })]
public class Exchanger : Java.Lang.Object

[<Android.Runtime.Register("java/util/concurrent/Exchanger", DoNotGenerateAcw=true)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "V" })>]
type Exchanger = class
    inherit Object

Vererbung: Object

JavaObject

Object
Exchanger

Attribute: RegisterAttribute JavaTypeParametersAttribute

Hinweise

Ein Synchronisierungspunkt, an dem Threads Elemente innerhalb von Paaren koppeln und austauschen können. Jeder Thread stellt ein Objekt für den #exchange exchange Eintrag zur Methode dar, stimmt mit einem Partnerthread überein und empfängt das Objekt des Partners beim Zurückgeben. Ein Exchanger kann als bidirektionale Form einer SynchronousQueue. Exchanger können in Anwendungen wie genetische Algorithmen und Pipelinedesigns nützlich sein.

<b>Beispielverwendung:</b> Hier sind die Highlights einer Klasse, die einen Exchanger Puffer zwischen Threads austauscht, sodass der Thread, der den Puffer füllt, einen frisch geleert erhält, wenn er ihn benötigt, und die gefüllte Klasse an den Thread ausgibt, der den Puffer leert.

{@code
            class FillAndEmpty {
              Exchanger<DataBuffer> exchanger = new Exchanger<>();
              DataBuffer initialEmptyBuffer = ...; // a made-up type
              DataBuffer initialFullBuffer = ...;

              class FillingLoop implements Runnable {
                public void run() {
                  DataBuffer currentBuffer = initialEmptyBuffer;
                  try {
                    while (currentBuffer != null) {
                      addToBuffer(currentBuffer);
                      if (currentBuffer.isFull())
                        currentBuffer = exchanger.exchange(currentBuffer);
                    }
                  } catch (InterruptedException ex) { ... handle ...}
                }
              }

              class EmptyingLoop implements Runnable {
                public void run() {
                  DataBuffer currentBuffer = initialFullBuffer;
                  try {
                    while (currentBuffer != null) {
                      takeFromBuffer(currentBuffer);
                      if (currentBuffer.isEmpty())
                        currentBuffer = exchanger.exchange(currentBuffer);
                    }
                  } catch (InterruptedException ex) { ... handle ...}
                }
              }

              void start() {
                new Thread(new FillingLoop()).start();
                new Thread(new EmptyingLoop()).start();
              }
            }}

Speicherkonsistenzeffekte: Für jedes Threadspaar, das Objekte erfolgreich über eine Exchanger, Aktionen vor dem exchange() in jedem Thread <i>happen-before</i> , die auf eine Rückgabe aus dem entsprechenden exchange() im anderen Thread folgen, austauschen.

Hinzugefügt in 1.5.

Java Dokumentation für java.util.concurrent.Exchanger.

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
Exchanger()	Erstellt einen neuen Exchanger.
Exchanger(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)
JniIdentityHashCode	Ruft den Identitätshashcode ab, der diesem Java Peer von der Interop-Laufzeit zugewiesen ist. (Geerbt von Object)
JniManagedPeerState	Ein Synchronisierungspunkt, an dem Threads Elemente innerhalb von Paaren koppeln und austauschen können. (Geerbt von JavaObject)
JniPeerMembers	Ein Synchronisierungspunkt, an dem Threads Elemente innerhalb von Paaren koppeln und austauschen können.
PeerReference	Ruft den JNI-Objektverweis für diesen Java Peer ab. (Geerbt von Object)
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 Synchronisierungspunkt, an dem Threads Elemente innerhalb von Paaren koppeln und austauschen können. (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 Synchronisierungspunkt, an dem Threads Elemente innerhalb von Paaren koppeln und austauschen können. (Geerbt von JavaObject)
Equals(Object)	Ein Synchronisierungspunkt, an dem Threads Elemente innerhalb von Paaren koppeln und austauschen können. (Geerbt von JavaObject)
Equals(Object)	Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist. (Geerbt von Object)
Exchange(Object, Int64, TimeUnit)	Wartet, bis ein anderer Thread an diesem Austauschpunkt eingeht (es sei denn, der aktuelle Thread ist Thread#interrupt unterbrochen oder die angegebene Wartezeit verstrichen), und überträgt dann das angegebene Objekt an ihn, wobei das Objekt zurückgegeben wird.
Exchange(Object)	Wartet, bis ein anderer Thread an diesem Austauschpunkt eingeht (es sei denn, der aktuelle Thread ist Thread#interrupt unterbrochen), und überträgt dann das angegebene Objekt an ihn, wobei das Objekt zurückgegeben wird.
GetHashCode()	Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object)
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)
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 Synchronisierungspunkt, an dem Threads Elemente innerhalb von Paaren koppeln und austauschen können. (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)
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 Synchronisierungspunkt, an dem Threads Elemente innerhalb von Paaren koppeln und austauschen können. (Geerbt von JavaObject)
IJavaPeerable.Finalized()	Ein Synchronisierungspunkt, an dem Threads Elemente innerhalb von Paaren koppeln und austauschen können. (Geerbt von JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	Ein Synchronisierungspunkt, an dem Threads Elemente innerhalb von Paaren koppeln und austauschen können. (Geerbt von JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Ein Synchronisierungspunkt, an dem Threads Elemente innerhalb von Paaren koppeln und austauschen können. (Geerbt von JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Ein Synchronisierungspunkt, an dem Threads Elemente innerhalb von Paaren koppeln und austauschen können. (Geerbt von JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Ein Synchronisierungspunkt, an dem Threads Elemente innerhalb von Paaren koppeln und austauschen können. (Geerbt von JavaObject)

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 Synchronisierungspunkt, an dem Threads Elemente innerhalb von Paaren koppeln und austauschen können.
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: