Socket  - AS3

Nombre d’octets de données disponibles en lecture dans la mémoire tampon d’entrée.

Votre code doit accéder à bytesAvailable pour garantir que les données disponibles sont suffisantes, avant leur lecture à l’aide d’une des méthodes read.

Indique le nombre d’octets restants dans la mémoire tampon d’écriture.

Utilisez cette propriété en combinaison avec l’événement OutputProgressEvent. Un événement OutputProgressEvent est distribué dès que des données sont écrites de la mémoire tampon d’écriture vers le réseau. Dans le gestionnaire d’événement, vous pouvez vérifier la propriété bytesPending pour savoir combien de données il reste à écrire dans la mémoire tampon. Lorsque bytesPending renvoie 0, cela signifie que toutes les données ont été transférées de la mémoire tampon d’écriture au réseau, et que certaines opérations telles que la suppression de gestionnaires d’événement, l’annulation des références au socket ou le démarrage du téléchargement suivant dans la file d’attente peuvent être effectuées en toute sécurité.

Eléments de l’API associés

Indique si l’objet Socket est actuellement connecté. Un appel de cette propriété renvoie la valeur true si le socket est connecté, false dans le cas contraire.

Indique l’ordre d’octet des données. Les valeurs possibles sont les constantes de la classe flash.utils.Endian, Endian.BIG_ENDIAN ou Endian.LITTLE_ENDIAN.

La valeur par défaut est Endian.BIG_ENDIAN.

Eléments de l’API associés

Adresse IP à laquelle ce socket est lié sur la machine locale.

Eléments de l’API associés

Port auquel ce socket est lié sur la machine locale.

Eléments de l’API associés

Contrôle la version du format AMF utilisée lors de l’écriture ou de la lecture d’un objet.

Eléments de l’API associés

Adresse IP de la machine distante à laquelle ce socket est connecté.

Vous pouvez utiliser cette propriété pour déterminer l’adresse IP d’un socket client distribué dans un ServerSocketConnectEvent par un objet ServerSocket. Si vous le souhaitez, utilisez la classe DNSResolver pour convertir une adresse IP en un nom de domaine.

Eléments de l’API associés

Port de la machine distante auquel ce socket est connecté.

Vous pouvez utiliser cette propriété pour déterminer le numéro de port d’un socket client distribué dans un ServerSocketConnectEvent par un objet ServerSocket.

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 nouvel objet Socket. 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.

Ferme le socket. Après l’appel de la méthode close(), toute lecture ou écriture de données est impossible.

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().

Vous pouvez réutiliser l’objet Socket en lui appliquant à nouveau la méthode connect().

Connecte le socket à l’hôte et au port spécifiés.

Si la connexion échoue immédiatement, un événement est distribué ou une exception est émise : un événement d’erreur est distribué si un hôte a été spécifié, et une exception est émise dans le cas contraire. Dans tous les autres cas, l’état de la connexion est signalé par un événement. Si le socket est déjà connecté, la connexion existante est d’abord fermée.

Paramètres

Plus d’exemples

Efface les données accumulées dans la mémoire tampon de sortie du socket.

Sur certaines systèmes d’exploitation, la méthode flush() est appelée automatiquement entre les images d’exécution. Sur d’autres, notamment sur Windows, les données ne sont jamais envoyées, à moins que vous n’appeliez explicitement la méthode flush(). Pour assurer la fiabilité de votre application sur tous les systèmes d’exploitation, il est judicieux d’appeler la méthode flush() après l’écriture de chaque message (ou du groupe de données associé) sur le socket.

Lit une valeur booléenne dans le socket. Après la lecture d’un seul octet, la méthode renvoie true si l’octet est non nul, false dans le cas contraire.

Lit un octet signé dans le socket.

Lit dans le socket le nombre d’octets de données spécifié par le paramètre length. Les octets sont lus dans le tableau d’octets spécifié, en partant de la position indiquée par offset.

Paramètres

Lit dans le socket un nombre à virgule flottante à deux décimales et conforme à IEEE 754.

Lit dans le socket un nombre à virgule flottante à une décimale et conforme à IEEE 754.

Lit un entier de 32 bits signé dans le socket.

Lit une chaîne multi-octets dans le flux d’octets, en utilisant le jeu de caractères spécifié.

Paramètres

Lit dans le socket un objet codé au format AMF (Action Message Format) sérialisé.

Eléments de l’API associés

Lit un entier de 16 bits signé dans le socket.

Lit un octet non signé dans le socket.

Lit un entier de 32 bits non signé dans le socket.

Lit un entier de 16 bits non signé dans le socket.

Lit une chaîne UTF-8 dans le socket. La chaîne est supposée comporter un préfixe composé d’un entier court non signé indiquant sa longueur en octets.

Lit dans le socket le nombre d’octets de données UTF-8 spécifié par le paramètre length et renvoie une chaîne.

Paramètres

Ecrit une valeur booléenne dans le socket. Cette méthode écrit un seul octet, dont la valeur correspond à 1 (true) ou à 0 (false).

