HTTPStatusEvent

Paket	flash.events
Klass	public class HTTPStatusEvent
Arv	HTTPStatusEvent Event Object

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

Programmet skickar HTTPStatusEvent-objekt när en nätverksbegäran returnerar en HTTP-statuskod.

HTTPStatusEvent-objekt skickas alltid före felhändelser eller slutförda händelser. Ett HTTPStatusEvent-objekt indikerar inte nödvändigtvis ett feltillstånd, det bara återspeglar HTTP-statuskoden (om sådan finns) som anges av nätverksstacken. En del Flash Player-miljöer kanske inte kan upptäcka HTTP-statuskoder; då rapporteras alltid statuskoden 0.

I Flash Player finns det endast en typ av HTTPStatus-händelse: httpStatus. I AIR-körningen kan en FileReference, URLLoader eller URLStream registreras för att lyssna efter en httpResponseStatus som inkluderar responseURL och responseHeaders-egenskaper. Dessa egenskaper är odefinierade i en httpStatus-händelse.

Visa exemplen

Publika egenskaper

Dölj ärvda publika egenskaper

Visa ärvda publika egenskaper

	Egenskap		Definieras med
		bubbles : Boolean [skrivskyddad] indikerar om händelsen är en bubblande händelse.	Event
		cancelable : Boolean [skrivskyddad] Indikerar om beteendet som är kopplat till händelsen kan förhindras.	Event
		constructor : Object En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans.	Object
		currentTarget : Object [skrivskyddad] Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.	Event
		eventPhase : uint [skrivskyddad] Den nuvarande fasen i händelseflödet.	Event
		redirected : Boolean Anger om begäran omdirigerades.	HTTPStatusEvent
		responseHeaders : Array Svarsrubriken som svaret returnerade har en array med URLRequestHeader-objekt.	HTTPStatusEvent
		responseURL : String URL:en som svaret returnerades från.	HTTPStatusEvent
		status : int [skrivskyddad] Den HTTP-statuskod som returneras av servern.	HTTPStatusEvent
		target : Object [skrivskyddad] Händelsens mål.	Event
		type : String [skrivskyddad] Händelsens typ.	Event

Publika metoder

Dölj ärvda publika metoder

Visa ärvda publika metoder

	Metod		Definieras med
		HTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0, redirected:Boolean = false) Skapar ett nytt Event-objekt som innehåller specifik information om HTTP-statushändelser.	HTTPStatusEvent
		clone():Event [åsidosätt] Skapar en kopia av HTTPStatusEvent-objektet och ställer in värdet för alla egenskaper så att de matchar originalets egenskaper.	HTTPStatusEvent
		formatToString(className:String, ... arguments):String Ett verktyg som används för att implementera metoden toString() i de anpassade klasserna ActionScript 3.0.	Event
		hasOwnProperty(name:String):Boolean Anger om det finns en egenskap angiven för ett objekt.	Object
		isDefaultPrevented():Boolean Kontrollerar om preventDefault()-metoden har anropats för händelsen.	Event
		isPrototypeOf(theClass:Object):Boolean Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter.	Object
		preventDefault():void Avbryter en händelses standardbeteende om det beteendet kan avbrytas.	Event
		propertyIsEnumerable(name:String):Boolean Anger om den angivna egenskapen finns och är uppräkningsbar.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Anger tillgänglighet för en dynamisk egenskap för slingåtgärder.	Object
		stopImmediatePropagation():void Förhindrar behandling av händelsehanterare i den aktuella noden och alla noder som följer den aktuella noden i händelseflödet.	Event
		stopPropagation():void Förhindrar behandling av händelsehanterare i noder som följer den aktuella noden i händelseflödet.	Event
		toLocaleString():String Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner.	Object
		toString():String [åsidosätt] Returnerar en sträng som innehåller alla egenskaper i HTTPStatusEvent-objektet.	HTTPStatusEvent
		valueOf():Object Returnerar det angivna objektets primitiva värde.	Object

Publika konstanter

Dölj ärvda publika konstanter

Visa ärvda publika konstanter

	Konstant		Definieras med
		HTTP_RESPONSE_STATUS : String = "httpResponseStatus" [statisk] Till skillnad från httpStatus-händelsen levereras httpResponseStatus-händelsen innan eventuella svarsdata.	HTTPStatusEvent
		HTTP_STATUS : String = "httpStatus" [statisk] HTTPStatusEvent.HTTP_STATUS-konstanten definierar värdet på type-egenskapen i ett httpStatus-händelseobjekt.	HTTPStatusEvent

Egenskapsdetaljer

redirected

egenskap

redirected:Boolean

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 11.8, AIR 3.8

Anger om begäran omdirigerades.

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

Relaterade API-element

flash.net.URLRequest.useRedirectedURL()

responseHeaders

egenskap

responseHeaders:Array

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Lite 4

Svarsrubriken som svaret returnerade har en array med URLRequestHeader-objekt.

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

Relaterade API-element

flash.net.URLRequestHeader

responseURL

egenskap

responseURL:String

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Lite 4

URL:en som svaret returnerades från. Vid omdirigering kommer denna att vara en annan jämfört med den begärda URL:en.

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

status

egenskap

status:int [skrivskyddad]

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

Den HTTP-statuskod som returneras av servern. Värdet 404 innebär till exempel att servern inte hittade någon matchning för den begärda URL:en. HTTP-statuskoder finns i avsnitt 10.4 och 10.5 i HTTP-specifikationen på http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html.

