SelectionKey Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Jeton représentant l’inscription d’un SelectableChannel avec un Selector.
[Android.Runtime.Register("java/nio/channels/SelectionKey", DoNotGenerateAcw=true)]
public abstract class SelectionKey : Java.Lang.Object[<Android.Runtime.Register("java/nio/channels/SelectionKey", DoNotGenerateAcw=true)>]
type SelectionKey = class
inherit Object- Héritage
- Dérivé
- Attributs
Remarques
Jeton représentant l’inscription d’un SelectableChannel avec un Selector.
Une clé de sélection est créée chaque fois qu’un canal est inscrit auprès d’un sélecteur. Une clé reste valide jusqu’à ce qu’elle soit annulée en appelant sa #cancel cancel méthode, en fermant son canal ou en fermant son sélecteur. L’annulation d’une clé ne le supprime pas immédiatement de son sélecteur ; il est ajouté à la place au jeu de clés< annulé/i> du sélecteur <>pour la suppression pendant l’opération de sélection suivante. La validité d’une clé peut être testée en appelant sa #isValid isValid méthode.
« opsets »>
Une clé de sélection contient deux jeux d’opérations représentés sous forme de valeurs entières. Chaque bit d’un jeu d’opérations désigne une catégorie d’opérations sélectionnables prises en charge par le canal de la clé.
<ul>
<li>
L’ensemble d’intérêts détermine quelles catégories d’opérations seront testées pour la préparation la prochaine fois que l’une des méthodes de sélection du sélecteur est appelée. L’ensemble d’intérêts est initialisé avec la valeur donnée lors de la création de la clé ; elle peut être modifiée ultérieurement par le biais de la #interestOps(int) méthode.
</li>
<li>
Le jeu prêt identifie les catégories d’opérations pour lesquelles le canal de la clé a été détecté pour être prêt par le sélecteur de la clé. Le jeu prêt est initialisé sur zéro lors de la création de la clé ; il peut être mis à jour ultérieurement par le sélecteur pendant une opération de sélection, mais il ne peut pas être mis à jour directement.
</li>
</ul>
Que l’ensemble prêt d’une clé de sélection indique que son canal est prêt pour une catégorie d’opération est un indicateur, mais pas une garantie, qu’une opération dans une telle catégorie peut être effectuée par un thread sans provoquer le blocage du thread. Un ensemble prêt est probablement précis immédiatement après la fin d’une opération de sélection. Il est probable qu’il soit incorrect par les événements externes et par les opérations d’E/S qui sont appelées sur le canal correspondant.
Cette classe définit tous les bits de jeu d’opérations connus, mais précisément quels bits sont pris en charge par un canal donné dépend du type du canal. Chaque sous-classe de SelectableChannel définit une SelectableChannel#validOps() validOps() méthode qui retourne un jeu identifiant uniquement les opérations prises en charge par le canal. Une tentative de définition ou de test d’un bit de jeu d’opérations qui n’est pas pris en charge par le canal d’une clé entraîne une exception d’exécution appropriée.
Il est souvent nécessaire d’associer certaines données spécifiques à l’application à une clé de sélection, par exemple un objet qui représente l’état d’un protocole de niveau supérieur et gère les notifications de préparation afin d’implémenter ce protocole. Les clés de sélection prennent donc en charge la pièce jointe d’un objet arbitraire unique à une clé. Un objet peut être attaché via la #attach attach méthode, puis récupéré ultérieurement via la #attachment() attachment méthode.
Les clés de sélection sont sécurisées pour une utilisation par plusieurs threads simultanés. Une opération de sélection utilise toujours la valeur définie par intérêt qui était en cours au moment où l’opération a commencé.
Ajouté dans la version 1.4.
Documentation Java pour java.nio.channels.SelectionKey.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.
Constructeurs
| Nom | Description |
|---|---|
| SelectionKey() |
Construit une instance de cette classe. |
| SelectionKey(IntPtr, JniHandleOwnership) |
Constructeur utilisé lors de la création de représentations managées d’objets JNI ; appelée par le runtime. |
Champs
| Nom | Description |
|---|---|
| OpAccept |
Obsolète.
Bit de jeu d’opérations pour les opérations d’acceptation de socket. |
| OpConnect |
Obsolète.
Bit de jeu d’opérations pour les opérations de connexion de socket. |
| OpRead |
Obsolète.
Bit de jeu d’opérations pour les opérations de lecture. |
| OpWrite |
Obsolète.
Bit de jeu d’opérations pour les opérations d’écriture. |
Propriétés
| Nom | Description |
|---|---|
| Class |
Retourne la classe runtime de ce |
| Handle |
Handle de l’instance Android sous-jacente. (Hérité de Object) |
| IsAcceptable |
Teste si le canal de cette clé est prêt à accepter une nouvelle connexion de socket. |
| IsConnectable |
Teste si le canal de cette clé a terminé ou échoué, son opération de connexion de socket. |
| IsReadable |
Teste si le canal de cette clé est prêt pour la lecture. |
| IsValid |
Indique si cette clé est valide. |
| IsWritable |
Teste si le canal de cette clé est prêt pour l’écriture. |
| JniIdentityHashCode |
Obtient le code de hachage d’identité affecté à cet homologue Java par le runtime d’interopérabilité. (Hérité de Object) |
| JniManagedPeerState |
Jeton représentant l’inscription d’un |
| JniPeerMembers |
Jeton représentant l’inscription d’un |
| PeerReference |
Obtient la référence d’objet JNI pour cet homologue Java. (Hérité de Object) |
| ThresholdClass |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. |
| ThresholdType |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. |
Méthodes
| Nom | Description |
|---|---|
| Attach(Object) |
Attache l’objet donné à cette clé. |
| Attachment() |
Récupère la pièce jointe actuelle. |
| Cancel() |
Demande que l’inscription du canal de cette clé avec son sélecteur soit annulée. |
| Channel() |
Retourne le canal pour lequel cette clé a été créée. |
| Clone() |
Crée et retourne une copie de cet objet. (Hérité de Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Jeton représentant l’inscription d’un |
| Dispose() |
Libère les ressources détenues par cet homologue Java. (Hérité de Object) |
| Dispose(Boolean) |
Libère les ressources détenues par cet homologue Java. (Hérité de Object) |
| DisposeUnlessReferenced() |
Jeton représentant l’inscription d’un |
| Equals(Object) |
Jeton représentant l’inscription d’un |
| Equals(Object) |
Indique si un autre objet est « égal à » celui-ci. (Hérité de Object) |
| GetHashCode() |
Retourne une valeur de code de hachage pour l’objet. (Hérité de Object) |
| InterestOps() |
Récupère l’ensemble d’intérêts de cette clé. |
| InterestOps(Operations) |
Récupère l’ensemble d’intérêts de cette clé. |
| InterestOpsAnd(Int32) |
Définit atomiquement l’intérêt de cette clé sur l’intersection au niveau du bit (« et ») de l’ensemble d’intérêts existant et de la valeur donnée. |
| InterestOpsOr(Int32) |
Définit atomiquement l’intérêt de cette clé défini sur l’union au niveau du bit (« ou ») de l’ensemble d’intérêts existant et de la valeur donnée. |
| JavaFinalize() |
Appelé par le garbage collector sur un objet lorsque le garbage collection détermine qu’il n’y a plus de références à l’objet. (Hérité de Object) |
| Notify() |
Réveille un thread unique qui attend le moniteur de cet objet. (Hérité de Object) |
| NotifyAll() |
Réveille tous les threads qui attendent le moniteur de cet objet. (Hérité de Object) |
| ReadyOps() |
Récupère le jeu d’opérations prêts pour cette clé. |
| Selector() |
Retourne le sélecteur pour lequel cette clé a été créée. |
| SetHandle(IntPtr, JniHandleOwnership) |
Définit la propriété Handle. (Hérité de Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Jeton représentant l’inscription d’un |
| ToArray<T>() |
Crée un tableau managé à partir de ce wrapper de tableau Java. (Hérité de Object) |
| ToString() |
Retourne une représentation sous forme de chaîne de l’objet. (Hérité de Object) |
| UnregisterFromRuntime() |
Annule l’inscription de cet homologue Java à partir du runtime d’interopérabilité. (Hérité de Object) |
| Wait() |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti par em ou><em>interrompu</em>.<> (Hérité de Object) |
| Wait(Int64, Int32) |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object) |
| Wait(Int64) |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object) |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| IJavaPeerable.Disposed() |
Jeton représentant l’inscription d’un |
| IJavaPeerable.Finalized() |
Jeton représentant l’inscription d’un |
| IJavaPeerable.JniObjectReferenceControlBlock |
Jeton représentant l’inscription d’un |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Jeton représentant l’inscription d’un |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Jeton représentant l’inscription d’un |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Jeton représentant l’inscription d’un |
Méthodes d’extension
| Nom | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtient le nom JNI du type de l’instance |
| JavaAs<TResult>(IJavaPeerable) |
Essayez de forcer |
| JavaCast<TResult>(IJavaObject) |
Effectue une conversion de type vérifiée par le runtime Android. |
| JavaCast<TResult>(IJavaObject) |
Jeton représentant l’inscription d’un |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Essayez de forcer |