Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: Получение данных с сервера...
Получение данных с сервера...
flash.events 

AVHTTPStatusEvent  - AS3

Пакетflash.events
Классpublic class AVHTTPStatusEvent
НаследованиеAVHTTPStatusEvent Inheritance Event Inheritance Object

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Приложение отправляет объекты AVHTTPStatusEvent, когда сетевой запрос возвращает код состояния HTTP.

Объекты AVHTTPStatusEvent всегда отправляются перед событиями ошибок или выполнения. Объект AVHTTPStatusEvent не обязательно указывает на наличие ошибок; он просто отражает код состояния HTTP (если он есть), передаваемый сетевым стеком. Некоторые среды выполнения Flash Player не могут отслеживать коды состояния HTTP; в таких случаях всегда выдается код состояния 0.

В Flash Player существует только один тип события HTTPStatus: httpStatus.В среде выполнения AIR есть возможность зарегистрировать FileReference, URLLoader или URLStream в качестве прослушивателей httpResponseStatus, куда входят свойства responseURL и responseHeaders. В событии httpStatus данные свойства имеют значение undefined.



Общедоступные свойства
 СвойствоОпределено
 Inheritedbubbles : Boolean
[только для чтения] Определяет, является ли событие событием восходящей цепочки.
Event
 Inheritedcancelable : Boolean
[только для чтения] Указывает, можно ли предотвратить поведение, связанное с событием.
Event
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
 InheritedcurrentTarget : Object
[только для чтения] Объект, активно обрабатывающий объект Event с помощью прослушивателя событий.
Event
 InheritedeventPhase : uint
[только для чтения] Текущая фаза в потоке событий.
Event
  responseHeaders : Array
Заголовки ответа, возвращаемые в ответе, представляют собой массив объектов URLRequestHeader.
AVHTTPStatusEvent
  responseURL : String
URL-адрес, с которого был получен ответ.
AVHTTPStatusEvent
  status : int
[только для чтения] Код состояния HTTP, возвращенный сервером.
AVHTTPStatusEvent
 Inheritedtarget : Object
[только для чтения] Целевой объект события.
Event
 Inheritedtype : String
[только для чтения] Тип события.
Event
Общедоступные методы
 МетодОпределено
  
AVHTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0, responseUrl:String = null, responseHeaders:Array = null)
Создает объект Event, содержащий данные о событиях состояния HTTP.
AVHTTPStatusEvent
  
[переопределить] Создает копию объекта AVHTTPStatusEvent и задает значение каждого свойства, совпадающее с оригиналом.
AVHTTPStatusEvent
 Inherited
formatToString(className:String, ... arguments):String
Служебная функция для реализации метода toString() в пользовательских классах ActionScript 3.0 Event.
Event
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Проверяет, выполнялся ли для события вызова метода preventDefault().
Event
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Отменяет поведение по умолчанию для события, если такое поведение можно отменить.
Event
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом.
Event
 Inherited
Отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом.
Event
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
  
[переопределить] Возвращает строку, содержащую все свойства объекта AVHTTPStatusEvent.
AVHTTPStatusEvent
 Inherited
Возвращает элементарное значение заданного объекта.
Object
Общедоступные константы
 КонстантаОпределено
  AV_HTTP_RESPONSE_STATUS : String = "avHttpResponseStatus"
[статические] В отличии от события httpStatus, событие httpResponseStatus доставляется до получения данных ответа.
AVHTTPStatusEvent
Сведения о свойстве

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
Сведения о конструкторе

AVHTTPStatusEvent

()Конструктор
public function AVHTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0, responseUrl:String = null, responseHeaders:Array = null)

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Создает объект Event, содержащий данные о событиях состояния HTTP. Объекты Event передаются прослушивателям событий в качестве параметров.

Параметры
type:String — Тип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type. Существует только один тип события HTTPStatus: AVHTTPStatusEvent.HTTP_STATUS.
 
bubbles:Boolean (default = false) — Определяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles.
 
cancelable:Boolean (default = false) — Определяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable.
 
status:int (default = 0) — Численный код состояния. Прослушиватели событий могут получать эту информацию через свойство status.
 
responseUrl:String (default = null)
 
responseHeaders:Array (default = null)

Связанные элементы API

Сведения о методе

clone

()метод
override public function clone():Event

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Создает копию объекта AVHTTPStatusEvent и задает значение каждого свойства, совпадающее с оригиналом.

Возвращает
Event — Новый объект AVHTTPStatusEvent, значения свойств которого соответствуют значениям оригинала.

toString

()метод 
override public function toString():String

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Возвращает строку, содержащую все свойства объекта AVHTTPStatusEvent. Строка имеет следующий формат:

[AVHTTPStatusEvent type=value bubbles=value cancelable=value status=value]

Возвращает
String — Строка, содержащая все свойства объекта AVHTTPStatusEvent.
Сведения о константе

AV_HTTP_RESPONSE_STATUS

Константа
public static const AV_HTTP_RESPONSE_STATUS:String = "avHttpResponseStatus"

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Lite 4

В отличии от события httpStatus, событие httpResponseStatus доставляется до получения данных ответа. Таким образом, в событие httpResponseStatus входят значения свойств responseHeaders и responseURL (которые для события httpStatus имеют значение undefined.) Обратите внимание на то, что httpResponseStatus (при наличии такового) будет отправляться до (как дополнение) любого события complete или error.

Константа AVHTTPStatusEvent.HTTP_RESPONSE_STATUS определяет значение свойства type объекта события httpResponseStatus.

Это событие имеет следующие свойства:

СвойствоЗначение
bubblesfalse
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
responseURLURL-адрес, с которого был получен ответ.
responseHeadersЗаголовки ответа, возвращаемые в ответе, представляют собой массив объектов URLRequestHeader.
statusКод состояния HTTP, возвращенный сервером.
targetСетевой объект, получающий код состояния НТТР.

Связанные элементы API





[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.