HTTPStatusEvent

Pacchetto	flash.events
Classe	public class HTTPStatusEvent
Ereditarietà	HTTPStatusEvent Event Object

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

L'applicazione invia oggetti HTTPStatusEvent quando una richiesta di rete restituisce un codice di stato HTTP.

Gli oggetti HTTPStatusEvent vengono sempre inviati prima degli eventi di errore o di completamento. Un oggetto HTTPStatusEvent non indica necessariamente una condizione di errore, ma rispecchia semplicemente l'eventuale codice di stato HTTP fornito dallo stack di rete. Alcuni ambienti Flash Player possono non essere in grado di rilevare i codici di stato HTTP; in questi casi viene sempre segnalato un codice di stato 0.

In Flash Player, esiste un solo tipo di evento HTTPStatus: httpStatus. In AIR runtime, un oggetto FileReference, URLLoader, o URLStream può registrarsi per rilevare un evento httpResponseStatus che include le proprietà responseURL e responseHeaders. Queste proprietà non sono definite in un evento httpStatus.

Vedere gli esempi

Proprietà pubbliche

Nascondi proprietà pubbliche ereditate

Mostra proprietà pubbliche ereditate

	Proprietà		Definito da
		bubbles : Boolean [sola lettura] Indica se un evento è un evento di bubbling.	Event
		cancelable : Boolean [sola lettura] Indica se il comportamento associato all'evento può essere impedito.	Event
		constructor : Object Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.	Object
		currentTarget : Object [sola lettura] L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.	Event
		eventPhase : uint [sola lettura] La fase attuale del flusso di eventi.	Event
		redirected : Boolean Indica se la richiesta è stata reindirizzata.	HTTPStatusEvent
		responseHeaders : Array Le intestazioni di risposta che la risposta ha restituito, come un array di oggetti URLRequestHeader.	HTTPStatusEvent
		responseURL : String L'URL da cui è stata restituita la risposta.	HTTPStatusEvent
		status : int [sola lettura] Il codice di stato HTTP restituito dal server.	HTTPStatusEvent
		target : Object [sola lettura] Il target dell'evento.	Event
		type : String [sola lettura] Il tipo di evento.	Event

Metodi pubblici

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	Metodo		Definito da
		HTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0, redirected:Boolean = false) Crea un oggetto Event contenente informazioni specifiche relative agli eventi di stato HTTP.	HTTPStatusEvent
		clone():Event [override] Crea una copia dell'oggetto HTTPStatusEvent e imposta il valore di ogni proprietà in modo che corrisponda a quello dell'originale.	HTTPStatusEvent
		formatToString(className:String, ... arguments):String Una funzione dell'utilità per l'implementazione del metodo toString() in classi Event ActionScript 3.0 personalizzate.	Event
		hasOwnProperty(name:String):Boolean Indica se per un oggetto è definita una proprietà specifica.	Object
		isDefaultPrevented():Boolean Verifica se sull'evento è stato chiamato il metodo preventDefault().	Event
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		preventDefault():void Annulla il comportamento predefinito di un evento se tale comportamento può essere annullato.	Event
		propertyIsEnumerable(name:String):Boolean Indica se la proprietà specificata esiste ed è enumerabile.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		stopImmediatePropagation():void Impedisce l'elaborazione di tutti i listener di eventi nel nodo corrente e in tutti i nodi successivi del flusso di eventi.	Event
		stopPropagation():void Impedisce l'elaborazione di tutti i listener di eventi nei nodi del flusso di eventi successivi a quello corrente.	Event
		toLocaleString():String Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.	Object
		toString():String [override] Restituisce una stringa che contiene tutte le proprietà dell'oggetto HTTPStatusEvent.	HTTPStatusEvent
		valueOf():Object Restituisce il valore di base dell'oggetto specificato.	Object

Costanti pubbliche

Nascondi costanti pubbliche ereditate

Mostra costanti pubbliche ereditate

	Costante		Definito da
		HTTP_RESPONSE_STATUS : String = "httpResponseStatus" [statico] A differenza dell'evento httpStatus, l'evento httpResponseStatus viene inviato prima dei dati di risposta.	HTTPStatusEvent
		HTTP_STATUS : String = "httpStatus" [statico] La costante HTTPStatusEvent.HTTP_STATUS definisce il valore della proprietà type di un oggetto evento httpStatus.	HTTPStatusEvent

Descrizione delle proprietà

redirected

proprietà

redirected:Boolean

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 11.8, AIR 3.8

Indica se la richiesta è stata reindirizzata.

Implementazione
public function get redirected():Boolean
public function set redirected(value:Boolean):void

Elementi API correlati

flash.net.URLRequest.useRedirectedURL()

responseHeaders

proprietà

responseHeaders:Array

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Lite 4

Le intestazioni di risposta che la risposta ha restituito, come un array di oggetti URLRequestHeader.

Implementazione
public function get responseHeaders():Array
public function set responseHeaders(value:Array):void

Elementi API correlati

flash.net.URLRequestHeader

responseURL

proprietà

responseURL:String

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Lite 4

L'URL da cui è stata restituita la risposta. Nel caso di reindirizzamenti, questo URL è diverso dall'URL della richiesta.

Implementazione
public function get responseURL():String
public function set responseURL(value:String):void

status

proprietà

