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

HTTPStatusEvent  - AS3

Пакет flash.events

Интерфейсы
IEventDispatcher
 
Классы
AccelerometerEvent
ActivityEvent
AsyncErrorEvent
AudioOutputChangeEvent
AVDictionaryDataEvent
AVHTTPStatusEvent
AVPauseAtPeriodEndEvent
BrowserInvokeEvent    
ContextMenuEvent
DataEvent
DatagramSocketDataEvent    
DeviceRotationEvent    
DNSResolverEvent    
DRMAuthenticateEvent    
DRMAuthenticationCompleteEvent
DRMAuthenticationErrorEvent
DRMDeviceGroupErrorEvent
DRMDeviceGroupEvent
DRMErrorEvent
DRMLicenseRequestEvent
DRMMetadataEvent
DRMReturnVoucherCompleteEvent
DRMReturnVoucherErrorEvent
DRMStatusEvent
ErrorEvent
Event
EventDispatcher
EventPhase
FileListEvent    
FocusEvent
FullScreenEvent
GameInputEvent    
GeolocationEvent
GestureEvent
GesturePhase
HTMLUncaughtScriptExceptionEvent    
HTTPStatusEvent
IMEEvent
InvokeEvent    
IOErrorEvent
KeyboardEvent
LocationChangeEvent    
MediaEvent    
MouseEvent
NativeDragEvent    
NativeProcessExitEvent    
NativeWindowBoundsEvent    
NativeWindowDisplayStateEvent    
NetDataEvent
NetMonitorEvent
NetStatusEvent
OutputProgressEvent    
PermissionEvent
PressAndTapGestureEvent
ProgressEvent
RemoteNotificationEvent    
SampleDataEvent
ScreenMouseEvent    
SecurityErrorEvent
ServerSocketConnectEvent    
ShaderEvent
SoftKeyboardEvent
SoftKeyboardTrigger
SQLErrorEvent    
SQLEvent    
SQLUpdateEvent    
StageOrientationEvent    
StageVideoAvailabilityEvent
StageVideoEvent
StatusEvent
StorageVolumeChangeEvent    
SyncEvent
TextEvent
ThrottleEvent
ThrottleType
TimerEvent
TouchEvent
TouchEventIntent    
TransformGestureEvent
UncaughtErrorEvent
UncaughtErrorEvents
VideoEvent
VideoTextureEvent
VsyncStateChangeAvailabilityEvent    
Пакетflash.events
Классpublic class HTTPStatusEvent
НаследованиеHTTPStatusEvent Inheritance Event Inheritance Object

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

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

Объекты HTTPStatusEvent всегда отправляются перед событиями ошибок или выполнения. Объект HTTPStatusEvent не обязательно указывает на наличие ошибок; он просто отражает код состояния 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
  redirected : Boolean
Указывает, выполняется ли перенаправление запроса.
HTTPStatusEvent
  responseHeaders : Array
Заголовки ответа, возвращаемые в ответе, представляют собой массив объектов URLRequestHeader.
HTTPStatusEvent
  responseURL : String
URL-адрес, с которого был получен ответ.
HTTPStatusEvent
  status : int
[только для чтения] Код состояния HTTP, возвращенный сервером.
HTTPStatusEvent
 Inheritedtarget : Object
[только для чтения] Целевой объект события.
Event
 Inheritedtype : String
[только для чтения] Тип события.
Event
Общедоступные методы
 МетодОпределено
  
HTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0, redirected:Boolean = false)
Создает объект Event, содержащий данные о событиях состояния HTTP.
HTTPStatusEvent
  
[переопределить] Создает копию объекта HTTPStatusEvent и задает значение каждого свойства, совпадающее с оригиналом.
HTTPStatusEvent
 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
  
[переопределить] Возвращает строку, содержащую все свойства объекта HTTPStatusEvent.
HTTPStatusEvent
 Inherited
Возвращает элементарное значение заданного объекта.
Object
Общедоступные константы
 КонстантаОпределено
  HTTP_RESPONSE_STATUS : String = "httpResponseStatus"
[статические] В отличии от события httpStatus, событие httpResponseStatus доставляется до получения данных ответа.
HTTPStatusEvent
  HTTP_STATUS : String = "httpStatus"
[статические] Константа HTTPStatusEvent.HTTP_STATUS определяет значение свойства type объекта события httpStatus.
HTTPStatusEvent
Сведения о свойстве

redirected

свойство
redirected:Boolean

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 11.8, AIR 3.8

Указывает, выполняется ли перенаправление запроса.



Реализация
    public function get redirected():Boolean
    public function set redirected(value:Boolean):void

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

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.

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

СвойствоЗначение
bubblesfalse
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
responseURLURL-адрес, с которого был получен ответ.
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.

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

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

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

HTTPStatusEventExample.as

В следующем примере предпринимается попытка загрузить несуществующий файл из корневого web-каталога http://www.[yourDomain].com, в результате чего должно быть передано событие httpStatusHandler с кодом состояния 404, указывающим на то, что файл не найден. Событие httpStatusHandler обрабатывается методом httpStatusHandler(), который просто печатает две строки сведений о событии.

Примечания.

  1. SWF-файл необходимо компилировать с параметром «Безопасность локального воспроизведения» в значении «Доступ только к сети», чтобы генерировать событие securityError в этом примере.
  2. Для реализации примера нужен сервер в домене http://www.[yourDomain].com, прослушивающий порт 80, иначе событие httpStatusHandler будет отправлено с кодом состояния 0 вместо 404.
  3. Не должно быть файла с именем 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);
        }
    }
}




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

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