Sockets

Le fichier principal TelnetSocket.mxml se charge de créer l’interface utilisateur (IU) de l’application entière.

Outre l’IU, ce fichier définit deux méthodes, login() et sendCommand() , qui permettent la connexion de l’utilisateur au serveur spécifié.

L’exemple suivant répertorie le code ActionScript du fichier d’application principal :

import com.example.programmingas3.socket.Telnet; 
 
private var telnetClient:Telnet; 
private function connect():void 
{ 
    telnetClient = new Telnet(serverName.text, int(portNumber.text), output); 
    console.title = "Connecting to " + serverName.text + ":" + portNumber.text; 
    console.enabled = true; 
} 
private function sendCommand():void 
{ 
    var ba:ByteArray = new ByteArray(); 
    ba.writeMultiByte(command.text + "\n", "UTF-8"); 
    telnetClient.writeBytesToSocket(ba); 
    command.text = ""; 
}

La première ligne de code importe la classe Telnet à partir du package personnalisé com.example.programmingas.socket. La deuxième ligne de code déclare une occurrence de la classe Telnet, telnetClient , qui est initialisée ultérieurement par la méthode connect() . Ensuite, la méthode connect() est déclarée et initialise la variable telnetClient déclarée auparavant. Cette méthode transmet le nom du serveur Telnet spécifié par l’utilisateur, le port de ce serveur et une référence à un composant TextArea dans la liste d’affichage, qui sert à afficher les réponses textuelles reçues du serveur socket. Les deux dernières lignes de la méthode connect() définissent la propriété title du composant Panel et active celui-ci, ce qui permet à l’utilisateur d’envoyer les données au serveur distant. La méthode finale du fichier d’application principal, sendCommand() , permet d’envoyer les commandes de l’utilisateur au serveur distant sous forme d’objet ByteArray.

La classe Telnet se charge d’établir la connexion au serveur distant Telnet et d’envoyer et de recevoir les données.

La classe Telnet déclare les variables privées suivantes :

private var serverURL:String; 
private var portNumber:int; 
private var socket:Socket; 
private var ta:TextArea; 
private var state:int = 0;

La première variable, serverURL , contient l’adresse du serveur auquel se connecter, spécifiée par l’utilisateur.

La deuxième variable, portNumber , correspond au numéro de port sur lequel le serveur Telnet s’exécute actuellement. Par défaut, le service Telnet utilise le port 23.

La troisième variable, socket , est une occurrence de Socket qui tente d’établir une connexion au serveur défini par les variables serverURL et portNumber .

La quatrième variable, ta , est une référence à l’occurrence du composant TextArea sur la scène. Ce composant sert à afficher les réponses provenant du serveur Telnet distant ou les éventuels messages d’erreur.

La dernière variable, state , est une valeur numérique utilisée pour déterminer les options prises en charge par le client Telnet.

Comme vous l’avez vu précédemment, la fonction constructeur de la classe Telnet est appelée par la méthode connect() dans le fichier d’application principal.

Le constructeur Telnet prend trois paramètres : server , port et output . Les paramètres server et port spécifient le nom et le numéro de port du serveur Telnet. Le dernier paramètre, output , est une référence à une occurrence du composant TextArea sur la scène où s’affichent les résultats du serveur à l’intention de l’utilisateur.

public function Telnet(server:String, port:int, output:TextArea) 
{ 
    serverURL = server; 
    portNumber = port; 
    ta = output; 
    socket = new Socket(); 
    socket.addEventListener(Event.CONNECT, connectHandler); 
    socket.addEventListener(Event.CLOSE, closeHandler); 
    socket.addEventListener(ErrorEvent.ERROR, errorHandler); 
    socket.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler); 
    socket.addEventListener(ProgressEvent.SOCKET_DATA, dataHandler); 
    Security.loadPolicyFile("http://" + serverURL + "/crossdomain.xml"); 
    try 
    { 
        msg("Trying to connect to " + serverURL + ":" + portNumber + "\n"); 
        socket.connect(serverURL, portNumber); 
    } 
    catch (error:Error) 
    { 
        msg(error.message + "\n"); 
        socket.close(); 
    } 
}

Pour écrire des données sur une connexion socket, vous appelez l’une des méthodes d’écriture de la classe Socket. Parmi ces méthodes d’écriture figurent writeBoolean() , writeByte() , writeBytes() , writeDouble() , etc. Purgez ensuite les données dans le tampon de sortie par le biais de la méthode flush() . Sur le serveur Telnet, les données sont écrites sur la connexion Socket à l’aide de la méthode writeBytes() , qui prend comme paramètre le tableau d’octets et l’envoie au tampon de sortie. La méthode writeBytesToSocket() se présente comme suit :

public function writeBytesToSocket(ba:ByteArray):void 
{ 
    socket.writeBytes(ba); 
    socket.flush(); 
}

Cette méthode est appelée par la méthode sendCommand() du fichier d’application principal.

