XMLSocket  - AS3

Indique si l’objet XMLSocket est actuellement connecté. Vous pouvez également vérifier si la connexion a abouti en vous enregistrant pour les événements connect et ioError.

Eléments de l’API associés

Indique le délai d’attente d’une connexion, en millisecondes.

Si la connexion n’est pas établie pendant le délai spécifié, elle échoue. La valeur par défaut est de 20 000 (vingt secondes).

Crée un objet XMLSocket. En l’absence de paramètres, un socket initialement déconnecté est créé. Si des paramètres sont spécifiés, une tentative de connexion à l’hôte et au port indiqués est effectuée.

Remarque : il est fortement conseillé d’utiliser la forme du constructeur sans paramètre, d’ajouter ensuite des écouteurs d’événement éventuels, puis d’appeler la méthode connect avec les paramètres host et port. Cette séquence garantit que tous les écouteurs d’événement fonctionnent correctement.

Eléments de l’API associés

Ferme la connexion spécifiée par l’objet XMLSocket. L’événement close se produit uniquement lorsque le serveur ferme la connexion. Il n’est pas distribué lorsque vous appelez la méthode close().

Plus d’exemples

Eléments de l’API associés

Etablit une connexion à l’hôte Internet spécifié en utilisant le port TCP indiqué.

Si vous spécifiez null pour le paramètre host, l’hôte contacté est celui où réside le fichier appelant la méthode XMLSocket.connect(). Par exemple, si le fichier appelant a été téléchargé à partir du site www.adobe.com, le fait de spécifier null pour le paramètre host équivaut à se connecter à www.adobe.com.

Vous pouvez empêcher un fichier d’utiliser cette méthode en définissant le paramètre allowNetworking des balises object et embed dans la page HTML qui comporte le contenu SWF.

Pour plus d’informations, voir la rubrique du Pôle de développement Flash Player : Sécurité (disponible en anglais uniquement).

Paramètres

Plus d’exemples

Eléments de l’API associés

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 nul (0). Si object est un objet XML, la chaîne est la représentation textuelle XML de l’objet XML. L’opération d’envoi est asynchrone ; elle est immédiatement renvoyée, mais les données peuvent être transmises plus tard. La méthode XMLSocket.send() ne renvoie pas de valeur indiquant si les données ont bien été transmises.

Si vous ne connectez pas l’objet XMLSocket au serveur à l’aide de XMLSocket.connect(), l’opération XMLSocket.send() échoue.

Paramètres

Plus d’exemples

Eléments de l’API associés

Distribué lorsque le serveur ferme la connexion socket. L’événement close se produit uniquement lorsque le serveur ferme la connexion. Il n’est pas distribué lorsque vous appelez la méthode XMLSocket.close().

Les propriétés de cet événement sont les suivantes :

Distribué après un appel de la méthode XMLSocket.connect() qui a abouti.

Les propriétés de cet événement sont les suivantes :

Distribué après l’envoi ou la réception de données brutes.

Les propriétés de cet événement sont les suivantes :

Distribué lorsqu’il se produit une erreur d’entrée/sortie entraînant l’échec d’une opération d’envoi ou de réception.

Les propriétés de cet événement sont les suivantes :

Distribué si un appel de la méthode XMLSocket.connect() tente une connexion à un serveur situé hors du sandbox de sécurité de l’appelant ou à un port inférieur à 1024.

Les propriétés de cet événement sont les suivantes :

Eléments de l’API associés

1. Le constructeur XMLSocketExample crée une occurrence de XMLSocket nommée socket et transmet le socket à la méthode ConfigureListeners() (décrite ci-dessous), puis appelle la méthode connect() de XMLSocket avec le nom d’hôte « localhost » et le numéro de port 8080.
2. La méthode configureListeners() est ensuite appelée, ce qui ajoute des écouteurs à chacun des événements XMLSocket pris en charge :
   • closeHandler() : écoute l’événement close, qui est distribué après la fermeture de la connexion réseau.
   • connectHandler() : écoute l’événement connect, qui est distribué à l’ouverture de la connexion réseau.
   • dataHandler() : écoute l’événement data, qui est distribué chaque fois que le XMLSocket reçoit de nouvelles données.
   • progressHandler() : écoute l’événement progress, qui est distribué à chaque appel de la méthode send() et pendant l’envoi.
   • securityErrorHandler() : écoute l’événement securityError, qui est distribué en cas de tentative d’accès au XMLSocket avec un paramètre de sécurité de lecture locale incorrect ou avec un numéro de port inférieur à 1024.
   • ioErrorHandler() : écoute l’événement ioError, qui se produit uniquement en cas d’échec d’une opération d’envoi ou de réception de données.

Remarques :

• Vous devrez compiler le fichier SWF en définissant « Sécurité de lecture locale » sur « Accès au réseau uniquement ».
• Pour que cet exemple fonctionne, vous devez disposer d’un serveur s’exécutant sur votre domaine à l’aide du port 8080.
• Si vous exécutez Flash Player 9.0.124.0 ou une version ultérieure, vous devez placer sur votre serveur un fichier de régulation de socket autorisant les connexions de socket de votre domaine au port 8080. Pour plus d’informations sur la fourniture de fichiers de régulation de socket, voir la rubrique : Configuration d’un serveur de fichier de régulation de socket du Centre des développeurs de Flash Player.

package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.XMLSocket;

    public class XMLSocketExample extends Sprite {
        private var hostName:String = "localhost";
        private var port:uint = 8080;
        private var socket:XMLSocket;

        public function XMLSocketExample() {
            socket = new XMLSocket();
            configureListeners(socket);
            if (hostName && port) {
                socket.connect(hostName, port);
            }
        }

        public function send(data:Object):void {
            socket.send(data);
        }

        private function configureListeners(dispatcher:IEventDispatcher):void {
            dispatcher.addEventListener(Event.CLOSE, closeHandler);
            dispatcher.addEventListener(Event.CONNECT, connectHandler);
            dispatcher.addEventListener(DataEvent.DATA, dataHandler);
            dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
        }

        private function closeHandler(event:Event):void {
            trace("closeHandler: " + event);
        }

        private function connectHandler(event:Event):void {
            trace("connectHandler: " + event);
        }

        private function dataHandler(event:DataEvent):void {
            trace("dataHandler: " + event);
        }

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }

        private function progressHandler(event:ProgressEvent):void {
            trace("progressHandler loaded:" + event.bytesLoaded + " total: " + event.bytesTotal);
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }
    }
}