status:int [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Il codice di stato HTTP restituito dal server. Un valore 404, ad esempio, indica che il server non ha trovato una corrispondenza per l'URI richiesto. I codici di stato HTTP sono riportati nelle sezioni 10.4 e 10.5 della specifica HTTP disponibile all'indirizzo http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html.

Se Flash Player o AIR non riescono a ottenere un codice di stato dal server oppure non sono in grado di comunicare con quest'ultimo, il valore predefinito 0 viene passato al codice. Un valore 0 può essere generato in qualsiasi lettore (ad esempio se viene richiesto un URL strutturato in modo non corretto) e viene sempre generato dal plug-in Flash Player eseguito nei browser elencati di seguito, che non passano al lettore i codici di stato HTTP: Netscape, Mozilla, Safari, Opera e Internet Explorer per Macintosh.

Implementazione
public function get status():int

Descrizione della funzione di costruzione

()

Funzione di costruzione

public function HTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0, redirected:Boolean = false)

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Crea un oggetto Event contenente informazioni specifiche relative agli eventi di stato HTTP. Gli oggetti evento vengono passati ai listener di eventi come parametri.

Parametri

	`type:String` — Il tipo di evento. I listener di eventi possono accedere a queste informazioni tramite la proprietà ereditata `type`. Esiste un solo tipo di evento HTTPStatus: `HTTPStatusEvent.HTTP_STATUS`.

	`bubbles:Boolean` (default = `false`) — Determina se l'oggetto Event partecipa alla fase di bubbling del flusso di eventi. I listener di eventi possono accedere a queste informazioni tramite la proprietà ereditata `bubbles`.

	`cancelable:Boolean` (default = `false`) — Determina se l'oggetto Event può essere annullato. I listener di eventi possono accedere a queste informazioni tramite la proprietà ereditata `cancelable`.

	`status:int` (default = `0`) — Stato numerico. I listener di eventi possono accedere a queste informazioni tramite la proprietà `status`.

	`redirected:Boolean` (default = `false`) — Se la richiesta è stata reindirizzata. I listener di eventi possono accedere a queste informazioni tramite la proprietà `redirected`.

Elementi API correlati

HTTP_STATUS

Descrizione dei metodi

clone

()

metodo

override public function clone():Event

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Crea una copia dell'oggetto HTTPStatusEvent e imposta il valore di ogni proprietà in modo che corrisponda a quello dell'originale.

Restituisce

Event — Un nuovo oggetto HTTPStatusEvent con proprietà dai valori identici a quelli dell'originale.

toString

()

metodo

override public function toString():String

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Restituisce una stringa che contiene tutte le proprietà dell'oggetto HTTPStatusEvent. La stringa ha il seguente formato:

[HTTPStatusEvent type=valore bubbles=valore cancelable=valore status=valore]

Restituisce

String — Una stringa che contiene tutte le proprietà dell'oggetto HTTPStatusEvent.

Descrizione delle costanti

HTTP_RESPONSE_STATUS

Costante

public static const HTTP_RESPONSE_STATUS:String = "httpResponseStatus"

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Lite 4

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.

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

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`responseURL`	L'URL da cui è stata restituita la risposta.
`responseHeaders`	Le intestazioni di risposta che la risposta ha restituito, come un array di oggetti URLRequestHeader.
`status`	Il codice di stato HTTP restituito dal server.
`redirected`	Se la risposta è il risultato di un reindirizzamento.
`target`	L'oggetto di rete che riceve un codice di stato HTTP.

Elementi API correlati

flash.net.URLStream.httpResponseStatus
flash.net.FileReference.httpResponseStatus

HTTP_STATUS

Costante

public static const HTTP_STATUS:String = "httpStatus"

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

La costante HTTPStatusEvent.HTTP_STATUS definisce il valore della proprietà type di un oggetto evento httpStatus.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`status`	Il codice di stato HTTP restituito dal server.
`target`	L'oggetto di rete che riceve un codice di stato HTTP.

Elementi API correlati

flash.display.LoaderInfo.httpStatus
flash.net.FileReference.httpStatus
flash.net.URLLoader.httpStatus
flash.net.URLStream.httpStatus

Esempi Come utilizzare questo esempio

HTTPStatusEventExample.as

Nell'esempio seguente viene effettuato il tentativo di caricare un file inesistente dalla directory Web principale all'indirizzo http://www.[yourDomain].com, che dovrebbe inviare un evento httpStatusHandler con un codice di stato 404, per indicare che il file non è stato trovato. L'evento httpStatusHandler viene gestito da httpStatusHandler(), che stampa semplicemente due righe di informazioni relative all'evento.

Note:

Per generare un evento securityError in questo esempio, dovete compilare il file SWF con l'opzione "Sicurezza riproduzione locale" impostata su "Accedi solo alla rete".
È necessario un server in esecuzione su http://www.[yourDomain].com e in ascolto sulla porta 80; in caso contrario, riceverete un evento httpStatusHandler con il codice di stato 0 anziché 404.
Non deve essere presente un file di nome MissingFile.html nella directory Web principale all'indirizzo http://www.[yourDomain].com; in caso contrario non riceverete l'evento httpStatusHandler corretto.

package {
    import flash.display.Sprite;
    import flash.net.URLLoader;
    import flash.net.URLRequest;
    import flash.events.HTTPStatusEvent;

    public class HTTPStatusEventExample extends Sprite {

        public function HTTPStatusEventExample() {
            var loader:URLLoader = new URLLoader();
            loader.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler);

            var request:URLRequest = new URLRequest("http://www.[yourDomain].com/MissingFile.html");
            loader.load(request);
        }

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

Note legali | Informativa sulla privacy online

HTTPStatusEvent - AS3

Classi x

redirected

responseHeaders

responseURL

status