Пакет | flash.events |
Класс | public class HTTPStatusEvent |
Наследование | HTTPStatusEvent Event Object |
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Объекты HTTPStatusEvent всегда отправляются перед событиями ошибок или выполнения. Объект HTTPStatusEvent не обязательно указывает на наличие ошибок; он просто отражает код состояния HTTP (если он есть), передаваемый сетевым стеком. Некоторые среды выполнения Flash Player не могут отслеживать коды состояния HTTP; в таких случаях всегда выдается код состояния 0.
В Flash Player существует только один тип события HTTPStatus: httpStatus
.В среде выполнения AIR есть возможность зарегистрировать FileReference, URLLoader или URLStream в качестве прослушивателей httpResponseStatus
, куда входят свойства responseURL
и responseHeaders
. В событии httpStatus
данные свойства имеют значение undefined.
Свойство | Определено | ||
---|---|---|---|
bubbles : Boolean [только для чтения]
Определяет, является ли событие событием восходящей цепочки. | Event | ||
cancelable : Boolean [только для чтения]
Указывает, можно ли предотвратить поведение, связанное с событием. | Event | ||
constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | ||
currentTarget : Object [только для чтения]
Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. | Event | ||
eventPhase : uint [только для чтения]
Текущая фаза в потоке событий. | Event | ||
redirected : Boolean
Указывает, выполняется ли перенаправление запроса. | HTTPStatusEvent | ||
responseHeaders : Array
Заголовки ответа, возвращаемые в ответе, представляют собой массив объектов URLRequestHeader. | HTTPStatusEvent | ||
responseURL : String
URL-адрес, с которого был получен ответ. | HTTPStatusEvent | ||
status : int [только для чтения]
Код состояния HTTP, возвращенный сервером. | HTTPStatusEvent | ||
target : Object [только для чтения]
Целевой объект события. | Event | ||
type : String [только для чтения]
Тип события. | Event |
Метод | Определено | ||
---|---|---|---|
HTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0, redirected:Boolean = false)
Создает объект Event, содержащий данные о событиях состояния HTTP. | HTTPStatusEvent | ||
[переопределить]
Создает копию объекта HTTPStatusEvent и задает значение каждого свойства, совпадающее с оригиналом. | HTTPStatusEvent | ||
Служебная функция для реализации метода toString() в пользовательских классах ActionScript 3.0 Event. | Event | ||
Показывает, определено ли заданное свойство для объекта. | Object | ||
Проверяет, выполнялся ли для события вызова метода preventDefault(). | Event | ||
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | ||
Отменяет поведение по умолчанию для события, если такое поведение можно отменить. | Event | ||
Показывает наличие заданного свойства и его перечисляемость. | Object | ||
Задает доступность динамического свойства для операций цикла. | Object | ||
Отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом. | Event | ||
Отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом. | Event | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | ||
[переопределить]
Возвращает строку, содержащую все свойства объекта HTTPStatusEvent. | HTTPStatusEvent | ||
Возвращает элементарное значение заданного объекта. | Object |
Константа | Определено | ||
---|---|---|---|
HTTP_RESPONSE_STATUS : String = "httpResponseStatus" [статические]
В отличии от события httpStatus, событие httpResponseStatus доставляется до получения данных ответа. | HTTPStatusEvent | ||
HTTP_STATUS : String = "httpStatus" [статические]
Константа HTTPStatusEvent.HTTP_STATUS определяет значение свойства type объекта события httpStatus. | HTTPStatusEvent |
redirected | свойство |
responseHeaders | свойство |
responseHeaders:Array
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Lite 4 |
Заголовки ответа, возвращаемые в ответе, представляют собой массив объектов URLRequestHeader.
Реализация
public function get responseHeaders():Array
public function set responseHeaders(value:Array):void
Связанные элементы API
responseURL | свойство |
responseURL:String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Lite 4 |
URL-адрес, с которого был получен ответ. При наличии перенаправлений данный адрес будет отличаться от URL-адреса, на который отправлен запрос.
Реализация
public function get responseURL():String
public function set responseURL(value:String):void
status | свойство |
status:int
[только для чтения] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Код состояния HTTP, возвращенный сервером. Например, значение 404 указывает на то, что сервер не нашел соответствия для запрашиваемого URI. Коды состояния HTTP можно найти в разделах 10.4 и 10.5 спецификации HTTP по адресу http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html.
Если Flash Player или AIR не удается получить код состояния от сервера или не удается установить связь с сервером, значение по умолчанию 0 передается в ваш код. Значение 0 может быть создано в любом проигрывателе (например, при запросе неправильного URL-адреса), и оно всегда создается подключаемым программным модулем Flash Player при его выполнении в следующих браузерах, которые не передают код состояния HTTP проигрывателю: Netscape, Mozilla, Safari, Opera и Internet Explorer для ОС Macintosh.
Реализация
public function get status():int
HTTPStatusEvent | () | Конструктор |
public function HTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0, redirected:Boolean = false)
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Создает объект Event, содержащий данные о событиях состояния HTTP. Объекты Event передаются прослушивателям событий в качестве параметров.
Параметрыtype:String — Тип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type . Существует только один тип события HTTPStatus: HTTPStatusEvent.HTTP_STATUS .
| |
bubbles:Boolean (default = false ) — Определяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles .
| |
cancelable:Boolean (default = false ) — Определяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable .
| |
status:int (default = 0 ) — Численный код состояния. Прослушиватели событий могут получать эту информацию через свойство status .
| |
redirected:Boolean (default = false ) — Выполняется ли перенаправление запроса. Прослушиватели событий могут получать эту информацию через свойство redirected .
|
Связанные элементы API
clone | () | метод |
override public function clone():Event
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Создает копию объекта HTTPStatusEvent и задает значение каждого свойства, совпадающее с оригиналом.
ВозвращаетEvent — Новый объект HTTPStatusEvent, значения свойств которого соответствуют значениям оригинала.
|
toString | () | метод |
override public function toString():String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Возвращает строку, содержащую все свойства объекта HTTPStatusEvent. Строка имеет следующий формат:
[HTTPStatusEvent type=value bubbles=value cancelable=value status=value]
String — Строка, содержащая все свойства объекта HTTPStatusEvent.
|
HTTP_RESPONSE_STATUS | Константа |
public static const HTTP_RESPONSE_STATUS:String = "httpResponseStatus"
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Lite 4 |
В отличии от события httpStatus
, событие httpResponseStatus
доставляется до получения данных ответа. Таким образом, в событие httpResponseStatus
входят значения свойств responseHeaders
и responseURL
(которые для события httpStatus
имеют значение undefined.) Обратите внимание на то, что httpResponseStatus
(при наличии такового) будет отправляться до (как дополнение) любого события complete
или error
.
Константа HTTPStatusEvent.HTTP_RESPONSE_STATUS
определяет значение свойства type
объекта события httpResponseStatus
.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
responseURL | URL-адрес, с которого был получен ответ. |
responseHeaders | Заголовки ответа, возвращаемые в ответе, представляют собой массив объектов URLRequestHeader. |
status | Код состояния HTTP, возвращенный сервером. |
redirected | Является ли ответ ли результатом перенаправления. |
target | Сетевой объект, получающий код состояния НТТР. |
Связанные элементы API
HTTP_STATUS | Константа |
public static const HTTP_STATUS:String = "httpStatus"
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Константа HTTPStatusEvent.HTTP_STATUS
определяет значение свойства type
объекта события httpStatus
.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
status | Код состояния HTTP, возвращенный сервером. |
target | Сетевой объект, получающий код состояния НТТР. |
Связанные элементы API
httpStatusHandler
с кодом состояния 404, указывающим на то, что файл не найден. Событие httpStatusHandler
обрабатывается методом httpStatusHandler()
, который просто печатает две строки сведений о событии.
Примечания.
- SWF-файл необходимо компилировать с параметром «Безопасность локального воспроизведения» в значении «Доступ только к сети», чтобы генерировать событие
securityError
в этом примере. - Для реализации примера нужен сервер в домене http://www.[yourDomain].com, прослушивающий порт 80, иначе событие
httpStatusHandler
будет отправлено с кодом состояния 0 вместо 404. - Не должно быть файла с именем MissingFile.html в корневом web-каталоге домена http://www.[yourDomain].com, иначе не будет отправлено требуемое событие
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, 11:34 AM Z