Socket  - AS3

Il numero di byte di dati disponibili per la lettura nel buffer di input.

Il codice deve accedere a bytesAvailable per garantire che siano disponibili dati sufficienti prima di tentarne la lettura con uno dei metodi read.

Indica il numero di byte rimanenti nel buffer di scrittura.

Utilizzate questa proprietà in combinazione con OutputProgressEvent. Un evento OutputProgressEvent viene generato ogni volta che vengono scritti dei dati dal buffer di scrittura alla rete. Nel gestore di eventi, potete controllare la proprietà bytesPending per sapere quanti dati in attesa di scrittura sono rimasti nel buffer. Quando bytesPending restituisce 0, significa che tutti i dati sono stati trasferiti dal buffer di scrittura alla rete ed è quindi possibile eseguire in sicurezza operazioni come rimuovere i gestori di eventi, azzerare i riferimenti socket, avviare il caricamento successivo in una coda, ecc.

Elementi API correlati

Indica se l'oggetto Socket è attualmente connesso. Una chiamata a questa proprietà restituisce un valore true se l'oggetto è attualmente connesso; false in caso contrario.

Indica l'ordine dei byte per i dati. I valori possibili sono costanti della classe flash.utils.Endian: Endian.BIG_ENDIAN o Endian.LITTLE_ENDIAN.

Il valore predefinito è Endian.BIG_ENDIAN.

Elementi API correlati

L'indirizzo IP a cui è associato questo socket sul computer locale.

Elementi API correlati

La porta a cui è associato questo socket sul computer locale.

Elementi API correlati

Controlla la versione di Action Message Format (AMF) utilizzata per scrivere o leggere un oggetto.

Elementi API correlati

L'indirizzo IP del computer remoto a cui è connesso questo socket.

Potete utilizzare questa proprietà per determinare l'indirizzo IP di un socket client inviato in un evento ServerSocketConnectEvent da un oggetto ServerSocket. Utilizzate la classe DNSResolver per convertire un indirizzo IP in un nome di dominio, se necessario.

Elementi API correlati

La porta sul computer remoto a cui è connesso questo socket.

Potete utilizzare questa proprietà per determinare il numero di porta di un socket client inviato in un evento ServerSocketConnectEvent da un oggetto ServerSocket.

Elementi API correlati

Indica il numero di millisecondi di attesa di una connessione.

Se la connessione non viene stabilita entro l'intervallo specificato, avrà esito negativo. Il valore predefinito è 20,000 (venti secondi).

Crea un nuovo oggetto Socket. Se non è specificato alcun parametro, viene creato un socket inizialmente disconnesso. Se sono specificati dei parametri, viene tentata una connessione all'host e alla porta specificati.

Nota: si consiglia di utilizzare la funzione di costruzione senza parametri, quindi di aggiungere eventuali listener di eventi e chiamare il metodo connect con i parametri host e port. Questa sequenza garantisce che tutti i listener di eventi funzioneranno correttamente.

Chiude il socket. Non è possibile leggere o scrivere alcun dato dopo che è stato chiamato il metodo close().

L'evento close viene inviato solo quando il server chiude la connessione; non viene inviato quando si chiama il metodo close().

L'oggetto Socket può essere riutilizzato chiamando nuovamente il metodo connect() su di esso.

Connette il socket all'host e alla porta specificati.

Se la connessione fallisce immediatamente, viene inviato un evento o generata un'eccezione: viene inviato un evento di errore se è stato specificato un host; viene generata un'eccezione se non è stato specificato alcun host. In caso contrario, lo stato della connessione viene riportato da un evento. Se il socket è già connesso, prima viene chiusa la connessione esistente.

Parametri

Altri esempi

Svuota tutti i dati eventualmente accumulati nel buffer di output del socket.

In alcuni sistemi operativi, flush() viene chiamato automaticamente tra i fotogrammi di esecuzione, ma in altri sistemi operativi, ad esempio Windows, i dati non vengono mai inviati a meno che flush() non venga chiamato esplicitamente. Per fare in modo che l'applicazione si comporti in maniera affidabile in tutti i sistemi operativi, è opportuno chiamare il metodo flush() dopo aver scritto ogni messaggio (o gruppo di dati correlati) sul socket.

Legge un valore booleano dal socket. Dopo aver letto un byte singolo, il metodo restituisce true se il byte è diverso da zero e false in caso contrario.

Legge un byte con segno dal socket.

Legge il numero di byte di dati, specificato dal parametro lunghezza, dal socket. I byte vengono letti nell'array dei byte specificato, partendo dalla posizione indicata da offset.

Parametri

Legge un numero a virgola mobile e a precisione doppia IEEE 754 dal socket.

Legge un numero a virgola mobile e a precisione singola IEEE 754 dal socket.