Paramètres

Eléments de l’API associés

Ecrit un octet dans le socket.

Paramètres

Eléments de l’API associés

Ecrit une séquence d’octets extraits du tableau d’octets spécifié. L’écriture commence à la position indiquée par offset.

Si vous omettez le paramètre length, la valeur par défaut, 0, est utilisée et la méthode écrit l’intégralité de la mémoire tampon, en commençant à offset.

Si vous omettez aussi le paramètre offset, toute la mémoire tampon est écrite.

Paramètres

Eléments de l’API associés

Ecrit dans le socket un nombre à virgule flottante à deux décimales et conforme à IEEE 754.

Paramètres

Eléments de l’API associés

Ecrit dans le socket un nombre à virgule flottante à une décimale conforme à IEEE 754.

Paramètres

Eléments de l’API associés

Ecrit un entier signé de 32 bits dans le socket.

Paramètres

Eléments de l’API associés

Ecrit une chaîne multi-octets extraite du flux d’octets, en utilisant le jeu de caractères spécifié.

Paramètres

Eléments de l’API associés

Ecrit un objet dans le socket au format AMF sérialisé.

Paramètres

Eléments de l’API associés

Ecrit un entier 16 bits dans le socket. Les octets écrits se présentent comme suit :

(v >> 8) & 0xff v & 0xff

Les 16 bits inférieurs du paramètre sont utilisés. Les 16 bits supérieurs ne sont pas pris en compte.

Paramètres

Eléments de l’API associés

Ecrit un entier non signé de 32 bits dans le socket.

Paramètres

Eléments de l’API associés

Ecrit les données suivantes dans le socket : un entier non signé de 16 bits, qui indique, en octets, la longueur de la chaîne UTF-8 spécifiée, suivie de la chaîne elle-même.

Avant d’écrire la chaîne, la méthode calcule le nombre d’octets nécessaires pour représenter tous les caractères requis.

Paramètres

Eléments de l’API associés

Ecrit une chaîne UTF-8 dans le socket.

Paramètres

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 Socket.close().

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

Distribué lorsqu’une connexion réseau est établie.

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’un envoi ou d’un chargement.

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

Distribué lorsqu’un socket déplace des données de son tampon d’écriture vers la couche de transport de la mise en réseau

Distribué si un appel de la méthode Socket.connect() tente d’établir une connexion à un serveur interdit par le sandbox de sécurité de l’appelant ou à un port inférieur à 1024, et qu’il n’existe aucun fichier de régulation de socket pour autoriser ce type de connexion.

Remarque : dans une application AIR, le contenu s’exécutant dans le sandbox de sécurité de l’application est autorisé à se connecter à un serveur et à un numéro de port sans un fichier de régulation de socket.

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

Eléments de l’API associés

Distribué lorsqu’un socket a reçu des données.

Les données reçues par le socket restent dans le socket jusqu’à leur lecture. Il n’est pas nécessaire de lire toutes les données disponibles pendant la gestion de cet événement.

Les événements de type socketData n’utilisent pas la propriété ProgressEvent.bytesTotal.

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

1. Le constructeur crée une occurrence de CustomSocket nommée socket et transmet le nom d’hôte localhost et le port 80 comme arguments. CustomSocket étendant Socket, un appel à la méthode super() invoque un constructeur de Socket.
2. Cet exemple appelle ensuite la méthode configureListeners(), qui ajoute des écouteurs pour les événements de Socket.
3. Enfin, la méthode de socket connect() est appelée avec localhost comme nom d’hôte et 80 comme numéro de port.

Remarque : pour exécuter l’exemple, vous avez besoin d’un serveur s’exécutant dans le domaine où réside le fichier SWF (dans l’exemple, localhost) et d’une écoute du port 80.

package {
    import flash.display.Sprite;

    public class SocketExample extends Sprite {
        private var socket:CustomSocket;
        
        public function SocketExample() {
            socket = new CustomSocket("localhost", 80);
        }
    }
}

import flash.errors.*;
import flash.events.*;
import flash.net.Socket;

class CustomSocket extends Socket {
    private var response:String;

    public function CustomSocket(host:String = null, port:uint = 0) {
        super();
        configureListeners();
        if (host && port)  {
            super.connect(host, port);
        }
    }

    private function configureListeners():void {
        addEventListener(Event.CLOSE, closeHandler);
        addEventListener(Event.CONNECT, connectHandler);
        addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
        addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
        addEventListener(ProgressEvent.SOCKET_DATA, socketDataHandler);
    }

    private function writeln(str:String):void {
        str += "\n";
        try {
            writeUTFBytes(str);
        }
        catch(e:IOError) {
            trace(e);
        }
    }

    private function sendRequest():void {
        trace("sendRequest");
        response = "";
        writeln("GET /");
        flush();
    }

    private function readResponse():void {
        var str:String = readUTFBytes(bytesAvailable);
        response += str;
    }

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

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

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

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

    private function socketDataHandler(event:ProgressEvent):void {
        trace("socketDataHandler: " + event);
        readResponse();
    }
}