AVURLStream - Guida di riferimento alle API Adobe ActionScript® 3 (AS3 )

Pacchetto	flash.media
Classe	public class AVURLStream
Ereditarietà	AVURLStream URLStream EventDispatcher Object

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

La classe URLStream fornisce l'accesso di basso livello agli URL di scaricamento. I dati vengono immediatamente resi disponibili per il codice dell'applicazione mentre vengono scaricati, anziché attendere il completamento dell'intero file come accade con URLLoader. La classe URLStream consente inoltre di chiudere uno streaming prima che termini lo scaricamento. Il contenuto del file scaricato viene reso disponibile sotto forma di dati binari originari.

Le operazioni di lettura in URLStream non sono bloccanti. Ciò significa che è necessario utilizzare la proprietà bytesAvailable se sono disponibili dati sufficienti prima di leggerli. Viene generata un'eccezione EOFError se i dati disponibili sono insufficienti.

Tutti i dati binari vengono codificati per impostazione predefinita in formato Big Endian, con il byte più significativo all'inizio.

Le regole di sicurezza applicate allo scaricamento dell'URL con la classe URLStream sono identiche a quelle applicate agli oggetti URLLoader. Se necessario, è possibile scaricare i file dei criteri. Vengono applicate le regole di sicurezza dei file locali e, se necessario, vengono generati degli avvisi di sicurezza.

Elementi API correlati

URLLoader
URLRequest

Proprietà pubbliche

Nascondi proprietà pubbliche ereditate

Mostra proprietà pubbliche ereditate

	Proprietà		Definito da
		bytesAvailable : uint [sola lettura] Restituisce il numero di byte dei dati disponibili per la lettura nel buffer di input.	URLStream
		connected : Boolean [sola lettura] Indica se l'oggetto URLStream è attualmente connesso.	URLStream
		constructor : Object Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.	Object
		cookieHeader : String [sola scrittura]	AVURLStream
		endian : String Indica l'ordine di byte per i dati.	URLStream
		objectEncoding : uint Controlla la versione di Action Message Format (AMF) utilizzata per scrivere o leggere un oggetto.	URLStream

Metodi pubblici

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	Metodo		Definito da
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento.	EventDispatcher
		close():void Chiude immediatamente lo streaming e annulla l'operazione di scaricamento.	URLStream
		dispatchEvent(event:Event):Boolean Invia un evento nel flusso di eventi.	EventDispatcher
		hasEventListener(type:String):Boolean Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica se per un oggetto è definita una proprietà specifica.	Object
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		load(request:URLRequest):void [override] Inizia a scaricare l'URL specificato nel parametro request.	AVURLStream
		propertyIsEnumerable(name:String):Boolean Indica se la proprietà specificata esiste ed è enumerabile.	Object
		readBoolean():Boolean Legge un valore booleano dallo streaming.	URLStream
		readByte():int Legge un byte con segno dallo streaming.	URLStream
		readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void Legge dallo streaming il numero di byte specificato dal parametro length.	URLStream
		readDouble():Number Legge un numero a virgola mobile e a precisione doppia IEEE 754 dallo streaming.	URLStream
		readFloat():Number Legge un numero a virgola mobile e a precisione singola IEEE 754 dallo streaming.	URLStream
		readInt():int Legge un numero intero a 32 bit con segno dallo streaming.	URLStream
		readMultiByte(length:uint, charSet:String):String Legge una stringa multibyte della lunghezza specificata dal flusso di byte, utilizzando il set di caratteri specificato.	URLStream
		readObject():* Legge un oggetto dal socket, codificato in Action Message Format (AMF).	URLStream
		readShort():int Legge un numero intero a 16 bit con segno dallo streaming.	URLStream
		readUnsignedByte():uint Legge un byte senza segno dallo streaming.	URLStream
		readUnsignedInt():uint Legge un numero intero a 32 bit senza segno dallo streaming.	URLStream
		readUnsignedShort():uint Legge un numero intero a 16 bit senza segno dallo streaming.	URLStream
		readUTF():String Legge una stringa UTF-8 dallo streaming.	URLStream
		readUTFBytes(length:uint):String Legge dallo streaming una sequenza di byte UTF-8 pari al parametro length e restituisce una stringa.	URLStream
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Rimuove un listener dall'oggetto EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		toLocaleString():String Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.	Object
		toString():String Restituisce la rappresentazione in formato stringa dell'oggetto specificato.	Object
		valueOf():Object Restituisce il valore di base dell'oggetto specificato.	Object
		willTrigger(type:String):Boolean Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato.	EventDispatcher