Om Flash Player eller AIR inte får någon statuskod från servern eller om det inte går att kommunicera med servern, skickas standardvärdet 0 till din kod. Värdet 0 kan genereras i alla spelare (till exempel om en URL med felaktigt format begärs) och värdet 0 genereras alltid av Flash Player-plugin när den körs i följande webbläsare som inte skickar HTTP-statuskoder till spelaren: Netscape, Mozilla, Safari, Opera och Internet Explorer för Macintosh.

Implementering
public function get status():int

Konstruktordetaljer

()

Konstruktor

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

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

Skapar ett nytt Event-objekt som innehåller specifik information om HTTP-statushändelser. Event-objekt skickas som parametrar till händelseavlyssnare.

Parametrar

	`type:String` — Händelsens typ. Händelseavlyssnare kan hämta informationen genom den ärvda egenskapen `type`. Det finns bara en slags HTTPStatus-händelse: `HTTPStatusEvent.HTTP_STATUS`.

	`bubbles:Boolean` (default = `false`) — Bestämmer om Event-objektet deltar i bubblingssteget av händelseflödet. Händelseavlyssnare kan hämta informationen genom den ärvda egenskapen `bubbles`.

	`cancelable:Boolean` (default = `false`) — Avgör om Event-objektet kan avbrytas. Händelseavlyssnare kan hämta informationen genom den ärvda egenskapen `cancelable`.

	`status:int` (default = `0`) — Numerisk status. Händelseavlyssnare kan hämta informationen genom den ärvda egenskapen `status`.

	`redirected:Boolean` (default = `false`) — Om begäran har omdirigerats. Händelseavlyssnare kan hämta informationen genom egenskapen `redirected`.

Relaterade API-element

HTTP_STATUS

Metoddetaljer

clone

()

metod

override public function clone():Event

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

Skapar en kopia av HTTPStatusEvent-objektet och ställer in värdet för alla egenskaper så att de matchar originalets egenskaper.

Returnerar

Event — Ett nytt HTTPStatusEvent-objekt med egenskapsvärden som matchar originalet.

toString

()

metod

override public function toString():String

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

Returnerar en sträng som innehåller alla egenskaper i HTTPStatusEvent-objektet. Strängen är i följande format:

[HTTPStatusEvent type=värde bubbles=värde cancelable=värde status=värde]

Returnerar

String — En sträng som innehåller alla HTTPStatusEvent-objektets egenskaper.

Konstantdetaljer

HTTP_RESPONSE_STATUS

Konstant

public static const HTTP_RESPONSE_STATUS:String = "httpResponseStatus"

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Lite 4

Till skillnad från httpStatus-händelsen levereras httpResponseStatus-händelsen innan eventuella svarsdata. Dessutom inkluderar httpResponseStatus-händelsen värdena för responseHeaders och responseURL-egenskaperna (som är odefinierade i en httpStatus-händelse). Observera att httpResponseStatus-händelsen (om sådan finns) skickas före (och utöver) händelserna complete eller error.

HTTPStatusEvent.HTTP_RESPONSE_STATUS-konstanten definierar värdet på type-egenskapen i ett httpResponseStatus-händelseobjekt.

Den här händelsen har följande egenskaper:

Egenskap	Värde
`bubbles`	`false`
`cancelable`	`false`; det finns inget standardbeteende att avbryta.
`currentTarget`	Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
`responseURL`	URL:en som svaret returnerades från.
`responseHeaders`	Svarsrubriken som svaret returnerade har en array med URLRequestHeader-objekt.
`status`	Den HTTP-statuskod som returneras av servern.
`redirected`	Om svaret är resultatet av en omdirigering.
`target`	Nätverksobjektet tar emot en HTTP-statuskod.

Relaterade API-element

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

HTTP_STATUS

Konstant

public static const HTTP_STATUS:String = "httpStatus"

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

Konstanten HTTPStatusEvent.HTTP_STATUS definierar värdet på type-egenskapen i ett httpStatus-händelseobjekt.

Den här händelsen har följande egenskaper:

Egenskap	Värde
`bubbles`	`false`
`cancelable`	`false`; det finns inget standardbeteende att avbryta.
`currentTarget`	Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
`status`	Den HTTP-statuskod som returneras av servern.
`target`	Nätverksobjektet tar emot en HTTP-statuskod.

Relaterade API-element

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

Exempel Så här använder du exemplet

HTTPStatusEventExample.as

Följande exempel försöker läsa in en icke-existerande fil från webbkatalogens rot på http://www.[yourDomain].com som borde skicka en httpStatusHandler-händelse med en status på 404, vilket indikerar att det inte gick att hitta filen. httpStatusHandler-händelsen hanteras av httpStatusHandler(), som skriver ut två rader information om händelsen.

Obs!

Om du vill generera en securityError-händelse i det här exemplet måste du kompilera SWF-filen med "Lokal uppspelningssäkerhet" inställd på "Använd bara nätverket".
Det krävs att du har en server som körs på http://www.[yourDomain].com och avlyssnar port 80, annars får du en httpStatusHandler-händelse med statuskoden 0 istället för 404.
Du får inte ha en fil med namnet MissingFile.html på webbkatalogens rot på http://www.[yourDomain].com, annars kommer du inte att få korrekt httpStatusHandler-händelse.

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

Juridiska meddelanden | Onlinesekretesspolicy

HTTPStatusEvent - AS3

Klasser x

redirected

responseHeaders

responseURL

status