U-X > XMLSocket (objet)

XMLSocket (objet)

L'objet XMLSocket implémente les sockets client qui permettent à l'ordinateur de lancer Flash Player pour communiquer avec un ordinateur serveur identifié par une adresse IP ou un nom de domaine.

 
Utilisation de l'objet XMLSocket

Pour utiliser l'objet XMLSocket, le serveur doit exécuter un démon comprenant le protocole utilisé par l'objet XMLSocket. Le protocole est le suivant :

	Les messages XML sont envoyés sur une connexion socket TCP/IP continue en duplex intégral.
	Chaque message XML est un document XML complet, terminé par un octet zéro.
	Un nombre illimité de messages XML peut être envoyé et reçu sur une seule connexion XMLSocket.

L'objet XMLSocket est utile pour les applications client-serveur nécessitant un faible délai (par exemple, des systèmes de dialogue en ligne en temps réel). Une solution de dialogue en ligne traditionnelle basée sur HTTP interroge fréquemment le serveur et télécharge les nouveaux messages à l'aide d'une requête HTTP. A l'inverse, une solution de dialogue en ligne XMLSocket maintient une connexion ouverte avec le serveur, ce qui permet au serveur d'envoyer immédiatement les messages entrants sans que le client en fasse la requête.

Le paramétrage d'un serveur pour communiquer avec l'objet XMLSocket peut être un véritable défi. Si votre application ne nécessite pas une interactivité en temps réel, utilisez l'action loadVariables ou les connexions serveur XML basées sur HTTP de Flash (XML.load, XML.sendAndLoad, XML.send), à la place de l'objet XMLSocket.

Pour utiliser les méthodes de l'objet XMLSocket, vous devez d'abord utiliser le constructeur, new XMLSocket, pour créer un nouvel objet XMLSocket.

 
XMLSocket et la sécurité

L'objet XMLSocket établissant et maintenant une connexion ouverte avec le serveur, les restrictions suivantes ont été placées sur l'objet XMLSocket pour des raisons de sécurité :

La méthode XMLSocket.connect ne permet que la connexion aux numéros de port TCP supérieurs ou égaux à 1024. En conséquence de cette restriction, les démons qui communiquent avec l'objet XMLSocket doivent également être affectés à des 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 (par exemple, FTP, Telnet et HTTP), interdisant ainsi l'objet XMLSocket pour ces ports. La restriction du numéro de port limite les possibilités d'accès inappropriés et abusifs à ces ressources.

La méthode XMLSocket.connect ne peut se connecter qu'à des ordinateurs du même sous-domaine que celui où réside le fichier (l'animation) SWF. Cette restriction ne s'applique pas aux animations tournant sur un disque local. Cette restriction est identique aux règles de sécurité de loadVariables, XML.sendAndLoad et XML.load.

 
Méthodes de l'objet XMLSocket

Méthode	Description
XMLSocket.close	Ferme une connexion socket ouverte.
XMLSocket.connect	Etablit une connexion avec le serveur spécifié.
XMLSocket.send	Envoie un objet XML au serveur.

 
Gestionnaires d'événement de l'objet XMLSocket

Méthode	Description
XMLSocket.onClose	Une fonction de rappel invoquée lorsqu'une connexion XMLSocket est fermée.
XMLSocket.onConnect	Une fonction de rappel invoquée lorsqu'une connexion XMLSocket est établie.
XMLSocket.onData	Une fonction de rappel invoquée lorsqu'un message XML a été téléchargé du serveur.
XMLSocket.onXML	Une fonction de rappel invoquée lorsqu'un objet XML arrive du serveur.

 
Constructeur pour l'objet XMLSocket

Disponibilité

Flash Player 5.

Usage

new XMLSocket()

Paramètres

Aucun.

Renvoie

Rien.

Description

Constructeur ; crée un nouvel objet XMLSocket. L'objet XMLSocket n'est pas initialement connecté à un serveur. Vous devez appeler la méthode XMLSocket.connect pour connecter l'objet à un serveur.

Exemple

monSocketXML = new XMLSocket();

Voir aussi

XMLSocket.connect