Socket

Il file TelnetSocket.mxml principale viene utilizzato per la creazione dell'interfaccia utente (UI) dell'applicazione.

Oltre all'interfaccia utente, questo file definisce due metodi, login() e sendCommand() , per connettere l'utente al server specificato.

Il codice riportato di seguito elenca il codice ActionScript nel file dell'applicazione principale:

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 prima riga di codice importa la classe Telnet dal pacchetto personalizzato com.example.programmingas.socket. La seconda riga di codice dichiara un'istanza della classe Telnet, telnetClient , che viene inizializzata successivamente dal metodo connect() . Viene quindi dichiarato il metodo connect() e viene inizializzata la variabile telnetClient dichiarata in precedenza. Questo metodo passa il nome del server specificato dall'utente, la porta del server telnet e un riferimento a un componente TextArea nell'elenco di visualizzazione, che viene utilizzato per visualizzare le risposte in formato testo del server socket. Le ultime due righe del metodo connect() impostano la proprietà title per il pannello e attivano il componente pannello, che consente all'utente di inviare dati al server remoto. Il metodo finale nel file dell'applicazione principale, sendCommand() , viene utilizzato per inviare i comandi dell'utente al server remoto come oggetto ByteArray.

La classe Telnet viene utilizzata per connettersi al server Telnet remoto e per inviare/ricevere i dati.

La classe Telnet dichiara le seguenti variabili private:

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

La prima variabile, serverURL , contiene l'indirizzo del server a cui connettersi specificato dall'utente.

La seconda variabile, portNumber , specifica il numero di porta su cui è attualmente in esecuzione il server Telnet. Per impostazione predefinita, il servizio Telnet viene eseguito sulla porta 23e.

La terza variabile, socket , è un'istanza di Socket che tenta di connettersi al server definito dalle variabili serverURL e portNumber .

La quarta variabile, ta , è un riferimento a un'istanza del componente TextArea sullo stage. Questo componente viene utilizzato per visualizzare le risposte dal server Telnet remoto o gli eventuali messaggi di errore.

La variabile finale, state , è un valore numerico che viene utilizzato per determinare le opzioni supportate dal client Telnet.

Come è già stato illustrato in precedenza, la funzione di costruzione della classe Telnet viene chiamata dal metodo connect() nel file dell'applicazione principale.

La funzione di costruzione Telnet accetta tre parametri: server , port e output . I parametri server e port specificano il nome del server e il numero di porta su cui è in esecuzione il server Telnet. Il parametro finale, output , è un riferimento a un'istanza del componente TextArea sullo stage dove viene visualizzato l'output del server.

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(); 
    } 
}

Per scrivere dati su una connessione socket, chiamate uno dei metodi di scrittura nella classe Socket. Questi metodi includono writeBoolean() , writeByte() , writeBytes() , writeDouble() e altri. Quindi, scaricate i dati nel buffer di output utilizzando il metodo flush() . Nel server Telnet, i dati vengono scritti sulla connessione socket utilizzando il metodo writeBytes() che utilizza l'array di byte come parametro e lo invia al buffer di output. Di seguito è riportato il metodo writeBytesToSocket() :

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

Questo metodo viene chiamato dal metodo sendCommand() del file dell'applicazione principale.

Ogni volta che si riceve un messaggio dal server socket o si verifica un evento, viene chiamato il metodo personalizzato msg() . Questo metodo aggiunge una stringa al componente TextArea sullo stage e chiama un metodo personalizzato setScroll() , che scorre il componente TextArea fino alla fine. Di seguito è riportato il metodo msg() :

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

Se il contenuto del componente TextArea non scorre automaticamente fino alla fine, gli utenti dovranno trascinare manualmente le barre di scorrimento nell'area di testo per visualizzare l'ultima risposta dal server.

Il metodo setScroll() contiene un'unica riga di codice ActionScript che attiva lo scorrimento verticale del contenuto del componente TextArea, in modo che l'utente possa visualizzare l'ultima riga del testo restituito. Nello snippet di codice seguente, viene illustrato il metodo setScroll() :

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

Questo metodo imposta la proprietà verticalScrollPosition che corrisponde al numero di riga della prima riga di caratteri attualmente visualizzata e lo imposta come valore della proprietà maxVerticalScrollPosition .

Il codice riportato di seguito dimostra un semplice server XMLSocket scritto in Java che accetta le connessioni in entrata e visualizza i messaggi ricevuti nella finestra del prompt dei comandi. Per impostazione predefinita, viene creato un nuovo server sulla porta 8080 del computer locale, anche se è possibile specificare un numero di porta diverso quando si avvia il server dalla riga di comando.

Create un nuovo documento di testo e aggiungete il codice riportato di seguito:

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); 
    } 
}

Salvate il documento sul disco rigido come SimpleServer.java e utilizzate un compilatore Java compilarlo, che crea un file di classe Java di nome SimpleServer.class.

Potete avviare il server XMLSocket aprendo un prompt dei comandi e digitando java SimpleServer . Il file SimpleServer.class può trovarsi in qualsiasi percorso del computer locale o della rete; non è necessario collocarlo nella directory principale del server Web.

Se non è possibile avviare il server perché i file non si trovano nel percorso di classe Java, provate ad avviarlo con java -classpath. SimpleServer .

Per connettervi a XMLSocket dall'applicazione, dovete creare una nuova istanza della classe XMLSocket e chiamare il metodo XMLSocket.connect() passando un nome host e un numero di porta, come riportato di seguito:

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

Ogni volta che ricevete dati dal server, viene inviato l'evento data ( flash.events.DataEvent.DATA ):

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

Per inviare dati al server XMLSocket, utilizzate il metodo XMLSocket.send() e passate una stringa o un oggetto XML. Flash Player converte il parametro fornito in un oggetto String e invia il contenuto al server XMLSocket seguito da un byte zero (0):

xmlsock.send(xmlFormattedData);

Il metodo XMLSocket.send() non restituisce un valore che indica se i dati sono stati trasmessi correttamente. Se durante il tentativo di invio dei dati si è verificato un errore, viene generato un errore IOError.

Ogni messaggio inviato al server socket XML deve essere terminato da un carattere newline ( \n ).

Per ulteriori informazioni, vedete XMLSocket .