Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : Récupération des données du serveur...
Récupération des données du serveur...
mx.messaging.channels 

AMFChannel  - AS3 BlazeDS LCDS

Packagemx.messaging.channels
Classepublic class AMFChannel
HéritageAMFChannel Inheritance NetConnectionChannel Inheritance PollingChannel Inheritance Channel Inheritance EventDispatcher Inheritance Object
Sous-classes SecureAMFChannel, StreamingAMFChannel

Version du langage: ActionScript 3.0
Versions du produit: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

La classe AMFChannel fournit le support AMF pour l’échange de messages. Vous pouvez configurez ce canal pour qu’il interroge le serveur à un intervalle proche de celui utilisé pour l’envoi de données par le serveur. Vous pouvez aussi utiliser ce canal avec l’interrogation désactivée pour envoyer des messages RPC à des destinations distantes afin d’invoquer leurs méthodes.

La classe AMFChannel fait appel à des services de réseau natifs de Flash Player et AIR et exposés à la classe ActionScript par la classe NetConnection. Ce canal utilise la classe NetConnection exclusivement et crée une nouvelle classe NetConnection par instance.

Les canaux préconfigurés sont obtenus au sein de la structure à l’aide de la méthode ServerConfig.getChannel(). Les canaux peuvent être construits directement et assignés à une classe ChannelSet si nécessaire.

Les canaux représentent une connexion physique à une extrémité distante. Par défaut, les canaux sont partagés à travers les destinations. Cela signifie qu’un client ciblant différentes destinations peut utiliser le même canal pour communiquer avec ces destinations.

Lorsqu’utilisé en mode interrogation, ce canal interroge le serveur pour les nouveaux messages en fonction de la propriété polling-interval-seconds dans le fichier de configuration ; cela peut être changé en définissant la propriété pollingInterval. La valeur par défaut est de 3 secondes. Pour que l’interrogation soit activée, le canal doit être connecté et la propriété polling-enabled dans le fichier de configuration doit être définie sur true, ou la propriété pollingEnabled du canal doit être définie sur true.



Propriétés publiques
 PropriétéDéfini par
 Inheritedauthenticated : Boolean
[lecture seule] Indique si le canal est authentifié.
Channel
 InheritedchannelSets : Array
[lecture seule] Fournit un accès aux classes ChannelSet connectées à ce canal.
Channel
 Inheritedconnected : Boolean
[lecture seule] Indique si ce canal a établi une connexion à la destination distante.
Channel
 InheritedconnectTimeout : int
Fournit un accès au délai d’attente de connexion en secondes pour le canal.
Channel
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
 Inheritedendpoint : String
[lecture seule] Fournit un accès à l’extrémité de ce canal.
Channel
 InheritedfailoverURIs : Array
Fournit un accès au jeu d’URI d’extrémité vers lequel ce canal peut tenter de basculer si l’extrémité est clusterisée.
Channel
 Inheritedid : String
Fournit un accès à l’ID de ce canal.
Channel
 InheritednetConnection : NetConnection
[lecture seule] Fournit un accès à la classe NetConnection associée de ce canal.
NetConnectionChannel
  piggybackingEnabled : Boolean
Indique si ce canal transporte les demandes d’interrogation avec les messages sortants standard lorsqu’une interrogation en attente n’est pas en cours.
AMFChannel
  polling : Boolean
[lecture seule] Signale si le canal procède activement à une interrogation.
AMFChannel
  pollingEnabled : Boolean
Indique si ce canal est activé pour procéder à l’interrogation.
AMFChannel
  pollingInterval : Number
Fournit un accès à l’intervalle d’interrogation de ce canal.
AMFChannel
  protocol : String
[override] [lecture seule] Renvoie le protocole de ce canal (http).
AMFChannel
 Inheritedreconnecting : Boolean
[lecture seule] Indique si ce canal est en train de se reconnecter à une extrémité alternative.
Channel
 InheritedrecordMessageSizes : Boolean
[lecture seule] La propriété Channel détermine le niveau d’injection d’informations de performances - que nous injections des tailles de messages ou non.
Channel
 InheritedrecordMessageTimes : Boolean
[lecture seule] La propriété Channel détermine le niveau d’injection d’informations de performances - que nous injections des dates/heures ou non.
Channel
 InheritedrequestTimeout : int
Fournit un accès au délai d’attente de demande par défaut en secondes pour le canal.
Channel
 Inheriteduri : String
Fournit un accès à l’URI utilisée pour créer toute l’URI d’extrémité pour ce canal.
Channel
Propriétés protégées
 PropriétéDéfini par
 InheritedshouldBeConnected : Boolean
[lecture seule] Indique si ce canal doit être connecté à son extrémité.
Channel
Méthodes publiques
 MéthodeDéfini par
  
AMFChannel(id:String = null, uri:String = null)
Constructeur.
AMFChannel
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement.
EventDispatcher
 Inherited
Les sous-classes doivent remplacer cette méthode pour appliquer les paramètres susceptibles d’être nécessaires à un canal individuel.
Channel
 Inherited
connect(channelSet:ChannelSet):void
Connecte la classe ChannelSet au canal.
Channel
 Inherited
