Selector 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
物件的多任務器 SelectableChannel 。
[Android.Runtime.Register("java/nio/channels/Selector", DoNotGenerateAcw=true)]
public abstract class Selector : Java.Lang.Object, IDisposable, Java.Interop.IJavaPeerable, Java.IO.ICloseable[<Android.Runtime.Register("java/nio/channels/Selector", DoNotGenerateAcw=true)>]
type Selector = class
inherit Object
interface ICloseable
interface IJavaObject
interface IDisposable
interface IJavaPeerable- 繼承
- 衍生
- 屬性
- 實作
備註
物件的多任務器 SelectableChannel 。
叫用這個類別的 方法可以建立 #open open 選取器，這會使用系統的預設值 java.nio.channels.spi.SelectorProvider selector provider 來建立新的選取器。 您也可以叫用 java.nio.channels.spi.SelectorProvider#openSelector openSelector 自定義選取器提供者的 方法來建立選取器。 選取器會保持開啟狀態，直到它透過其 #close close 方法關閉為止。
“ks”>
可選取的通道向選取器註冊是由 物件表示 SelectionKey 。 選取器會維護三組選取索引鍵：
<ul>
<李>
金鑰 集 包含代表這個選取器目前通道註冊的金鑰。 此方法會傳 #keys() keys 回此集合。
</李>
<李>
選取 的索引鍵集 是一組索引鍵，可讓每個密鑰的通道偵測到已準備好，以在先前選取作業期間，針對在索引鍵感興趣的集合中識別出至少一個作業，以在集合中新增索引鍵或更新密鑰。 此方法會傳 #selectedKeys() selectedKeys 回此集合。 選取的索引鍵集一律是索引鍵集的子集。
</李>
<李>
已取消的金鑰集是已取消但通道尚未取消的金鑰集。 無法直接存取此集合。 已取消的金鑰集一律是索引鍵集的子集。
</李>
</ul>
這三個集合在新建立的選取器中都是空的。
索引鍵會新增至選取器的密鑰集，作為透過通道方法註冊通道的 SelectableChannel#register(Selector,int) register 副作用。 取消的索引鍵會在選取作業期間從索引鍵集移除。 索引鍵集本身無法直接修改。
當索引鍵取消時，索引鍵會新增至其選取器已取消的索引鍵集，無論是關閉其通道，還是叫用其 SelectionKey#cancel cancel 方法。 取消金鑰會導致下一個選取作業期間取消註冊其通道，屆時會從選取器的所有索引鍵集中移除密鑰。
“sks”>
索引鍵會依選取作業新增至選取的索引鍵集。 藉由叫用集合的 java.util.Set#remove(java.lang.Object) remove 方法或 java.util.Iterator#remove() remove 叫用從集合取得之 java.util.Iterator iterator 的方法，即可直接從選取的索引鍵集合中移除索引鍵。 叫用集合的 方法，即可移除所有索引鍵集合中的 java.util.Set#clear() clear 索引鍵。 金鑰可能不會直接新增至選取的索引鍵集。
“selop”><h2>Selection</h2>
選取作業會查詢基礎操作系統，以取得每個已註冊通道的整備程度，以執行其密鑰興趣集合所識別的任何作業。 選取作業有兩種形式：
<老>
<李>
#select()、 #select(long)和 #selectNow() 方法會將已準備好執行作業的通道索引鍵新增至選取的索引鍵集，或更新已在選取密鑰集中的就緒作業集。
</李>
<李>
#select(Consumer)、 #select(Consumer, long)和 #selectNow(Consumer) 方法會在準備好執行作業的每個通道索引鍵上執行動作。 這些方法不會新增至選取的索引鍵集。
</李>
</老>
<h3>新增至選取索引鍵集</h3 的選取作業>
在每個選取作業期間，索引鍵可以新增至選取器的選取鍵集並移除，而且可以從其索引鍵和已取消的索引鍵集合中移除。 選取是由 #select()、 #select(long)和 #selectNow() 方法執行，並包含三個步驟：
<老>
<李>
取消金鑰集中的每個索引鍵都會從其所屬的每個索引鍵集中移除，而且其通道會取消註冊。 此步驟會將已取消的金鑰集保留空白。
</李>
<李>
基礎操作系統會針對每個剩餘通道的整備程度進行查詢，以執行其密鑰興趣集所識別的任何作業，從選取作業開始的那一刻開始。 針對已備妥至少一個這類作業的通道，會執行下列兩個動作之一：
<老>
<李>
如果通道的索引鍵尚未在選取的索引鍵集中，則會將其新增至該集合，並修改其就緒作業集，以確切識別通道現在報告為就緒的作業。 會捨棄先前在就緒集合中記錄的任何整備資訊。
</李>
<李>
否則，通道的索引鍵已經位於選取的索引鍵集中，因此會修改其就緒作業集，以識別通道已報告為就緒的任何新作業。 會保留先前在就緒集合中記錄的任何整備資訊;換句話說，基礎系統傳回的就緒集合會位脫離索引鍵目前的就緒集。
</李>
</老>
如果此步驟開始時密鑰集中的所有索引鍵都有空的興趣集，則不會更新選取的索引鍵集，也不會更新任何索引鍵的就緒作業集。
<李>
如果在步驟 （2） 進行時，已將任何密鑰新增至已取消的密鑰集合，則會將其處理為步驟 （1）。
</李>
</老>
選取作業區塊是否封鎖等候一或多個通道準備就緒，如果是多久，則為三個選取方法之間的唯一基本差異。
<h3>選取作業，在選取的索引鍵</h3 上執行動作>
在每個選取作業期間，索引鍵可能會從選取器的索引鍵、selected-key 和 cancelled-key 集合中移除。 選取是由 #select(Consumer)、 #select(Consumer,long)和 #selectNow(Consumer) 方法執行，並包含三個步驟：
<老>
<李>
取消金鑰集中的每個索引鍵都會從其所屬的每個索引鍵集中移除，而且其通道會取消註冊。 此步驟會將已取消的金鑰集保留空白。
</李>
<李>
基礎操作系統會針對每個剩餘通道的整備程度進行查詢，以執行其密鑰興趣集所識別的任何作業，從選取作業開始的那一刻開始。
針對已備妥至少一個這類作業的通道，通道密鑰的就緒作業集會設定為確切識別通道就緒的作業，並叫用指定給 方法的動作select來取用通道的密鑰。 在叫 用動作之前，會捨棄先前在就緒集合中記錄的任何整備資訊。
或者，如果通道已準備好進行一個以上的作業， 可以使用通道的索引鍵和就緒作業集，多次叫用動作 ，並將其修改為通道就緒的作業子集。 當動作針對相同的索引鍵多次叫用時，其就緒作業集絕不會包含先前在相同選取作業中呼叫動作時包含在集合中的作業位。
</李>
<李>
如果在步驟 （2） 進行時，已將任何密鑰新增至已取消的密鑰集合，則會將其處理為步驟 （1）。
</李>
</老>
<h2>並行</h2>
選取器及其金鑰集可供多個並行線程使用。 不過，其選取的索引鍵集和已取消的金鑰集不是。
選取作業會依該順序，同步於選取器本身的選取鍵集上。 它們也會在上述步驟 （1） 和 （3） 期間同步處理已取消的金鑰集。
在選取作業進行時，對選取器索引鍵的興趣集所做的變更不會影響該作業;下一個選取作業將會看到它們。
密鑰可能會取消，而且通道可以隨時關閉。 因此，一或多個選取器索引鍵集中的索引鍵是否存在，並不表示索引鍵有效或其通道已開啟。 如果有任何可能讓另一個線程取消索引鍵或關閉通道，請小心同步處理和檢查這些條件。
選取作業中封鎖的線程可能會以下列三種方式之一被其他線程中斷：
<ul>
<李>
藉由叫用選取器的 #wakeup wakeup 方法，
</李>
<李>
藉由叫用選取器的 #close close 方法，或
</李>
<李>
藉由叫用封鎖線程的 java.lang.Thread#interrupt() interrupt 方法，在此情況下會設定其中斷狀態，並叫用選取器 #wakeup wakeup 的方法。
</李>
</ul>
方法 #close close 會以與選取作業相同的順序，同步處理選取器及其選取的索引鍵集。
“ksc”>
選取器的金鑰集是安全的，可供多個並行線程使用。 從金鑰集擷取作業通常不會封鎖，因此可能會與新增至集合的新註冊重疊，或與從集合中移除密鑰的選取作業取消步驟重疊。 反覆運算器和分割器會傳回元素，反映在某個時間點或建立反覆運算器/分割器之後所設定的狀態。 它們不會擲回 java.util.ConcurrentModificationException ConcurrentModificationException。
“sksc”>
選取器選取的索引鍵集通常不是供多個並行線程使用的安全。 如果這類線程可能會直接修改集合，則應該藉由同步處理集本身來控制存取權。 集合方法所傳回的 java.util.Set#iterator() iterator 反覆運算器是 失敗的： 如果在建立反覆運算器之後修改集合，則除非叫用反覆運算器自己的 java.util.Iterator#remove() remove 方法，否則 java.util.ConcurrentModificationException 將會擲回 。
已在1.4中新增。
的 java.nio.channels.SelectorJava 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
建構函式
| Selector() |
初始化這個類別的新執行個體。 |
| Selector(IntPtr, JniHandleOwnership) |
建立 JNI 物件的 Managed 表示法時使用的建構函式;由運行時間呼叫。 |
屬性
| Class |
傳回這個 |
| Handle |
基礎Android實例的句柄。 (繼承來源 Object) |
| IsOpen |
指出這個選取器是否開啟。 |
| JniIdentityHashCode |
物件的多任務器 |
| JniPeerMembers |
物件的多任務器 |
| PeerReference |
物件的多任務器 |
| ThresholdClass |
此 API 支援適用於 Android 的 Mono 基礎結構，並不適合直接從您的程式代碼使用。 |
| ThresholdType |
此 API 支援適用於 Android 的 Mono 基礎結構，並不適合直接從您的程式代碼使用。 |
方法
| Clone() |
建立並傳回這個 對象的複本。 (繼承來源 Object) |
| Close() |
關閉此選取器。 |
| Dispose() |
物件的多任務器 |
| Dispose(Boolean) |
物件的多任務器 |
| Equals(Object) |
指出其他物件是否「等於」這個物件。 (繼承來源 Object) |
| GetHashCode() |
傳回此物件的雜湊碼值。 (繼承來源 Object) |
| JavaFinalize() |
當垃圾收集決定不再參考物件時，垃圾收集行程在 物件上呼叫。 (繼承來源 Object) |
| Keys() |
傳回此選取器的索引鍵集。 |
| Notify() |
喚醒正在等候此物件監視器的單一線程。 (繼承來源 Object) |
| NotifyAll() |
喚醒正在等候此物件監視器的所有線程。 (繼承來源 Object) |
| Open() |
開啟選取器。 |
| Provider() |
傳回建立這個通道的提供者。 |
| Select() |
選取一組金鑰，其對應的通道已準備好進行 I/O 作業。 |
| Select(IConsumer) |
選取並針對對應的通道已準備好進行 I/O 作業的金鑰執行動作。 |
| Select(IConsumer, Int64) |
選取並針對對應的通道已準備好進行 I/O 作業的金鑰執行動作。 |
| Select(Int64) |
選取一組金鑰，其對應的通道已準備好進行 I/O 作業。 |
| SelectedKeys() |
傳回此選取器選取的索引鍵集。 |
| SelectNow() |
選取一組金鑰，其對應的通道已準備好進行 I/O 作業。 |
| SelectNow(IConsumer) |
選取並針對對應的通道已準備好進行 I/O 作業的金鑰執行動作。 |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| ToArray<T>() |
物件的多任務器 |
| ToString() |
傳回物件的字串表示。 (繼承來源 Object) |
| UnregisterFromRuntime() |
物件的多任務器 |
| Wait() |
讓目前線程等候直到喚醒為止，通常是藉由em <notified/em>或<em>interrupted</em> 來喚醒它。<> (繼承來源 Object) |
| Wait(Int64) |
讓目前的線程等到喚醒為止，通常是因為 <em>notified</em> 或 <em>interrupted</em>，或直到經過一定數量的實時為止。 (繼承來源 Object) |
| Wait(Int64, Int32) |
讓目前的線程等到喚醒為止，通常是因為 <em>notified</em> 或 <em>interrupted</em>，或直到經過一定數量的實時為止。 (繼承來源 Object) |
| Wakeup() |
導致尚未傳回的第一個選取作業立即傳回。 |
明確介面實作
| IJavaPeerable.Disposed() |
物件的多任務器 |
| IJavaPeerable.DisposeUnlessReferenced() |
物件的多任務器 |
| IJavaPeerable.Finalized() |
物件的多任務器 |
| IJavaPeerable.JniManagedPeerState |
物件的多任務器 |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
物件的多任務器 |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
物件的多任務器 |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
物件的多任務器 |
擴充方法
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時間檢查的類型轉換。 |
| JavaCast<TResult>(IJavaObject) |
物件的多任務器 |
| GetJniTypeName(IJavaPeerable) |
物件的多任務器 |