Exchanger 類別

定義

命名空間:: Java.Util.Concurrent

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

一個同步點，執行緒可以配對並在成對中交換元素。

[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

繼承: Object

JavaObject

Object
Exchanger

屬性: RegisterAttribute JavaTypeParametersAttribute

備註

一個同步點，執行緒可以配對並在成對中交換元素。每個執行緒在方法 #exchange exchange 入口時呈現一個物件，與夥伴執行緒匹配，並在返回時接收夥伴的物件。交換器可視為的雙向形式 SynchronousQueue。交換器可能在遺傳演算法和管線設計等應用中非常有用。

<b>範例使用：</b> 以下是一門使用A Exchanger 在不同執行緒間交換緩衝區的類別重點，讓填滿緩衝區的執行緒在需要時獲得一個剛清空的緩衝區，將填滿的緩衝區交給清空緩衝區的執行緒。

{@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();
              }
            }}

記憶體一致性效應：對於每對成功透過、交換物件Exchanger的執行緒，在每個執行緒 exchange()i 之前的動作發生於之前</>i< 在另一執行緒中對應>執行緒回傳之後的動作exchange()。

已在1.5中新增。

Java 文件 java.util.concurrent.Exchanger。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

建構函式

名稱	Description
Exchanger()	會創造一個新的交換者。
Exchanger(IntPtr, JniHandleOwnership)	用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。

屬性

名稱	Description
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	一個同步點，執行緒可以配對並在成對中交換元素。 (繼承來源 JavaObject)
JniPeerMembers	一個同步點，執行緒可以配對並在成對中交換元素。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。

方法

名稱	Description
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	一個同步點，執行緒可以配對並在成對中交換元素。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	一個同步點，執行緒可以配對並在成對中交換元素。 (繼承來源 JavaObject)
Equals(Object)	一個同步點，執行緒可以配對並在成對中交換元素。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
Exchange(Object, Int64, TimeUnit)	等待另一個執行緒抵達此交換點（除非當前執行緒被 Thread#interrupt 中斷或指定的等待時間已過），然後將指定物件傳送給該執行緒，並接收該物件作為回報。
Exchange(Object)	等待另一個執行緒抵達此交換點（除非目前執行緒被 Thread#interrupt 中斷），然後將指定物件傳送給該執行緒，並接收該物件作為回報。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	一個同步點，執行緒可以配對並在成對中交換元素。 (繼承來源 JavaObject)
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	一個同步點，執行緒可以配對並在成對中交換元素。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	一個同步點，執行緒可以配對並在成對中交換元素。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	一個同步點，執行緒可以配對並在成對中交換元素。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	一個同步點，執行緒可以配對並在成對中交換元素。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	一個同步點，執行緒可以配對並在成對中交換元素。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	一個同步點，執行緒可以配對並在成對中交換元素。 (繼承來源 JavaObject)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	一個同步點，執行緒可以配對並在成對中交換元素。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於