Désactive l’interrogation en fonction du nombre de fois que les méthodes enablePolling() et disablePolling() ont été invoquées.
PollingChannel
 Inherited
Déconnecte la classe ChannelSet du canal.
Channel
 Inherited
Distribue un événement dans le flux d’événements.
EventDispatcher
 Inherited
Active l’interrogation en fonction du nombre de fois que les méthodes enablePolling() et disablePolling() ont été invoquées.
PollingChannel
 Inherited
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.
EventDispatcher
 Inherited
Indique si la propriété spécifiée d’un objet est définie.
Object
 Inherited
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre.
Object
 Inherited
Envoie une classe CommandMessage au serveur pour se déconnecter si le canal est connecté.
Channel
 Inherited
Lance une opération d’interrogation si des classes Consumer sont décrites dans ce canal et que l’interrogation est activée pour ce canal.
PollingChannel
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Supprime un écouteur de l’objet EventDispatcher.
EventDispatcher
 Inherited
send(agent:MessageAgent, message:IMessage):void
[override] Envoie le message spécifié à sa destination cible.
PollingChannel
 Inherited
setCredentials(credentials:String, agent:MessageAgent = null, charset:String = null):void
Définit les informations d’identification sur la valeur spécifiée.
Channel
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
 Inherited
Renvoie la représentation sous forme de chaîne de l’objet spécifié.
Object
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
 Inherited
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié.
EventDispatcher
Méthodes protégées
 MéthodeDéfini par
 Inherited
Applique les URL d’équilibrage de charge client si elles existent.
Channel
 Inherited
Traite une connexion interne échouée et distribue l’événement FAULT pour le canal.
Channel
 Inherited
Traite une connexion interne réussie et distribue l’événement CONNECT pour le canal.
Channel
 Inherited
Gère un délai d’attente de connexion en distribuant une classe ChannelFaultEvent.
Channel
 Inherited
Traite une déconnexion interne échouée et distribue l’événement FAULT pour le canal.
Channel
 Inherited
disconnectSuccess(rejected:Boolean = false):void
Traite une déconnexion interne réussie et distribue l’événement DISCONNECT pour le canal.
Channel
 Inherited
Gère une modification de la condition de surveillance pour gérer la connexion de canal initiale pour l’application.
Channel
 Inherited
Renvoie la classe MessageResponder appropriée pour la méthode send() du canal.
Channel
 Inherited
Connecte le canal à son extrémité.
Channel
 Inherited
internalDisconnect(rejected:Boolean = false):void
Déconnecte le canal de son extrémité.
Channel
 Inherited
Envoie le message via le canal et achemine la réponse à la classe Responder.
Channel
Evénements
 Evénement Synthèse Défini par
 Inherited[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.EventDispatcher
 InheritedDistribué après que le canal se connecte à son extrémité.Channel
 InheritedDistribué après que le canal se déconnecte de son extrémité.Channel
 InheritedDistribué après une erreur du canal.Channel
 Inherited[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive.EventDispatcher
 InheritedDistribué lorsqu’un canal reçoit un message de son extrémité.Channel
 InheritedDistribué lorsqu’une propriété du canal change.Channel
Détails de la propriété

piggybackingEnabled

propriété
piggybackingEnabled:Boolean

Version du langage: ActionScript 3.0
Versions du produit: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Indique si ce canal transporte les demandes d’interrogation avec les messages sortants standard lorsqu’une interrogation en attente n’est pas en cours. Cela permet au serveur de transporter des données pour le client avec sa réponse au message du client.



Implémentation
    public function get piggybackingEnabled():Boolean
    public function set piggybackingEnabled(value:Boolean):void

polling

propriété 
polling:Boolean  [lecture seule]

Version du langage: ActionScript 3.0
Versions du produit: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Signale si le canal procède activement à une interrogation.



Implémentation
    public function get polling():Boolean

pollingEnabled

propriété 
pollingEnabled:Boolean

Version du langage: ActionScript 3.0
Versions du produit: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Indique si ce canal est activé pour procéder à l’interrogation.



Implémentation
    public function get pollingEnabled():Boolean
    public function set pollingEnabled(value:Boolean):void

pollingInterval

propriété 
pollingInterval:Number

Version du langage: ActionScript 3.0
Versions du produit: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Fournit un accès à l’intervalle d’interrogation de ce canal. La valeur est en millisecondes. Cette valeur détermine la fréquence à laquelle ce canal demande des messages du serveur, pour s’approcher de l’envoi de données par le serveur.



Implémentation
    public function get pollingInterval():Number
    public function set pollingInterval(value:Number):void

Valeur émise
ArgumentError — Si l’intervalle d’interrogation reçoit une valeur égale à 0 ou moins.

protocol

propriété 
protocol:String  [lecture seule] [override]

Version du langage: ActionScript 3.0
Versions du produit: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Renvoie le protocole de ce canal (http).



Implémentation
    override public function get protocol():String
Détails du constructeur

AMFChannel

()Constructeur
public function AMFChannel(id:String = null, uri:String = null)

Version du langage: ActionScript 3.0
Versions du produit: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Constructeur.

Paramètres
id:String (default = null) — ID de ce canal.
 
uri:String (default = null) — URI de ce canal.




[ X ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.