documentation flash xmlsocket

Vous êtes ici: Les articles techniques » documentation » Eléments du langage ActionScript » XMLSocket

XMLSocket

Object
     |
     +-XMLSocket
 
public class **XMLSocket**
extends Object

La classe XMLSocket implémente les sockets client qui laissent l’ordinateur exécuter une communication Flash Player avec un ordinateur serveur identifié par une adresse IP ou un nom de domaine. La classe XMLSocket est utile pour les applications client-serveur qui requièrent un court délai, telles que des systèmes de dialogue en ligne en temps réel. Une solution de dialogue en ligne par HTTP interroge souvent le serveur et télécharge de nouveaux messages à l’aide d’une requête HTTP. Par contraste, une solution de dialogue en ligne XMLSocket maintient une connexion ouverte au serveur, qui laisse le serveur envoyer immédiatement des messages entrants sans requête du client. Pour utiliser la classe XMLSocket, l’ordinateur serveur doit exécuter un démon qui comprend le protocole utilisé par la classe XMLSocket. Le protocole est décrit dans la liste suivante :

  • Les messages XML sont envoyés via une connexion socket à flux TCP/IP bidirectionnel simultané.
  • Chaque message XML est un document XML complet, terminé par un octet zéro (0).
  • Un nombre illimité de messages XML peut être envoyé et reçu via une connexion XMLSocket.

Les restrictions suivantes s’appliquent au mode et à l’emplacement de connexion d’un objet XMLSocket :

  • La méthode XMLSocket.connect() permet une connexion uniquement à des numéros de port TCP supérieurs ou égaux à 1024. Une conséquence de cette restriction est que les démons du serveur qui communiquent avec l’objet XMLSocket doivent également être attribués aux numéros de port supérieurs ou égaux à 1024. Les numéros de port inférieurs à 1024 sont souvent utilisés par des services système tels que FTP, Telnet, et HTTP, les objets XMLSocket sont donc interdits au niveau de ces ports pour des raisons de sécurité. La restriction du numéro de port limite la possibilité d’accès à ces ressources et leur mauvaise utilisation.
  • La méthode XMLSocket.connect() permet une connexion uniquement aux ordinateurs se trouvant dans le domaine de résidence du fichier SWF. Cette restriction ne s’applique pas aux fichiers SWF s’exécutant en local. (Cette restriction est identique aux règles de sécurité pour loadVariables(), XML.sendAndLoad() et XML.load().) Pour se connecter à un démon de serveur s’exécutant dans un domaine différent du domaine de résidence du SWF, vous pouvez créer un fichier de régulation de sécurité sur le serveur qui permette d’accéder à partir de domaines spécifiques.

La configuration d’un serveur en vue de la communication avec un objet XMLSocket peut être difficile à réaliser. Si votre application ne requiert pas d’interactivité en temps réel, utilisez la fonction loadVariables(), ou la connectivité serveur XML basée sur HTTP Flash (XML.load(), XML.sendAndLoad(), XML.send()), à la place de la classe XMLSocket. Pour utiliser les méthodes de la classe XMLSocket, vous devez d’abord utiliser le constructeur, new XMLSocket, pour créer un objet XMLSocket.

Disponibilité : ActionScript 1.0 ; Flash Player 5

Voir également

Résumé des propriétés

Propriétés héritées de la classe Object

Résumé des événements

Evénement Description
onClose = function() {} Appelé uniquement lorsqu’une connexion ouverte est fermée par le serveur.
onConnect = function(success:Boolean) {} Appelé par Flash Player lorsqu’une requête de connexion lancée via XMLSocket.connect() a un résultat ou non.
onData = function(src:String) {} Appelé lorsqu’un message a été téléchargé à partir du serveur, terminé par un octet zéro (0).
onXML = function(src:XML) {} Appelé par Flash Player lorsque l’objet XML spécifié contenant un document XML arrive sur une connexion XMLSocket ouverte.

Récapitulatif des constructeurs

Signature Description
XMLSocket() Crée un objet XMLSocket.

Résumé de la méthode

Modificateurs Signature Description
close() : Void Ferme la connexion spécifiée par l’objet XMLSocket.
connect(url:String, port:Number) : Boolean Etablit une connexion avec l’hôte Internet spécifié à l’aide du port TCP spécifié (doit être de 1024 ou plus), et renvoie true ou false,, en fonction de la connexion établie ou non.
send(data:Object) : Void Convertit l’objet ou les données XML spécifiés dans le paramètre object en une chaîne et la transmet au serveur, suivie d’un octet zéro (0).

Méthodes héritées de la classe Object




veille
inscrits inscrits ! Compensation à la rédaction
  • Inscription au wiki
  • Connexion

vod