XMLSocket  - AS3

Indica se l'oggetto XMLSocket è attualmente connesso. È anche possibile verificare se la connessione è riuscita registrandosi per l'evento connect e l'evento ioError.

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 XMLSocket. 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.

Elementi API correlati

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

Altri esempi

Elementi API correlati

Stabilisce una connessione all'host Internet specificato mediante la porta TCP configurata.

Se specificate il valore null per il parametro host, l'host contattato è quello su cui risiede il file che effettua la chiamata a XMLSocket.connect(). Se, ad esempio, il file che emette la chiamata è stato scaricato da www.adobe.com, specificando null per il parametro host, significa che state collegandovi a www.adobe.com.

È possibile impedire che un file utilizzi questo metodo impostando il parametro allowNetworking dei tag object ed embed nella pagina HTML che include il contenuto SWF.

Per ulteriori informazioni, vedete l'argomento sulla sicurezza nel Centro per sviluppatori di Flash Player .

Parametri

Altri esempi

Elementi API correlati

Converte l'oggetto XML o i dati specificati nel parametro object in una stringa e la trasmette al server, seguita da un byte zero (0). Se object è un oggetto XML, la stringa è la rappresentazione testuale XML dell'oggetto XML. L'operazione di invio è asincrona; restituisce immediatamente un valore, ma è possibile che i dati vengano trasmessi in un secondo momento. Il metodo XMLSocket.send() non restituisce un valore che indica se i dati sono stati trasmessi correttamente.

Se non si connette l'oggetto XMLSocket al server (mediante XMLSocket.connect()), l'operazione XMLSocket.send() non riesce.

Parametri

Altri esempi

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

Questo evento ha le seguenti proprietà:

Inviato dopo una chiamata riuscita al metodo XMLSocket.connect().

Questo evento ha le seguenti proprietà:

Inviato dopo che sono stati inviati o ricevuti dei dati raw.

Questo evento ha le seguenti proprietà:

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

Questo evento ha le seguenti proprietà:

Inviato se una chiamata al metodo XMLSocket.connect() tenta di connettersi a un server che si trova al di fuori della funzione di sicurezza sandbox del chiamante o di una porta con numero inferiore a 1024.

Questo evento ha le seguenti proprietà:

Elementi API correlati

1. La funzione di costruzione XMLSocketExample crea un'istanza XMLSocket denominata socket e passa socket a ConfigureListeners() (descritto di seguito), quindi chiama il metodo connect() di XMLSocket mediante il nome host "localhost" e il numero di porta 8080.
2. Viene quindi chiamato il metodo configureListeners() che aggiunge i listener per ognuno degli eventi XMLSocket supportati:
   • closeHandler(): intercetta l'evento close che viene inviato dopo la chiusura della connessione di rete.
   • connectHandler(): intercetta l'evento connect che viene inviato quando è stata stabilita una connessione di rete.
   • dataHandler(): intercetta gli eventi data che vengono inviati ogni volta che XMLSocket riceve nuovi dati.
   • progressHandler(): intercetta gli eventi progress, che vengono inviati quando è stata effettuata una chiamata a send() e mentre l'invio è in corso.
   • securityErrorHandler(): intercetta gli eventi securityError che sarebbero inviati se si tentasse di accedere a XMLSocket con l'impostazione di sicurezza per la riproduzione locale non corretta o utilizzando una porta con numero inferiore a 1024.
   • ioErrorHandler(): intercetta gli eventi ioError che si verificano solo se un'operazione di invio o ricezione dati non riesce.

Note:

• Dovete compilare il file SWF con l'opzione "Sicurezza riproduzione locale" impostato su "Accedi solo alla rete".
• Perché questo esempio funzioni, è necessario che un server sia in esecuzione sul dominio locale utilizzando la porta 8080.
• Se utilizzate Flash Player 9.0.124.0 o versione successiva, dovete inserire un file dei criteri per i socket sul server che consenta le connessioni socket dal dominio locale alla porta 8080. Per informazioni sulla fornitura di file dei criteri per i socket, vedete l'argomento nel Centro per sviluppatori Flash Player: Setting up a socket policy file server (Impostazione di un file server di criteri per i socket).

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