Eventi

Fate clic per visualizzare altre informazioni sugli eventi

Nascondi eventi ereditati

Mostra eventi ereditati

	Riepilogo	Definito da
activate	[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo.	EventDispatcher
complete	Inviato quando i dati sono stati caricati correttamente.	URLStream
deactivate	[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo.	EventDispatcher
httpResponseStatus	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.	URLStream
httpStatus	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.	URLStream
ioError	Inviato quando si verifica un errore di input/output che impedisce l'operazione di caricamento.	URLStream
open	Inviato quando inizia un'operazione di caricamento.	URLStream
progress	Inviato quando vengono ricevuti i dati mentre è in corso l'operazione di scaricamento.	URLStream
securityError	Inviato se una chiamata al metodo URLStream.load() tenta di caricare dati da un server al di fuori della funzione di sicurezza sandbox.	URLStream

Descrizione delle proprietà

cookieHeader

proprietà

cookieHeader:String [sola scrittura]

Implementazione
public function set cookieHeader(value:String):void

Descrizione dei metodi

load

()

metodo

override public function load(request:URLRequest):void

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

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

request:URLRequest — Un oggetto URLRequest che specifica l'URL da scaricare. Se il valore di questo parametro o della proprietà URLRequest.url dell'oggetto URLRequest passato è null, l'applicazione genera un errore di puntatore nullo.

Eventi

	`complete:Event` — Inviato dopo che i dati sono stati caricati correttamente. Se è presente un listener di eventi `httpResponseStatus`, l'oggetto URLRequest invia anche un evento `complete` a prescindere che il codice dello stato di risposta HTTP indichi un esito positivo oppure un errore.

	`httpStatus:HTTPStatusEvent` — Se l'accesso avviene via HTTP e l'ambiente corrente supporta l'ottenimento di codici di stato, potreste ricevere questi eventi in aggiunta agli eventi `complete` o `error`.

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

	`ioError:IOErrorEvent` — Impossibile completare l'operazione di caricamento.

	`open:Event` — Inviato quando inizia un'operazione di caricamento.

	`securityError:SecurityErrorEvent` — Un'operazione di caricamento ha tentato di recuperare dati da un server che si trova al di fuori della funzione di sicurezza sandbox del chiamante. Questo inconveniente può essere risolto utilizzando un file dei criteri sul server.

Genera

	`ArgumentError` — Gli oggetti `URLRequest.requestHeader` potrebbero non contenere determinate intestazioni di richiesta HTTP proibite. Per ulteriori informazioni, vedete la descrizione della classe URLRequestHeader.

	`MemoryError` — Questo errore può verificarsi per i seguenti motivi: Flash Player o Adobe AIR non è in grado di convertire il parametro `URLRequest.data` da UTF8 a MBCS. Questo errore è applicabile se l'oggetto URLRequest passato a `load()` è impostato per eseguire un'operazione `GET` e se `System.useCodePage` è impostato su `true`. Flash Player o Adobe AIR non è in grado di allocare memoria per i dati `POST`. Questo errore è applicabile se l'oggetto URLRequest passato a load è impostato per eseguire un'operazione `POST`.

	`SecurityError` — I file SWF non attendibili locali potrebbero non essere in grado di comunicare con Internet. Questo inconveniente può essere risolto riclassificando il file SWF come file locale con utilizzo in rete o come attendibile.

	`SecurityError` — State tentando di collegarvi a una porta comunemente riservata. Per un elenco completo di porte bloccate, vedete "Limitazioni delle API di connettività di rete" nella Guida per gli sviluppatori di ActionScript 3.0.

Note legali | Informativa sulla privacy online

AVURLStream - AS3

Classi x

cookieHeader

load