Legge un numero intero a 32 bit con segno dal socket.

Legge una stringa multibyte dal flusso di byte utilizzando il set di caratteri specificato.

Parametri

Legge un oggetto dal socket, codificato in formato serializzato AMF.

Elementi API correlati

Legge un numero intero a 16 bit con segno dal socket.

Legge un byte senza segno dal socket.

Legge un numero intero a 32 bit senza segno dal socket.

Legge un numero intero a 16 bit senza segno dal socket.

Legge una stringa UTF-8 dal socket. Presume che la stringa abbia come prefisso un numero intero short senza segno che indica la lunghezza in byte.

Legge il numero di byte di dati UTF-8, specificato dal parametro length, dal socket e restituisce una stringa.

Parametri

Scrive un valore booleano nel socket. Questo metodo scrive un byte singolo, con valore 1 (true) o 0 (false).

Parametri

Elementi API correlati

Scrive un byte nel socket.

Parametri

Elementi API correlati

Scrive una sequenza di byte dall'array dei byte specificato. L'operazione di scrittura inizia dalla posizione specificata da offset.

Se omettete il parametro length, la lunghezza predefinita 0 impone al metodo di scrivere l'intero buffer a partire da offset.

Se omettete anche il parametro offset, viene scritto l'intero buffer.

Parametri

Elementi API correlati

Scrive un numero a virgola mobile e a precisione doppia IEEE 754 nel socket.

Parametri

Elementi API correlati

Scrive un numero a virgola mobile e a precisione singola IEEE 754 nel socket.

Parametri

Elementi API correlati

Scrive un numero intero con segno a 32 bit nel socket.

Parametri

Elementi API correlati

Scrive una stringa multibyte dal flusso di byte utilizzando il set di caratteri specificato.

Parametri

Elementi API correlati

Scrive un oggetto nel socket in formato serializzato AMF.

Parametri

Elementi API correlati

Scrive un numero intero a 16 bit nel socket. I byte scritti sono i seguenti:

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

Vengono utilizzati i 16 bit inferiori del parametro; i 16 bit superiori vengono ignorati.

Parametri

Elementi API correlati

Scrive un numero intero senza segno a 32 bit nel socket.

Parametri

Elementi API correlati

Scrive i dati seguenti nel socket: un numero intero senza segno a 16 bit, che indica la lunghezza della stringa UTF-8 specificata espressa in byte, seguita dalla stringa stessa.

Prima di scrivere la stringa, il metodo calcola il numero di byte necessari per rappresentare tutti i caratteri della stringa.

Parametri

Elementi API correlati

Scrive una stringa UTF-8 nel socket.

Parametri

Elementi API correlati

Inviato quando il server chiude la connessione socket.

L'evento close viene inviato solo quando il server chiude la connessione; non viene inviato quando si chiama il metodo Socket.close().

Questo evento ha le seguenti proprietà:

Inviato quando è stata stabilita una connessione di rete.

Questo evento ha le seguenti proprietà:

Inviato quando si verifica un errore di input/output che impedisce un'operazione di invio o caricamento.

Questo evento ha le seguenti proprietà:

Inviato quando un socket sposta dei dati dal suo buffer di scrittura al livello di trasporto della connettività

Inviato se una chiamata a Socket.connect() tenta di connettersi a un server non autorizzato dalla sandbox di sicurezza del chiamante o a una porta con numero inferiore a 1024 e non è disponibile un file di criteri socket per consentire la connessione.

Nota: in un'applicazione AIR, al contenuto in esecuzione nella sandbox di sicurezza dell'applicazione è consentito connettersi a qualsiasi server e numero di posta senza un file di criteri socket.

Questo evento ha le seguenti proprietà:

Elementi API correlati

Inviato se un socket ha ricevuto i dati.

I dati ricevuti dal socket rimangono nel socket fino a quando non vengono letti. Non è necessario leggere tutti i dati disponibili nel gestore di questo evento.

Gli eventi di tipo socketData non utilizzano la proprietà ProgressEvent.bytesTotal.

Questo evento ha le seguenti proprietà:

1. La funzione di costruzione crea un'istanza CustomSocket di nome socket e passa il nome dell'host localhost e la porta 80 come argomenti. Poiché CustomSocket estende Socket, una chiamata a super() chiama la funzione di costruzione di Socket.
2. Quindi, l'esempio chiama il metodo configureListeners(), che aggiunge i listener per gli eventi Socket.
3. Infine, viene chiamato il metodo connect() del socket con localhost come nome host name e 80 come numero di porta.

Nota: per provare l'esempio, è necessario che un server sia in esecuzione nello stesso dominio in cui risiede il file SWF (nell'esempio, localhost) e ascolti dalla porta 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();
    }
}