Dès qu’un message est reçu du serveur socket ou qu’un événement se produit, la méthode personnalisée msg() est appelée. Cette méthode ajoute une chaîne au composant TextArea sur la scène et appelle une méthode setScroll() personnalisée, qui provoque le défilement vers le bas du composant TextArea. La méthode msg() se présente comme suit :

private function msg(value:String):void 
{ 
    ta.text += value; 
    setScroll(); 
}

Si vous n’appliquez pas le défilement automatique au contenu du composant TextArea, les utilisateurs auront à le faire manuellement pour consulter la dernière réponse du serveur.

La méthode setScroll() contient une seule ligne de code ActionScript qui permet de faire défiler verticalement le contenu du composant TextArea de manière que l’utilisateur puisse voir la dernière ligne de texte renvoyé. L’extrait de code suivant illustre la méthode setScroll() :

public function setScroll():void 
{ 
    ta.verticalScrollPosition = ta.maxVerticalScrollPosition; 
}

Cette méthode définit la propriété verticalScrollPosition , qui correspond au numéro de la ligne de caractère supérieure actuellement affichée, puis lui attribue la valeur de la propriété maxVerticalScrollPosition .

Le code suivant illustre un simple serveur XMLSocket écrit en langage Java qui accepte les connexions entrantes et affichent les messages reçus dans la fenêtre d’invite de commande. Par défaut, un nouveau serveur est créé sur le port 8080 de votre machine locale, mais vous pouvez spécifier un numéro de port différent en lançant le serveur à partir de la ligne de commande.

Créez un document texte et ajoutez-y le code suivant :

import java.io.*; 
import java.net.*; 
 
class SimpleServer 
{ 
    private static SimpleServer server; 
    ServerSocket socket; 
    Socket incoming; 
    BufferedReader readerIn; 
    PrintStream printOut; 
 
    public static void main(String[] args) 
    { 
        int port = 8080; 
 
        try 
        { 
            port = Integer.parseInt(args[0]); 
        } 
        catch (ArrayIndexOutOfBoundsException e) 
        { 
            // Catch exception and keep going. 
        } 
 
        server = new SimpleServer(port); 
    } 
 
    private SimpleServer(int port) 
    { 
        System.out.println(">> Starting SimpleServer"); 
        try 
        { 
            socket = new ServerSocket(port); 
            incoming = socket.accept(); 
            readerIn = new BufferedReader(new InputStreamReader(incoming.getInputStream())); 
            printOut = new PrintStream(incoming.getOutputStream()); 
            printOut.println("Enter EXIT to exit.\r"); 
            out("Enter EXIT to exit.\r"); 
            boolean done = false; 
            while (!done) 
            { 
                String str = readerIn.readLine(); 
                if (str == null) 
                { 
                    done = true; 
                } 
                else 
                { 
                    out("Echo: " + str + "\r"); 
                    if(str.trim().equals("EXIT")) 
                    { 
                        done = true; 
                    } 
                } 
                incoming.close(); 
            } 
        } 
        catch (Exception e) 
        { 
            System.out.println(e); 
        } 
    } 
 
    private void out(String str) 
    { 
        printOut.println(str); 
        System.out.println(str); 
    } 
}

Enregistrez le document sur le disque dur sous le nom SimpleServer.java et compilez-le à l’aide d’un compilateur Java, qui crée un fichier de classe Java nommé SimpleServer.class.

Vous pouvez lancer le serveur XMLSocket via la ligne de commande en tapant java SimpleServer . Le fichier SimpleServer.class peut se situer à tout emplacement sur l’ordinateur local ou le réseau ; il n’est pas nécessaire de le placer dans le répertoire racine du serveur Web.

si vous ne pouvez pas lancer le serveur parce que des fichiers ne se trouvent pas dans le chemin de classe Java, essayez de le faire avec java -classpath. SimpleServer .

Pour établir une connexion au serveur XMLSocket à partir de l’application, vous devez créer une nouvelle occurrence de la classe XMLSocket et appeler la méthode XMLSocket.connect() tout en transférant le nom d’hôte et le numéro de port, comme suit :

var xmlsock:XMLSocket = new XMLSocket(); 
xmlsock.connect("127.0.0.1", 8080);

Dès que vous recevez des données du serveur, l’événement data ( flash.events.DataEvent.DATA ) est distribué :

xmlsock.addEventListener(DataEvent.DATA, onData); 
private function onData(event:DataEvent):void 
{ 
    trace("[" + event.type + "] " + event.data); 
}

Pour envoyer des données au serveur XMLSocket, utilisez la méthode XMLSocket.send() et transmettez un objet XML ou une chaîne. Flash Player convertit le paramètre fourni en objet String et envoie au serveur XMLSocket son contenu suivi d’un octet nul (0) :

xmlsock.send(xmlFormattedData);

La méthode XMLSocket.send() ne renvoie pas de valeur indiquant si les données ont bien été transmises. Si une erreur se produit pendant la tentative d’envoi des données, une erreur IOError est renvoyée.

chaque message que vous envoyez au serveur socket doit se terminer par un caractère de changement de ligne ( \n ).

Pour plus d’informations, voir XMLSocket .