URLStream  - AS3

Restituisce il numero di byte dei dati disponibili per la lettura nel buffer di input. Il codice utente deve chiamare la proprietà bytesAvailable per verificare che i dati disponibili siano sufficienti prima di tentare di leggerli mediante uno dei metodi read.

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

Indica l'ordine di byte per i dati. I valori possibili sono Endian.BIG_ENDIAN e Endian.LITTLE_ENDIAN.

Il valore predefinito è Endian.BIG_ENDIAN.

Elementi API correlati

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

Elementi API correlati

Chiude immediatamente lo streaming e annulla l'operazione di scaricamento. Non è possibile leggere alcun dato dallo streaming dopo che è stato chiamato il metodo close().

Inizia a scaricare l'URL specificato nel parametro request.

Nota: se un file caricato contiene caratteri non ASCII (come accade in molte lingue diverse dall'inglese), si consiglia di salvare il file con una codifica UTF-8 o UTF-16, in contrapposizione a un formato non codificato con Unicode come ASCII.

Se l'operazione di caricamento locale non riesce immediatamente, viene generata un'eccezione IOError o SecurityError (compreso l'errore di sicurezza dei file locali) che descrive l'errore. Altrimenti, viene inviato un evento open se lo scaricamento dell'URL inizia correttamente, oppure viene inviato un evento di errore se si verifica un errore.

Per impostazione predefinita, il file SWF chiamante e l'URL da caricare devono trovarsi esattamente nello stesso dominio. Ad esempio, un file SWF sul sito www.adobe.com può caricare i dati solo dalle origini presenti in www.adobe.com. Per caricare dati da un dominio diverso, collocate un file dei criteri degli URL sul server sul quale si trovano i dati.

In Flash Player, non potete effettuare connessioni a porte normalmente riservate. Per un elenco completo di porte bloccate, vedete "Limitazioni delle API di connettività di rete" nel Guida per gli sviluppatori Programmazione in ActionScript 3.0.

In Flash Player, potete impedire a un file SWF di utilizzare questo metodo impostando il parametro allowNetworking dei tag object ed embed nella pagina HTML in cui è presente il contenuto SWF.

In Flash Player 10 e versioni successive e in AIR 1.5 e versioni successive, se utilizzate un Content-Type multipart (ad esempio "multipart/form-data") che contiene un caricamento (indicato da un parametro "filename" in un'intestazione "content-disposition" nel corpo POST), l'operazione POST è soggetta alle regole di sicurezza applicate ai caricamenti:

• L'operazione POST deve essere eseguita come risposta a un'azione compiuta dall'utente, come un clic del mouse o la pressione di un tasto.
• Se l'operazione POST è tra più domini (il target POST non si trova sullo stesso server del file SWF che invia la richiesta POST), il server di destinazione deve fornire un file di criteri URL che consenta l'accesso tra più domini.

Inoltre, per qualsiasi Content-Type multipart, la sintassi deve essere valida (in conformità agli standard RFC2046). Se la sintassi non è valida, l'operazione POST è soggetta alle regole di sicurezza applicate ai caricamenti.

Queste regole valgono anche per il contenuto AIR nelle funzioni di sicurezza sandbox non dell'applicazione. Tuttavia, in Adobe AIR il contenuto della funzione di sicurezza sandbox dell'applicazione (contenuto installato con l'applicazione AIR) non è interessato da queste limitazioni di sicurezza.

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

In AIR, un oggetto URLRequest può registrarsi per l'evento di stato httpResponse. A differenza dell'evento httpStatus, l'evento httpResponseStatus viene inviato prima dei dati di risposta. Inoltre, l'evento httpResponseStatus include valori per le proprietà responseHeaders e responseURL (che non sono definite per un evento httpStatus). L'evento httpResponseStatus (se presente) viene inviato prima di (e in aggiunta a) qualsiasi evento complete o error.

Se è presente un listener di eventi httpResponseStatus, il corpo del messaggio di risposta viene sempre inviato e le risposte del codice di stato HTTP producono sempre un evento complete. Tale evento è true a prescindere dal fatto che il codice dello stato di risposta HTTP indichi un esito positivo o un errore.

In AIR se non è presente un listener di eventi httpResponseStatus, il comportamento varia a seconda della versione del SWF:

• Per contenuto SWF 9, il corpo del messaggio di risposta HTTP viene inviato solo se il codice di stato della risposta HTTP indica un esito positivo. In caso contrario (ovvero in presenza di un errore), non viene inviato alcun corpo e l'oggetto URLRequest invia un evento IOError.
• Per contenuto SWF 10, il corpo del messaggio di risposta HTTP viene sempre inviato. Se si verifica un errore, l'oggetto URLRequest invia un evento IOError.

Parametri

Legge un valore booleano dallo streaming. Viene letto un singolo byte e viene restituito true se il byte è diverso da zero oppure false in caso contrario.

Legge un byte con segno dallo streaming.

Il valore restituito è compreso nell'intervallo -128...127.

Legge dallo streaming il numero di byte specificato dal parametro length. I byte vengono letti nell'oggetto ByteArray specificato da bytes, partendo dai byte offset nell'oggetto ByteArray.

Parametri

Legge un numero a virgola mobile e a precisione doppia IEEE 754 dallo streaming.

Legge un numero a virgola mobile e a precisione singola IEEE 754 dallo streaming.

Legge un numero intero a 32 bit con segno dallo streaming.

Il valore restituito è compreso nell'intervallo -2147483648...2147483647.

Legge una stringa multibyte della lunghezza specificata dal flusso di byte, utilizzando il set di caratteri specificato.

Parametri

Legge un oggetto dal socket, codificato in Action Message Format (AMF).

Elementi API correlati

Legge un numero intero a 16 bit con segno dallo streaming.

Il valore restituito è compreso nell'intervallo -32768...32767.

Legge un byte senza segno dallo streaming.

Il valore restituito è compreso nell'intervallo 0...255.

Legge un numero intero a 32 bit senza segno dallo streaming.

Il valore restituito è compreso nell'intervallo 0...4294967295.

Legge un numero intero a 16 bit senza segno dallo streaming.

Il valore restituito è compreso nell'intervallo 0...65535.

Legge una stringa UTF-8 dallo streaming. Si presume che la stringa abbia come prefisso una dichiarazione unsigned short, che indica la lunghezza in byte.

Legge dallo streaming una sequenza di byte UTF-8 pari al parametro length e restituisce una stringa.

Parametri

Inviato quando i dati sono stati caricati correttamente.

Questo evento ha le seguenti proprietà:

Inviato se una chiamata al metodo URLStream.load() tenta di accedere ai dati via HTTP e Adobe AIR è in grado di rilevare e restituire il codice di stato della richiesta.

Se un oggetto URLStream viene registrato per un evento httpStatusEvent, le risposte agli errori vengono inviate come se si trattasse di contenuto. Pertanto, anziché inviare un evento ioError, URLStream invia gli eventi progress e complete quando i dati di errore vengono caricati in URLStream.

La costante HTTPStatusEvent.HTTP_RESPONSE_STATUS definisce il valore della proprietà type di un oggetto evento httpResponseStatus.

Questo evento ha le seguenti proprietà:

Elementi API correlati

Inviato se una chiamata a URLStream.load() tenta di accedere ai dati via HTTP e Flash Player o Adobe AIR è in grado di rilevare e restituire il codice di stato della richiesta. (Alcuni ambienti browser potrebbero non essere in grado di fornire queste informazioni). L'evento httpStatus (se presente) viene inviato prima di (e in aggiunta a) qualsiasi evento complete o error.

Questo evento ha le seguenti proprietà:

Elementi API correlati

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

Questo evento ha le seguenti proprietà:

Elementi API correlati

Inviato quando inizia un'operazione di caricamento.

Questo evento ha le seguenti proprietà:

Elementi API correlati

Inviato quando vengono ricevuti i dati mentre è in corso l'operazione di scaricamento. I dati che sono stati ricevuti possono essere letti immediatamente utilizzando i metodi della classe URLStream.

Questo evento ha le seguenti proprietà:

Elementi API correlati

Inviato se una chiamata al metodo URLStream.load() tenta di caricare dati da un server al di fuori della funzione di sicurezza sandbox.

Questo evento ha le seguenti proprietà:

Elementi API correlati

Per provare l'esempio, collocate un file di nome URLStreamExample.swf nella stessa directory del file SWF.

package {
    import flash.display.Sprite;
    import flash.errors.*;
    import flash.events.*;
    import flash.net.URLRequest;
    import flash.net.URLStream;

    public class URLStreamExample extends Sprite {
        private static const ZLIB_CODE:String = "CWS";
        private var stream:URLStream;

        public function URLStreamExample() {
            stream = new URLStream();
            var request:URLRequest = new URLRequest("URLStreamExample.swf");
            configureListeners(stream);
            try {
                stream.load(request);
            } catch (error:Error) {
                trace("Unable to load requested URL.");
            }
        }

        private function configureListeners(dispatcher:EventDispatcher):void {
            dispatcher.addEventListener(Event.COMPLETE, completeHandler);
            dispatcher.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler);
            dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            dispatcher.addEventListener(Event.OPEN, openHandler);
            dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
        }

        private function parseHeader():void {
            trace("parseHeader");
            trace("isCompressed: " + isCompressed());
            trace("version: " + stream.readByte());
        }

        private function isCompressed():Boolean {
            return (stream.readUTFBytes(3) == ZLIB_CODE);
        }

        private function completeHandler(event:Event):void {
            trace("completeHandler: " + event);
            parseHeader();
        }

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

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

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

        private function httpStatusHandler(event:HTTPStatusEvent):void {
            trace("httpStatusHandler: " + event);
        }

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