| Paket | flash.events |
| Klasse | public class HTTPStatusEvent |
| Vererbung | HTTPStatusEvent  Event Object |
| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
HTTPStatusEvent-Objekte werden immer vor Fehler- oder Abschlussereignissen gesendet. Ein HTTPStatusEvent-Objekt muss nicht unbedingt auf einen Fehlerzustand hinweisen; es reflektiert einfach den HTTP-Statuscode (sofern vorhanden), der vom Netzwerkstapel bereitgestellt wird. Einige Flash Player-Umgebungen sind eventuell nicht in der Lage, HTTP-Statuscodes zu erfassen; in diesen Fällen wird immer ein Statuscode 0 gemeldet.
In Flash Player gibt es nur einen Typ HTTPStatus-Ereignis: httpStatus. In der AIR-Laufzeitumgebung kann ein FileReference, URLLoader oder URLStream registriert werden, um auf httpResponseStatus zu warten, wozu die Eigenschaften responseURL und responseHeaders gehören. Diese Eigenschaften sind in einem httpStatus-Ereignis nicht definiert.
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
 | bubbles : Boolean [schreibgeschützt]
Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt. | Event | |
| cancelable : Boolean [schreibgeschützt]
Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann. | Event | |
| constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| currentTarget : Object [schreibgeschützt]
Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. | Event | |
| eventPhase : uint [schreibgeschützt]
Die aktuelle Phase im Ereignisablauf. | Event | |
| redirected : Boolean
Gibt an, ob die Anforderung weitergeleitet wurde. | HTTPStatusEvent | ||
| responseHeaders : Array
Die Antwortheader, die die Antwort zurückgegeben hat, als Array von URLRequestHeader-Objekten. | HTTPStatusEvent | ||
| responseURL : String
Die URL, von der die Antwort zurückgegeben wurde. | HTTPStatusEvent | ||
| status : int [schreibgeschützt]
Der vom Server zurückgegebene HTTP-Statuscode. | HTTPStatusEvent | ||
| target : Object [schreibgeschützt]
Das Ereignis-Ziel. | Event | |
| type : String [schreibgeschützt]
Der Ereignistyp. | Event | |
| Methode | Definiert von | ||
|---|---|---|---|
HTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0, redirected:Boolean = false)
Erstellt ein Ereignisobjekt, das Informationen über HTTP-Status-Ereignisse enthält. | HTTPStatusEvent | ||
[override]
Erstellt eine Kopie des HTTPStatusEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. | HTTPStatusEvent | ||
|
Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen. | Event | |
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
|
Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde. | Event | |
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
|
Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann. | Event | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen. | Event | |
|
Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen. | Event | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
[override]
Gibt eine Zeichenfolge zurück, die alle Eigenschaften des HTTPStatusEvent-Objekts enthält. | HTTPStatusEvent | ||
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
| Konstante | Definiert von | ||
|---|---|---|---|
| HTTP_RESPONSE_STATUS : String = "httpResponseStatus" [statisch]
Anders als das httpStatus-Ereignis wird das httpResponseStatus-Ereignis ausgelöst, bevor Antwortdaten vorliegen. | HTTPStatusEvent | ||
| HTTP_STATUS : String = "httpStatus" [statisch]
Die HTTPStatusEvent.HTTP_STATUS-Konstante definiert den Wert der type-Eigenschaft eines httpStatus-Ereignisobjekts. | HTTPStatusEvent | ||
redirected | Eigenschaft |
responseHeaders | Eigenschaft |
responseHeaders:Array| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Lite 4 |
Die Antwortheader, die die Antwort zurückgegeben hat, als Array von URLRequestHeader-Objekten.
Implementierung
public function get responseHeaders():Array public function set responseHeaders(value:Array):voidVerwandte API-Elemente
responseURL | Eigenschaft |
responseURL:String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Lite 4 |
Die URL, von der die Antwort zurückgegeben wurde. Bei Umleitungen ist dies eine andere URL als die Anforderungs-URL.
Implementierung
public function get responseURL():String public function set responseURL(value:String):voidstatus | Eigenschaft |
status:int [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Der vom Server zurückgegebene HTTP-Statuscode. So zeigt der Wert 404 beispielsweise an, dass der Server den angeforderten URI nicht gefunden hat. HTTP-Statuscodes finden Sie in den Abschnitten 10.4 und 10.5 der HTTP-Spezifikation unter http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html.
Wenn Flash Player oder AIR keinen Statuscode vom Server erhält oder keine Verbindung herstellen kann, wird der Standardwert 0 (null) an den Code übergeben. Dieser Wert kann von jedem Player generiert werden (wenn beispielsweise eine fehlerhafte URL angefordert wird). Er wird aber in jedem Fall vom Flash Player Plug-In generiert, wenn es in einem der folgenden Browser ausgeführt wird, die dem Player grundsätzlich keine HTTP-Statuscodes übergeben: Netscape, Mozilla, Safari, Opera und Internet Explorer für Macintosh.
Implementierung
public function get status():intHTTPStatusEvent | () | Konstruktor |
public function HTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0, redirected:Boolean = false)| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Erstellt ein Ereignisobjekt, das Informationen über HTTP-Status-Ereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben.
Parametertype:String — Der Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. Es gibt nur einen Typ eines HTTPStatus-Ereignisses: HTTPStatusEvent.HTTP_STATUS.
| |
bubbles:Boolean (default = false)bubbles auf diese Informationen zugreifen.
| |
cancelable:Boolean (default = false)cancelable auf diese Informationen zugreifen.
| |
status:int (default = 0)status auf diese Informationen zugreifen.
| |
redirected:Boolean (default = false)redirected auf diese Informationen zugreifen.
|
Verwandte API-Elemente
clone | () | Methode |
override public function clone():Event| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Erstellt eine Kopie des HTTPStatusEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.
RückgabewerteEvent — Ein neues HTTPStatusEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen.
|
toString | () | Methode |
override public function toString():String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt eine Zeichenfolge zurück, die alle Eigenschaften des HTTPStatusEvent-Objekts enthält. Der String liegt im folgenden Format vor:
[HTTPStatusEvent type=Wert bubbles=Wert cancelable=Wert status=Wert]
String — Eine Zeichenfolge, die alle Eigenschaften des HTTPStatusEvent-Objekts enthält.
|
HTTP_RESPONSE_STATUS | Konstante |
public static const HTTP_RESPONSE_STATUS:String = "httpResponseStatus"| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Lite 4 |
Anders als das httpStatus-Ereignis wird das httpResponseStatus-Ereignis ausgelöst, bevor Antwortdaten vorliegen. Außerdem enthält das httpResponseStatus-Ereignis Werte für die Eigenschaften responseHeaders und responseURL (die für ein httpStatus-Ereignis nicht definiert sind). Beachten Sie, dass das Ereignis httpResponseStatus (falls vorhanden) vor (und zusätzlich zu) jedem complete- oder error-Ereignis gesendet wird.
Die HTTPStatusEvent.HTTP_RESPONSE_STATUS-Konstante definiert den Wert der type-Eigenschaft eines httpResponseStatus-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
responseURL | Die URL, von der die Antwort zurückgegeben wurde. |
responseHeaders | Die Antwortheader, die die Antwort zurückgegeben hat, als Array von URLRequestHeader-Objekten. |
status | Der vom Server zurückgegebene HTTP-Statuscode. |
redirected | Gibt an, ob die Antwort das Ergebnis einer Weiterleitung ist. |
target | Das Netzwerkobjekt, das den HTTP-Statuscode empfängt. |
Verwandte API-Elemente
HTTP_STATUS | Konstante |
public static const HTTP_STATUS:String = "httpStatus"| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Die HTTPStatusEvent.HTTP_STATUS-Konstante definiert den Wert der type-Eigenschaft eines httpStatus-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
status | Der vom Server zurückgegebene HTTP-Statuscode. |
target | Das Netzwerkobjekt, das den HTTP-Statuscode empfängt. |
Verwandte API-Elemente
httpStatusHandler-Ereignis mit Status 404 ausgelöst werden, der darauf hinweist, dass die Datei nicht gefunden wurde. Das Ereignis httpStatusHandler wird von der Methode httpStatusHandler() bearbeitet, mit der zwei Zeilen mit Informationen zum Ereignis gedruckt werden.
Hinweise:
- Um in diesem Beispiel ein
securityError-Ereignis zu generieren, müssen Sie bei der Kompilierung der SWF-Datei die Einstellung „Sicherheit bei lokaler Wiedergabe“ auf „Nur auf Netzwerk zugreifen“ setzen. - Sie benötigen einen Server, der auf http://www.[yourDomain].com ausgeführt wird und Port 80 überwacht. Ansonsten erhalten Sie ein
httpStatusHandler-Ereignis mit Statuscode 0 statt 404. - Es darf sich keine Datei mit dem Namen "MissingFile.html" im Stammverzeichnis des Webservers unter http://www.[yourDomain].com befinden. Ansonsten wird nicht das richtige
httpStatusHandler-Ereignis empfangen.
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);
}
}
}
Tue Jun 12 2018, 10:04 AM Z