Пакет | flash.net |
Класс | public class URLStream |
Наследование | URLStream EventDispatcher Object |
Реализует | IDataInput |
Подклассы | AVURLStream |
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Операции чтения в URLStream не являются блокирующими. Это означает, что перед тем как считать данные, необходимо с помощью свойства bytesAvailable
определить, доступен ли необходимый объем этих данных. Исключение EOFError
создается при наличии неполных данных.
По умолчанию все двоичные данные кодируются в формате обратного порядка файлов (сначала передается наиболее значимый байт).
Правила безопасности, применяемые к загрузке URL-адресов с классом URLStream, идентичны правилам, применяемым в отношении объектов URLLoader. При необходимости можно загрузить файлы правил. Применяются локальные правила безопасности файлов, предупреждения о нарушении безопасности появляются по мере необходимости.
Связанные элементы API
Свойство | Определено | ||
---|---|---|---|
bytesAvailable : uint [только для чтения]
Возвращает число байтов данных, доступных для чтения во входном буфере. | URLStream | ||
connected : Boolean [только для чтения]
Определяет, подключен ли в настоящий момент данный объект URLStream. | URLStream | ||
constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | ||
endian : String
Указывает порядок байтов для данных. | URLStream | ||
objectEncoding : uint
Управляет версией AMF, используемой при записи или чтении объекта. | URLStream |
Метод | Определено | ||
---|---|---|---|
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | ||
Немедленно закрывает поток и отменяет операцию загрузки. | URLStream | ||
Посылает событие в поток событий. | EventDispatcher | ||
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | ||
Показывает, определено ли заданное свойство для объекта. | Object | ||
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | ||
Начинает загрузку URL-адреса, указанного в параметре request. | URLStream | ||
Показывает наличие заданного свойства и его перечисляемость. | Object | ||
Считывает из потока логическое значение. | URLStream | ||
Считывает из потока байт со знаком. | URLStream | ||
Считывает из потока число байт данных. | URLStream | ||
Считывает из потока число IEEE 754 с двойной точностью и плавающей запятой. | URLStream | ||
Считывает из потока число IEEE 754 с одинарной точностью и плавающей запятой. | URLStream | ||
Считывает из потока 32-разрядное целое число со знаком. | URLStream | ||
Считывает из потока байтов многобайтовую строку заданной длины с использованием заданного набора знаков. | URLStream | ||
readObject():*
Считывает объект из сокета, зашифрованного в формат AMF. | URLStream | ||
Считывает из потока 16-разрядное целое число со знаком. | URLStream | ||
Считывает из потока байтов без знака. | URLStream | ||
Считывает из потока 32-разрядное целое число без знака. | URLStream | ||
Считывает из потока 16-разрядное целое число без знака. | URLStream | ||
Считывает из потока строку UTF-8. | URLStream | ||
Считывает из потока последовательность байт UTF-8 и возвращает строку. | URLStream | ||
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | ||
Задает доступность динамического свойства для операций цикла. | Object | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | ||
Возвращает строковое представление заданного объекта. | Object | ||
Возвращает элементарное значение заданного объекта. | Object | ||
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher |
Событие | Сводка | Определено | ||
---|---|---|---|---|
[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным. | EventDispatcher | |||
Отправляется после успешной загрузки данных. | URLStream | |||
[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным. | EventDispatcher | |||
Отправляется, если вызов метода URLStream.load() пытается обратиться к данным через HTTP и Adobe AIR может обнаружить и вернуть код состояния для запроса. | URLStream | |||
Отправляется, если вызов метода URLStream.load() пытается обратиться к данным по протоколу HTTP, а Flash Player или приложение Adobe AIR может определить и вернуть код состояния для запроса. | URLStream | |||
Отправляется, когда происходит ошибка ввода-вывода, приводящая к сбою операции загрузки. | URLStream | |||
Отправляется при запуске операции загрузки. | URLStream | |||
Отправляется в случае получения данных в ходе операции загрузки. | URLStream | |||
Отправляется, если путем вызова метода URLStream.load() предпринимается попытка загрузить данные с сервера, расположенного за пределами изолированной среды. | URLStream |
bytesAvailable | свойство |
bytesAvailable:uint
[только для чтения] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Возвращает число байтов данных, доступных для чтения во входном буфере. В вашем коде должен быть вызов свойства bytesAvailable
, проверяющий доступность необходимого объема данных до того, как вы попытаетесь сосчитать их с помощью одного из методов read
.
Реализация
public function get bytesAvailable():uint
connected | свойство |
connected:Boolean
[только для чтения] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Определяет, подключен ли в настоящий момент данный объект URLStream. Вызов этого свойства возвращает значение true
, если объект URLStream подключен, или значение false
, если объект не подключен.
Реализация
public function get connected():Boolean
endian | свойство |
endian:String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Указывает порядок байтов для данных. Возможные значения: Endian.BIG_ENDIAN
или Endian.LITTLE_ENDIAN
.
Значением по умолчанию является Endian.BIG_ENDIAN.
Реализация
public function get endian():String
public function set endian(value:String):void
Связанные элементы API
objectEncoding | свойство |
objectEncoding:uint
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Управляет версией AMF, используемой при записи или чтении объекта.
Реализация
public function get objectEncoding():uint
public function set objectEncoding(value:uint):void
Связанные элементы API
close | () | метод |
public function close():void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Немедленно закрывает поток и отменяет операцию загрузки. После вызова метода close()
данные из потока не считываются.
Выдает
IOError — Не удалось закрыть поток или поток не был открыт.
|
load | () | метод |
public function load(request:URLRequest):void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Начинает загрузку URL-адреса, указанного в параметре request
.
Примечание. Если загружаемый файл содержит символы, не принадлежащие коду ASCII (например, во многих языках, кроме английского), рекомендуется сохранить файл в кодировке UTF-8 или UTF-16, как противоположных стандарту ASCII.
Если мгновенно происходит сбой операции загрузки, создается исключение IOError или SecurityError (включая сообщение о нарушении безопасности локального файла) с описанием данного сбоя. В противном случае событие open
отправляется, если успешно начинается загрузка URL-адреса. При возникновении ошибки отправляется событие ошибки.
По умолчанию вызывающий SWF-файл и загружаемый URL-адрес должны находиться в одном и том же домене. Например, SWF-файл на www.adobe.com может загружать данные только из источников, которые также размещены на сайте www.adobe.com. Чтобы загрузить данные с другого домена, разместите файл политик URL-адресов на сервере, где расположены эти данные.
В проигрывателе Flash Player нельзя подключаться к общепринятым зарезервированным портам. Полный список заблокированных портов см. в разделе «Ограничение API-интерфейсов сетевого подключения» в руководстве ActionScript 3.0 Developer's Guide (руководстве разработчика по ActionScript 3.0).
Для того чтобы при работе с проигрывателем Flash Player SWF-файл не использовал этот метод, задайте параметр allowNetworking
для тегов object
и embed
HTML-страницы с SWF-содержимым.
В приложении Flash Player 10 и более поздних версий и в AIR 1.5 и более поздних версий при использовании типа содержимого multipart (например, multipart/form-data), в котором содержатся загружаемые данные (обозначена параметром filename в заголовке content-disposition в теле оператора POST), к операции POST применяются правила безопасности для загрузок:
- Операция POST должна быть выполнена в ответ на действие, инициированное пользователем, такое как щелчок мыши или нажатие клавиши.
- Если операция POST является междоменной (назначением операции POST не является сервер, на котором содержится SWF-файл, отправляющий запрос POST), целевой сервер должен предоставить файл политик URL, в котором разрешен междоменный доступ.
Кроме того, все объекты multipart Content-Type должны иметь допустимый синтаксис (в соответствии со стандартами RFC2046). Если синтаксис является недопустимым, к операции POST применяются правила безопасности, действующие для загрузок.
Эти правила также применяются к содержимому AIR в изолированных программных средах, отличных от среды приложения. Однако в Adobe AIR эти ограничения по безопасности не распространяются на содержимое в изолированной программной среде приложения (содержимое, установленное с приложением AIR).
Дополнительные сведения о безопасности см. в разделе центра разработчиков Flash Player Безопасность.
В AIR объект URLRequest можно зарегистрировать для события состояния httpResponse
. В отличии от события httpStatus
, событие httpResponseStatus
доставляется до получения данных ответа. Таким образом, в событие httpResponseStatus
входят значения свойств responseHeaders
и responseURL
(которые для события httpStatus
имеют значение undefined.) Обратите внимание на то, что httpResponseStatus
(при наличии такового) будет отправляться до (как дополнение) любого события complete
или error
.
При наличии прослушивателя событий httpResponseStatus
тело сообщения ответа всегда отправляется; а ответы с кодами состояния HTTP всегда приводят к событию complete
. Это правило соблюдается независимо от того, обозначает код состояния HTTP в ответе успешное выполнение или ошибку.
В AIR при отсутствии прослушивателя событий httpResponseStatus
поведение отличается в зависимости от версии SWF:
- В случае с содержимым SWF 9 тело сообщения ответа HTTP отправляется, только если код состояния HTTP в ответе означает успешное выполнение. В противном случае (если возникла ошибка) тело сообщения не отправляется, а объект URLRequest отправляет событие IOError.
- В случае с содержимым SWF 10 тело сообщения ответа HTTP отправляется всегда. Если возникла ошибка, объект URLRequest отправляет событие IOError.
Параметры
request:URLRequest — Объект URLRequest, определяющий URL-адрес для загрузки. Если значение данного параметра или свойства URLRequest.url переданного объекта URLRequest равно null , приложение выдает ошибку пустого указателя.
|
События
complete: — Отправляется после успешной загрузки данных. При наличии прослушивателя событий httpResponseStatus объект URLRequest также отправляет событие complete независимо от того, что означает код состояния в ответе HTTP, успешное выполнение или ошибку.
| |
httpStatus: — Если доступ осуществляется по протоколу HTTP и текущая среда поддерживает получение кодов состояния, можно получить эти события в дополнение к событию complete или error .
| |
httpResponseStatus: — Отправляется, если путем вызова метода load() выполняется попытка доступа к данным через HTTP, и Adobe AIR может обнаружить и вернуть код статуса для запроса.
| |
ioError: — Не удается завершить операцию загрузки.
| |
open: — Отправляется при запуске операции загрузки.
| |
securityError: — В рамках операции загрузки была произведена попытка извлечь данные с сервера, расположенного за пределами изолированной среды вызывающего объекта. Для решения этой проблемы можно использовать файл политики на сервере.
|
Выдает
ArgumentError — Объекты URLRequest.requestHeader могут не содержать определенные запрещенные заголовки запроса HTTP. Дополнительные сведения см. в описании класса URLRequestHeader.
| |
MemoryError — Данная ошибка может возникнуть по следующим причинам:
| |
SecurityError — Локальные ненадежные SWF-файлы могут быть изолированы от Интернета. Чтобы обойти эту проблему, можно переклассифицировать данный SWF-файл как локальный с сетевым подключением или доверенный.
| |
SecurityError — Вы пытаетесь подключиться к зарезервированному порту. Полный список заблокированных портов см. в разделе «Ограничение API-интерфейсов сетевого подключения» в руководстве ActionScript 3.0 Developer's Guide (руководстве разработчика по ActionScript 3.0).
|
readBoolean | () | метод |
public function readBoolean():Boolean
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Считывает из потока логическое значение. Считывается один байт. Если этот байт ненулевой, то возвращается значение true
. В противном случае возвращается значение false
.
Boolean — При получении ненулевого байта возвращается значение True , в противном случае false .
|
Выдает
EOFError — Недостаточно данных, доступных для чтения. Если локальный SWF-файл запускает предупреждение системы безопасности, то проигрыватель Flash Player закрывает для ActionScript доступ к данным URLStream. При этом свойство bytesAvailable возвращает значение 0 даже в случае получения данных, а любой из методов считывания создает исключение EOFError.
| |
IOError — В потоке возникла ошибка ввода-вывода или поток не был открыт.
|
readByte | () | метод |
public function readByte():int
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Считывает из потока байт со знаком.
Возвращенное значение находится в диапазоне от -128 до 127.
Возвращаетint — Значение в диапазоне от -128 до 127.
|
Выдает
EOFError — Недостаточно данных, доступных для чтения. Если локальный SWF-файл запускает предупреждение системы безопасности, то проигрыватель Flash Player закрывает для ActionScript доступ к данным URLStream. При этом свойство bytesAvailable возвращает значение 0 даже в случае получения данных, а любой из методов считывания создает исключение EOFError.
| |
IOError — В потоке возникла ошибка ввода-вывода или поток не был открыт.
|
readBytes | () | метод |
public function readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Считывает из потока число байт length
данных. Байты считываются в объект ByteArray, указанный параметром bytes
, начиная с байтов offset
в объекте ByteArray.
Параметры
bytes:ByteArray — Объект ByteArray, в который считываются данные.
| |
offset:uint (default = 0 ) — Смещение в параметре bytes , с которого должно начинаться считывание данных. Значение по умолчанию равно 0.
| |
length:uint (default = 0 ) — Число байтов для считывания. Если значение по умолчанию равно 0, будут считываться все доступные данные.
|
Выдает
EOFError — Недостаточно данных, доступных для чтения. Если локальный SWF-файл запускает предупреждение системы безопасности, то проигрыватель Flash Player закрывает для ActionScript доступ к данным URLStream. При этом свойство bytesAvailable возвращает значение 0 даже в случае получения данных, а любой из методов считывания создает исключение EOFError.
| |
IOError — В потоке возникла ошибка ввода-вывода или поток не был открыт.
|
readDouble | () | метод |
public function readDouble():Number
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Считывает из потока число IEEE 754 с двойной точностью и плавающей запятой.
ВозвращаетNumber — Взятое из потока число IEEE 754 с двойной точностью и плавающей запятой.
|
Выдает
EOFError — Недостаточно данных, доступных для чтения. Если локальный SWF-файл запускает предупреждение системы безопасности, то проигрыватель Flash Player закрывает для ActionScript доступ к данным URLStream. При этом свойство bytesAvailable возвращает значение 0 даже в случае получения данных, а любой из методов считывания создает исключение EOFError.
| |
IOError — В потоке возникла ошибка ввода-вывода или поток не был открыт.
|
readFloat | () | метод |
public function readFloat():Number
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Считывает из потока число IEEE 754 с одинарной точностью и плавающей запятой.
ВозвращаетNumber — Взятое из потока число IEEE 754 с одинарной точностью и плавающей запятой.
|
Выдает
EOFError — Недостаточно данных, доступных для чтения. Если локальный SWF-файл запускает предупреждение системы безопасности, то проигрыватель Flash Player закрывает для ActionScript доступ к данным URLStream. При этом свойство bytesAvailable возвращает значение 0 даже в случае получения данных, а любой из методов считывания создает исключение EOFError.
| |
IOError — В потоке возникла ошибка ввода-вывода или поток не был открыт.
|
readInt | () | метод |
public function readInt():int
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Считывает из потока 32-разрядное целое число со знаком.
Возвращенное значение находится в диапазоне от -2147483648 до 2147483647.
Возвращаетint — Значение в диапазоне от -2147483648 до 2147483647.
|
Выдает
EOFError — Недостаточно данных, доступных для чтения. Если локальный SWF-файл запускает предупреждение системы безопасности, то проигрыватель Flash Player закрывает для ActionScript доступ к данным URLStream. При этом свойство bytesAvailable возвращает значение 0 даже в случае получения данных, а любой из методов считывания создает исключение EOFError.
| |
IOError — В потоке возникла ошибка ввода-вывода или поток не был открыт.
|
readMultiByte | () | метод |
public function readMultiByte(length:uint, charSet:String):String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Считывает из потока байтов многобайтовую строку заданной длины с использованием заданного набора знаков.
Параметры
length:uint — Число считываемых из потока байтов.
| |
charSet:String — Строка, обозначающая набор символов, которые используются для интерпретации байтов. Возможные строки наборов символов: shift_jis , "CN-GB" , iso-8859-1 и другие. Полный список см. в разделе Поддерживаемые наборы символов.
Примечание. Если текущая система не распознает значение параметра |
String — Строка в кодировке UTF-8.
|
Выдает
EOFError — Недостаточно данных, доступных для чтения. Если локальный SWF-файл запускает предупреждение системы безопасности, то проигрыватель Flash Player закрывает для ActionScript доступ к данным URLStream. При этом свойство bytesAvailable возвращает значение 0 даже в случае получения данных, а любой из методов считывания создает исключение EOFError.
|
readObject | () | метод |
public function readObject():*
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Считывает объект из сокета, зашифрованного в формат AMF.
Возвращает* — Десериализованный объект.
|
Выдает
EOFError — Недостаточно данных, доступных для чтения. Если локальный SWF-файл запускает предупреждение системы безопасности, то проигрыватель Flash Player закрывает для ActionScript доступ к данным URLStream. При этом свойство bytesAvailable возвращает значение 0 даже в случае получения данных, а любой из методов считывания создает исключение EOFError.
| |
IOError — В потоке возникла ошибка ввода-вывода или поток не был открыт.
|
Связанные элементы API
readShort | () | метод |
public function readShort():int
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Считывает из потока 16-разрядное целое число со знаком.
Возвращенное значение находится в диапазоне от -32768 до 32767.
Возвращаетint — Значение в диапазоне от -32768 до 32767.
|
Выдает
EOFError — Недостаточно данных, доступных для чтения. Если локальный SWF-файл запускает предупреждение системы безопасности, то проигрыватель Flash Player закрывает для ActionScript доступ к данным URLStream. При этом свойство bytesAvailable возвращает значение 0 даже в случае получения данных, а любой из методов считывания создает исключение EOFError.
| |
IOError — В потоке возникла ошибка ввода-вывода или поток не был открыт.
|
readUnsignedByte | () | метод |
public function readUnsignedByte():uint
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Считывает из потока байтов без знака.
Возвращенное значение находится в диапазоне от 0 до 255.
Возвращаетuint — Значение в диапазоне от 0 до 255.
|
Выдает
EOFError — Недостаточно данных, доступных для чтения. Если локальный SWF-файл запускает предупреждение системы безопасности, то проигрыватель Flash Player закрывает для ActionScript доступ к данным URLStream. При этом свойство bytesAvailable возвращает значение 0 даже в случае получения данных, а любой из методов считывания создает исключение EOFError.
| |
IOError — В потоке возникла ошибка ввода-вывода или поток не был открыт.
|
readUnsignedInt | () | метод |
public function readUnsignedInt():uint
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Считывает из потока 32-разрядное целое число без знака.
Возвращенное значение находится в диапазоне от 0 до 4294967295.
Возвращаетuint — Значение в диапазоне от 0 до 4294967295.
|
Выдает
EOFError — Недостаточно данных, доступных для чтения. Если локальный SWF-файл запускает предупреждение системы безопасности, то проигрыватель Flash Player закрывает для ActionScript доступ к данным URLStream. При этом свойство bytesAvailable возвращает значение 0 даже в случае получения данных, а любой из методов считывания создает исключение EOFError.
| |
IOError — В потоке возникла ошибка ввода-вывода или поток не был открыт.
|
readUnsignedShort | () | метод |
public function readUnsignedShort():uint
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Считывает из потока 16-разрядное целое число без знака.
Возвращенное значение находится в диапазоне от 0 до 65535.
Возвращаетuint — Значение в диапазоне от 0 до 65535.
|
Выдает
EOFError — Недостаточно данных, доступных для чтения. Если локальный SWF-файл запускает предупреждение системы безопасности, то проигрыватель Flash Player закрывает для ActionScript доступ к данным URLStream. При этом свойство bytesAvailable возвращает значение 0 даже в случае получения данных, а любой из методов считывания создает исключение EOFError.
| |
IOError — В потоке возникла ошибка ввода-вывода или поток не был открыт.
|
readUTF | () | метод |
public function readUTF():String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Считывает из потока строку UTF-8. Предполагается, что в строку вставляется префикс с неподписанным значением, указывающим длину в байтах.
ВозвращаетString — Строка UTF-8.
|
Выдает
EOFError — Недостаточно данных, доступных для чтения. Если локальный SWF-файл запускает предупреждение системы безопасности, то проигрыватель Flash Player закрывает для ActionScript доступ к данным URLStream. При этом свойство bytesAvailable возвращает значение 0 даже в случае получения данных, а любой из методов считывания создает исключение EOFError.
| |
IOError — В потоке возникла ошибка ввода-вывода или поток не был открыт.
|
readUTFBytes | () | метод |
public function readUTFBytes(length:uint):String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Считывает из потока последовательность length
UTF-8 и возвращает строку.
Параметры
length:uint — Последовательность байтов UTF-8.
|
String — Строка в кодировке UTF-8, являющаяся байтовым представлением символов указанной длины.
|
Выдает
EOFError — Недостаточно данных, доступных для чтения. Если локальный SWF-файл запускает предупреждение системы безопасности, то проигрыватель Flash Player закрывает для ActionScript доступ к данным URLStream. При этом свойство bytesAvailable возвращает значение 0 даже в случае получения данных, а любой из методов считывания создает исключение EOFError.
| |
IOError — В потоке возникла ошибка ввода-вывода или поток не был открыт.
|
complete | Событие |
flash.events.Event
свойство Event.type =
flash.events.Event.COMPLETE
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Отправляется после успешной загрузки данных.
КонстантаEvent.COMPLETE
определяет значение свойства type
объекта complete
.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Сетевой объект, который завершил загрузку. |
httpResponseStatus | Событие |
flash.events.HTTPStatusEvent
свойство HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_RESPONSE_STATUS
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, AIR 1.0, Flash Lite 4 |
Отправляется, если вызов метода URLStream.load()
пытается обратиться к данным через HTTP и Adobe AIR может обнаружить и вернуть код состояния для запроса.
Если объект URLStream регистрирует событие httpStatusEvent
ответы с ошибкой доставляются так, будто это содержимое. Поэтому при загрузке ошибки объект URLStream отправляет события progress
и complete
вместо отправки события ioError
.
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
httpStatus | Событие |
flash.events.HTTPStatusEvent
свойство HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_STATUS
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Отправляется, если вызов метода URLStream.load()
пытается обратиться к данным по протоколу HTTP, а Flash Player или приложение Adobe AIR может определить и вернуть код состояния для запроса. (В среде некоторых обозревателей данная информация не предоставляется.) Обратите внимание на то, что httpStatus
(при наличии такового) будет отправляться до (как дополнение) любого события complete
или error
.
HTTPStatusEvent.HTTP_STATUS
определяет значение свойства type
объекта события httpStatus
.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
status | Код состояния HTTP, возвращенный сервером. |
target | Сетевой объект, получающий код состояния НТТР. |
Связанные элементы API
ioError | Событие |
flash.events.IOErrorEvent
свойство IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Отправляется, когда происходит ошибка ввода-вывода, приводящая к сбою операции загрузки.
Задает значение свойстваtype
для объекта события ioError
.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
errorID | Ссылочный номер, связываемый с конкретной ошибкой (только AIR). |
target | Сетевой объект, с которым произошла ошибка ввода/вывода. |
text | Текст, отображаемый в качестве сообщения об ошибке. |
Связанные элементы API
open | Событие |
flash.events.Event
свойство Event.type =
flash.events.Event.OPEN
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Отправляется при запуске операции загрузки.
КонстантаEvent.OPEN
определяет значение свойства type
объекта события open
.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Сетевой объект, установивший подключение. |
Связанные элементы API
progress | Событие |
flash.events.ProgressEvent
свойство ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Отправляется в случае получения данных в ходе операции загрузки. Полученные данные можно сразу же прочитать с помощью методов класса URLStream.
Задает значение свойстваtype
для объекта события progress
.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | false |
bytesLoaded | Число элементов или байтов, загруженных на момент обработки события прослушивателем. |
bytesTotal | Общее число элементов или байтов, которые в итоге будут получены в случае успешного завершения загрузки. |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Объект, сообщающий сведения о прогрессе. |
Связанные элементы API
securityError | Событие |
flash.events.SecurityErrorEvent
свойство SecurityErrorEvent.type =
flash.events.SecurityErrorEvent.SECURITY_ERROR
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Отправляется, если путем вызова метода URLStream.load()
предпринимается попытка загрузить данные с сервера, расположенного за пределами изолированной среды.
SecurityErrorEvent.SECURITY_ERROR
определяет значение свойства type
для объекта события securityError
.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Сетевой объект, сообщающий об ошибке безопасности. |
text | Текст, отображаемый в качестве сообщения об ошибке. |
Связанные элементы API
Чтобы запустить пример, поместите файл URLStreamExample.swf в тот каталог, где находится рассматриваемый SWF-файл.
package { import flash.display.Sprite; import flash.errors.*; import flash.events.*; import flash.net.URLRequest; import flash.net.URLStream; public class URLStreamExample extends Sprite { private static const ZLIB_CODE:String = "CWS"; private var stream:URLStream; public function URLStreamExample() { stream = new URLStream(); var request:URLRequest = new URLRequest("URLStreamExample.swf"); configureListeners(stream); try { stream.load(request); } catch (error:Error) { trace("Unable to load requested URL."); } } private function configureListeners(dispatcher:EventDispatcher):void { dispatcher.addEventListener(Event.COMPLETE, completeHandler); dispatcher.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler); dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler); dispatcher.addEventListener(Event.OPEN, openHandler); dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler); dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler); } private function parseHeader():void { trace("parseHeader"); trace("isCompressed: " + isCompressed()); trace("version: " + stream.readByte()); } private function isCompressed():Boolean { return (stream.readUTFBytes(3) == ZLIB_CODE); } private function completeHandler(event:Event):void { trace("completeHandler: " + event); parseHeader(); } private function openHandler(event:Event):void { trace("openHandler: " + event); } private function progressHandler(event:Event):void { trace("progressHandler: " + event); } private function securityErrorHandler(event:SecurityErrorEvent):void { trace("securityErrorHandler: " + event); } private function httpStatusHandler(event:HTTPStatusEvent):void { trace("httpStatusHandler: " + event); } private function ioErrorHandler(event:IOErrorEvent):void { trace("ioErrorHandler: " + event); } } }
Tue Jun 12 2018, 11:34 AM Z