| Pakiet | flash.events |
| Klasa | public class HTTPStatusEvent |
| Dziedziczenie | HTTPStatusEvent Event Object |
| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Obiekty HTTPStatusEvent są wysyłane zawsze przed zdarzeniami błędu lub ukończenia. Wysłanie obiektu HTTPStatusEvent nie musi oznaczać błędu; stanowi jedynie odzwierciedlenie kodu stanu HTTP (jeśli jest dostępny) udostępnionego przez stos sieciowy. W niektórych środowiskach działania programu Flash Player nie jest możliwe wykrywanie kodów stanu HTTP; w takich przypadkach zawsze zgłaszany jest kod stanu 0.
W programie Flash Player istnieje tylko jeden typ zdarzenia HTTPStatus: httpStatus. W środowisku wykonawczym AIR obiekty FileReference, URLLoader URLStream mogą zarejestrować się jako detektory zdarzeń httpResponseStatus, których obiekty zawierają właściwości responseURL i responseHeaders. Te właściwości są niezdefiniowane w zdarzeniu httpStatus.
| Właściwość | Zdefiniowane przez | ||
|---|---|---|---|
![]() | bubbles : Boolean [tylko do odczytu]
Określa, czy zdarzenie może przechodzić fazę propagacji. | Event | |
![]() | cancelable : Boolean [tylko do odczytu]
Wskazuje, czy można uniemożliwić operacje skojarzone ze zdarzeniem. | Event | |
![]() | constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | |
![]() | currentTarget : Object [tylko do odczytu]
Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. | Event | |
![]() | eventPhase : uint [tylko do odczytu]
Bieżąca faza przepływu zdarzeń. | Event | |
| redirected : Boolean
Wskazuje, czy żądanie zostało przekierowane. | HTTPStatusEvent | ||
| responseHeaders : Array
Nagłówki zwróconej odpowiedzi w postaci tablicy obiektów URLRequestHeader. | HTTPStatusEvent | ||
| responseURL : String
Adres URL, z którego została zwrócona odpowiedź. | HTTPStatusEvent | ||
| status : int [tylko do odczytu]
Zwrócony przez serwer kod stanu HTTP. | HTTPStatusEvent | ||
![]() | target : Object [tylko do odczytu]
Miejsce docelowe zdarzenia. | Event | |
![]() | type : String [tylko do odczytu]
Typ zdarzenia. | Event | |
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
HTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0, redirected:Boolean = false)
Tworzy obiekt Event, który zawiera określone informacje o zdarzeniach dotyczących stanu HTTP. | HTTPStatusEvent | ||
[przesłanianie]
Tworzy kopię obiektu HTTPStatusEvent i ustawia wartości poszczególnych właściwości zgodnie z właściwościami oryginału. | HTTPStatusEvent | ||
![]() |
Funkcja narzędziowa umożliwiająca implementację metody toString() w niestandardowych klasach Event w języku ActionScript 3.0. | Event | |
![]() |
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | |
![]() |
Sprawdza, czy w odniesieniu do tego zdarzenia wywołano metodę preventDefault(). | Event | |
![]() |
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | |
![]() |
Anuluje domyślne ustawienia zdarzenia, o ile zachowanie to może być anulowane. | Event | |
![]() |
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | |
![]() |
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | |
![]() |
Zapobiega przetwarzaniu wszelkich detektorów zdarzeń w węźle bieżącym i węzłach następujących po nim. | Event | |
![]() |
Zapobiega przetwarzaniu wszelkich detektorów zdarzeń w węzłach następujących po węźle bieżącym w przepływie zdarzeń. | Event | |
![]() |
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | |
[przesłanianie]
Zwraca ciąg znaków, który zawiera wszystkie właściwości obiektu HTTPStatusEvent. | HTTPStatusEvent | ||
![]() |
Zwraca pierwotną wartość dla określonego obiektu. | Object | |
| Stała | Zdefiniowane przez | ||
|---|---|---|---|
| HTTP_RESPONSE_STATUS : String = "httpResponseStatus" [statyczny]
W przeciwieństwie do zdarzenia httpStatus, zdarzenie httpResponseStatus jest dostarczane przed danymi odpowiedzi. | HTTPStatusEvent | ||
| HTTP_STATUS : String = "httpStatus" [statyczny]
Stała HTTPStatusEvent.HTTP_STATUS definiuje wartość właściwości type obiektu zdarzenia httpStatus. | HTTPStatusEvent | ||
redirected | właściwość |
responseHeaders | właściwość |
responseHeaders:Array| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Lite 4 |
Nagłówki zwróconej odpowiedzi w postaci tablicy obiektów URLRequestHeader.
Implementacja
public function get responseHeaders():Array public function set responseHeaders(value:Array):voidPowiązane elementy interfejsu API
responseURL | właściwość |
responseURL:String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Lite 4 |
Adres URL, z którego została zwrócona odpowiedź. W przypadku przekierowań będzie on inny niż żądany adres URL.
Implementacja
public function get responseURL():String public function set responseURL(value:String):voidstatus | właściwość |
status:int [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Zwrócony przez serwer kod stanu HTTP. Na przykład wartość 404 oznacza, że serwer nie znalazł zasobu zgodnego z żądanym identyfikatorem URI. Kody stanu HTTP można znaleźć w sekcjach 10.4 i 10.5 specyfikacji protokołu HTTP pod adresem http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html.
Jeśli program Flash Player lub środowisko wykonawcze AIR nie może uzyskać kodu stanu z serwera lub jeśli nie może skomunikować się z serwerem, do kodu użytkownika przekazywana jest wartość domyślna 0. Wartość 0 może zostać wygenerowana w każdym odtwarzaczu (na przykład w razie przekazania w żądaniu niepoprawnie zbudowanego adresu), a ponadto wartość ta jest zawsze generowana przez wtyczkę Flash Player w następujących przeglądarkach, które nie przekazują kodów stanu HTTP do odtwarzacza: Netscape, Mozilla, Safari, Opera i Internet Explorer dla komputerów Macintosh.
Implementacja
public function get status():intHTTPStatusEvent | () | Konstruktor |
public function HTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0, redirected:Boolean = false)| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Tworzy obiekt Event, który zawiera określone informacje o zdarzeniach dotyczących stanu HTTP. Obiekty Event są przekazywane jako parametry do detektorów zdarzeń.
Parametrytype:String — Typ zdarzenia. Detektory zdarzeń mogą uzyskiwać dostęp do tej informacji za pośrednictwem dziedziczonej właściwości type. Istnieje tylko jeden typ zdarzenia HTTPStatus: HTTPStatusEvent.HTTP_STATUS.
| |
bubbles:Boolean (default = false) — Określa, czy obiekt Event uczestniczy w etapie propagacji przepływu zdarzeń. Detektory zdarzeń mogą uzyskiwać dostęp do tej informacji za pośrednictwem dziedziczonej właściwości bubbles.
| |
cancelable:Boolean (default = false) — Określa, czy obiekt Event może zostać anulowany. Detektory zdarzeń mogą uzyskiwać dostęp do tej informacji za pośrednictwem dziedziczonej właściwości cancelable.
| |
status:int (default = 0) — Stan w postaci liczbowej. Detektory zdarzeń mogą uzyskiwać dostęp do tej informacji za pośrednictwem właściwości status.
| |
redirected:Boolean (default = false) — Czy żądanie zostało przekierowane. Detektory zdarzeń mogą uzyskiwać dostęp do tej informacji za pośrednictwem właściwości redirected.
|
Powiązane elementy interfejsu API
clone | () | metoda |
override public function clone():Event| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Tworzy kopię obiektu HTTPStatusEvent i ustawia wartości poszczególnych właściwości zgodnie z właściwościami oryginału.
ZwracaEvent — Nowy obiekt HTTPStatusEvent z wartościami właściwości zgodnymi z oryginałem.
|
toString | () | metoda |
override public function toString():String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Zwraca ciąg znaków, który zawiera wszystkie właściwości obiektu HTTPStatusEvent. Format ciągu znaków jest następujący:
[HTTPStatusEvent type=wartość bubbles=wartość cancelable=wartość status=wartość]
String — Ciąg znaków, który zawiera wszystkie właściwości obiektu HTTPStatusEvent.
|
HTTP_RESPONSE_STATUS | Stała |
public static const HTTP_RESPONSE_STATUS:String = "httpResponseStatus"| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Lite 4 |
W przeciwieństwie do zdarzenia httpStatus, zdarzenie httpResponseStatus jest dostarczane przed danymi odpowiedzi. Ponadto zdarzenia httpResponseStatus zawiera wartości właściwości responseHeaders i responseURL (niezdefiniowane w przypadku zdarzenia httpStatus). Należy zauważyć, że ewentualne zdarzenie httpResponseStatus zostanie wysłane przed (i oprócz) wszelkich zdarzeń ukończenia lubbłędu.
Stała HTTPStatusEvent.HTTP_RESPONSE_STATUS definiuje wartość właściwości type obiektu zdarzenia httpResponseStatus.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
bubbles | false |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
responseURL | Adres URL, z którego została zwrócona odpowiedź. |
responseHeaders | Nagłówki zwróconej odpowiedzi w postaci tablicy obiektów URLRequestHeader. |
status | Zwrócony przez serwer kod stanu HTTP. |
redirected | Czy odpowiedź jest wynikiem przekierowania. |
target | Obiekt sieciowy odbierający kod stanu HTTP. |
Powiązane elementy interfejsu API
HTTP_STATUS | Stała |
public static const HTTP_STATUS:String = "httpStatus"| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Stała HTTPStatusEvent.HTTP_STATUS definiuje wartość type właściwości obiektu zdarzenia httpStatus.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
bubbles | false |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
status | Zwrócony przez serwer kod stanu HTTP. |
target | Obiekt sieciowy odbierający kod stanu HTTP. |
Powiązane elementy interfejsu API
httpStatusHandler ze stanem 404 oznaczającym, że plik nie został znaleziony. Zdarzenie httpStatusHandler jest obsługiwane przez metodę httpStatusHandler(), która drukuje dwa wiersze z informacjami o zdarzeniu.
Uwagi:
- Aby w tym przykładzie zostało wygenerowane zdarzenie
securityError, plik SWF musi być skompilowany z opcją „Zabezpieczenie odtwarzania lokalnego” ustawioną na wartość „Tylko sieć lokalna”. - Potrzebny jest także serwer działający pod adresem http://www.[yourDomain].com i nasłuchujący na porcie 80. W razie braku takiego serwera odebrane zdarzenie
httpStatusHandlerbędzie zawierało kod 0, a nie 404. - W katalogu głównym witryny http://www.[yourDomain].com nie może istnieć plik MissingFile.html. W przeciwnym razie nie zostanie odebrane prawidłowe zdarzenie
httpStatusHandler.
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, 12:06 PM Z
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne