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):void
Powią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):void
status | 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():int
HTTPStatusEvent | () | 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
httpStatusHandler
bę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