Главная / Action Script 3
Пакетflash.net
Классpublic class URLStream
НаследованиеURLStream Inheritance EventDispatcher Inheritance Object
Реализует IDataInput

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Класс URLStream обеспечивает низкоуровневый доступ к загружаемым URL-адресам. Данные становятся доступными для кода приложения сразу во время загрузки. В отличие от URLLoader, нет необходимости ждать окончания загрузки всего файла. Класс URLStream также позволяет закрывать поток до того, как будет завершена его загрузка. Содержимое загруженного файла доступно в качестве необработанных двоичных данных.

Операции чтения в URLStream не являются блокирующими. Это означает, что перед тем как считать данные, необходимо с помощью свойства bytesAvailable определить, доступен ли необходимый объем этих данных. Исключение EOFError создается при наличии неполных данных.

По умолчанию все двоичные данные кодируются в формате обратного порядка файлов (сначала передается наиболее значимый байт).

Правила безопасности, применяемые к загрузке URL-адресов с классом URLStream, идентичны правилам, применяемым в отношении объектов URLLoader. При необходимости можно загрузить файлы правил. Применяются локальные правила безопасности файлов, предупреждения о нарушении безопасности появляются по мере необходимости.

Посмотреть примеры

См. также

URLLoader
URLRequest


Общедоступные свойства
 СвойствоОпределено
  bytesAvailable : uint
[только для чтения] Возвращает число байт данных, доступных для чтения во входном буфере.
URLStream
  connected : Boolean
[только для чтения] Определяет, подключен ли в настоящий момент данный объект URLStream.
URLStream
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  endian : String
Указывает порядок байт для данных.
URLStream
  objectEncoding : uint
Управляет версией AMF, используемой при записи или чтении объекта.
URLStream
 Inheritedprototype : Object
[статические] Ссылка на модель объекта класса или функции.
Object
Общедоступные методы
 МетодОпределено
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события в объекте EventDispatcher, в результате чего прослушиватель будет получать уведомления о событиях.
EventDispatcher
  
Немедленно закрывает поток и отменяет операцию загрузки.
URLStream
 Inherited
Передает событие в поток событий.
EventDispatcher
 Inherited
Проверяет наличие у объекта EventDispatcher прослушивателей событий, которые зарегистрированы для получения уведомлений о событиях определенного типа.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
  
Начинает загрузку URL-адреса, заданного параметром request.
URLStream
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
  
Считывает из потока логическое значение.
URLStream
  
Считывает из потока байт со знаком.
URLStream
  
readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
Считывает из потока число байт данных, определенное параметром "длина".
URLStream
  
Считывает из потока число IEEE 754 с двойной точностью и плавающей запятой.
URLStream
  
Считывает из потока число IEEE 754 с одинарной точностью и плавающей запятой.
URLStream
  
Считывает из потока 32-разрядное целое число со знаком.
URLStream
  
readMultiByte(length:uint, charSet:String):String
Считывает из потока байт многобайтовую строку заданной длины с использованием заданного набора знаков.
URLStream
  
Считывает объект из сокета, зашифрованного в формат AMF.
URLStream
  
Считывает из потока 16-разрядное целое число со знаком.
URLStream
  
Считывает из потока байт без знака.
URLStream
  
Считывает из потока 32-разрядное целое число без знака.
URLStream
  
Считывает из потока 16-разрядное целое число без знака.
URLStream
  
Считывает из потока строку UTF-8.
URLStream
  
Считывает из потока последовательность байт UTF-8 и возвращает строку.
URLStream
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель событий в объекте EventDispatcher или в любом из его предков для получения уведомлений о событиях определенного типа.
EventDispatcher
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player перемещается в фокус операционной системы и становится активным.EventDispatcher
  Отправляется после успешной загрузки данных.URLStream
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player покидает фокус операционной системы и становится неактивным.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
Версии среды выполнения:  1.0 9

Возвращает число байт данных, доступных для чтения во входном буфере. В вашем коде должен быть вызов свойства bytesAvailable, проверяющий доступность необходимого объема данных до того, как вы попытаетесь сосчитать их с помощью одного из методов read.



Реализация
    public function get bytesAvailable():uint
connectedсвойство 
connected:Boolean  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Определяет, подключен ли в настоящий момент данный объект URLStream. Вызов этого свойства возвращает значение true, если объект URLStream подключен, или значение false, если объект не подключен.



Реализация
    public function get connected():Boolean
endianсвойство 
endian:String  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Указывает порядок байт для данных. Возможные значения: Endian.BIG_ENDIAN или Endian.LITTLE_ENDIAN.

Значение по умолчанию Endian.BIG_ENDIAN



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

См. также

objectEncodingсвойство 
objectEncoding:uint  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Управляет версией AMF, используемой при записи или чтении объекта.



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

См. также

Сведения о методе
close()метод
public function close():void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Немедленно закрывает поток и отменяет операцию загрузки. После вызова метода close() данные из потока не считываются.


Выдает
IOError — Не удалось закрыть поток или поток не был открыт.
load()метод 
public function load(request:URLRequest):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Начинает загрузку URL-адреса, указанного в параметре request.

Примечание. Если загружаемый файл содержит символы, не принадлежащие коду ASCII (например, во многих языках, кроме английского), рекомендуется сохранить файл в кодировке UTF-8 или UTF-16, как противоположных стандарту ASCII.

Если мгновенно происходит сбой операции загрузки, создается исключение IOError или SecurityError (включая сообщение о нарушении безопасности локального файла) с описанием данного сбоя. В противном случае, событие open отправляется, если успешно начинается загрузка URL-адреса. При возникновении ошибки отправляется сообщение об ошибке.

При использовании данного метода необходимо продумать модель безопасности проигрывателя Adobe® Flash® Player:

В приложении Flash Player 10 и более поздней версии при использовании типа содержимого multipart (например, multipart/form-data), в котором содержится отправка (обозначена параметром filename в заголовке content-disposition в теле оператора POST), к операции POST применяются правила безопасности для отправок:

Кроме того, все объекты multipart Content-Type должны иметь допустимый синтаксис (в соответствии со стандартами RFC2046). Если синтаксис является недопустимым, к операции POST применяются правила безопасности, действующие для отправок.

Однако в Adobe AIR эти ограничения по безопасности не распространяются на содержимое в изолированной программной среде безопасности приложения (содержимое, установленное с приложением AIR).

Дополнительные сведения о безопасности см. в следующих ресурсах.

Параметры

request:URLRequest — Объект URLRequest, определяющий URL-адрес для загрузки. Если значение данного параметра или свойства URLRequest.url переданного объекта URLRequest равно null, приложение выдает ошибку пустого указателя.


События
complete:Event — Отправляется после успешной загрузки данных.
 
httpStatus:HTTPStatusEvent — Если доступ осуществляется по протоколу HTTP и текущая среда Flash Player поддерживает получение кодов состояния, то в дополнение к любым событиям complete или error могут возникнуть следующие события.
 
httpResponseStatus:HTTPStatusEvent — Отправляется, если вызов метода load() пытается обратиться к данным через HTTP и Adobe AIR может обнаружить и вернуть код состояния для запроса.
 
ioError:IOErrorEvent — Не удается завершить операцию загрузки.
 
open:Event — Отправляется при запуске операции загрузки.
 
securityError:SecurityErrorEvent — В рамках операции загрузки была произведена попытка извлечь данные с сервера, расположенного за пределами изолированной среды вызывающего объекта. Для решения этой проблемы можно использовать файл политики на сервере.

Выдает
ArgumentError — Объекты URLRequest.requestHeader могут не содержать определенные запрещенные заголовки запроса HTTP. Дополнительную информацию см. в описании класса URLRequestHeader.
 
MemoryError — Данная ошибка может возникнуть по следующим причинам:
  1. Проигрыватель Flash Player или приложение Adobe AIR не может преобразовать значение параметра URLRequest.data из UTF8 в MBCS. Данная ошибка применяется, если объект URLRequest, переданный методу load(), настроен на выполнение операции GET, а параметр System.useCodePage имеет значение true.
  2. Проигрыватель Flash Player или приложение Adobe AIR не может выделить память для данных POST. Данная ошибка применима, если переданный к загрузке объект URLRequest настроен на выполнение операции POST.
 
SecurityError — Локальные ненадежные файлы изолируются от Интернета. Чтобы обойти эту проблему, можно переклассифицировать данный файл как локальный с сетевым подключением или доверенный.
readBoolean()метод 
public function readBoolean():Boolean

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Считывает из потока логическое значение. Считывается один байт. Если этот байт ненулевой, то возвращается значение true. В противном случае возвращается значение false.

Возвращает
Boolean — При получении ненулевого байта возвращается значение True, в противном случае — false.

Выдает
EOFError Недостаточно данных, доступных для чтения. Если локальный SWF-файл запускает предупреждение системы безопасности, то проигрыватель Flash Player закрывает для ActionScript доступ к данным URLStream. При этом свойство bytesAvailable возвращает значение 0 даже в случае получения данных, а любой из методов считывания создает исключение EOFError. Эта ошибка относится к содержимому SWF; она не встречается в коде JavaScript, выполняемом в приложении AIR.
 
IOError — В потоке возникла ошибка ввода-вывода или поток не был открыт.
readByte()метод 
public function readByte():int

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Считывает из потока байт со знаком.

Возвращенное значение находится в диапазоне от -128 до 127.

Возвращает
int — Значение в диапазоне от -128 до 127.

Выдает
EOFError Недостаточно данных, доступных для чтения. Если локальный SWF-файл запускает предупреждение системы безопасности, то проигрыватель Flash Player закрывает для ActionScript доступ к данным URLStream. При этом свойство bytesAvailable возвращает значение 0 даже в случае получения данных, а любой из методов считывания создает исключение EOFError. Эта ошибка относится к содержимому SWF; она не встречается в коде JavaScript, выполняемом в приложении AIR.
 
IOError — В потоке возникла ошибка ввода-вывода или поток не был открыт.
readBytes()метод 
public function readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Считывает из потока число байт данных. Байты считываются в объект 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. Эта ошибка относится к содержимому SWF; она не встречается в коде JavaScript, выполняемом в приложении AIR.
 
IOError — В потоке возникла ошибка ввода-вывода или поток не был открыт.
readDouble()метод 
public function readDouble():Number

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Считывает из потока число IEEE 754 с двойной точностью и плавающей запятой.

Возвращает
Number — Взятое из потока число IEEE 754 с двойной точностью и плавающей запятой.

Выдает
EOFError Недостаточно данных, доступных для чтения. Если локальный SWF-файл запускает предупреждение системы безопасности, то проигрыватель Flash Player закрывает для ActionScript доступ к данным URLStream. При этом свойство bytesAvailable возвращает значение 0 даже в случае получения данных, а любой из методов считывания создает исключение EOFError. Эта ошибка относится к содержимому SWF; она не встречается в коде JavaScript, выполняемом в приложении AIR.
 
IOError — В потоке возникла ошибка ввода-вывода или поток не был открыт.
readFloat()метод 
public function readFloat():Number

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Считывает из потока число IEEE 754 с одинарной точностью и плавающей запятой.

Возвращает
Number — Взятое из потока число IEEE 754 с одинарной точностью и плавающей запятой.

Выдает
EOFError Недостаточно данных, доступных для чтения. Если локальный SWF-файл запускает предупреждение системы безопасности, то проигрыватель Flash Player закрывает для ActionScript доступ к данным URLStream. При этом свойство bytesAvailable возвращает значение 0 даже в случае получения данных, а любой из методов считывания создает исключение EOFError. Эта ошибка относится к содержимому SWF; она не встречается в коде JavaScript, выполняемом в приложении AIR.
 
IOError — В потоке возникла ошибка ввода-вывода или поток не был открыт.
readInt()метод 
public function readInt():int

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Считывает из потока 32-разрядное целое число со знаком.

Возвращенное значение находится в диапазоне от -2147483648 до 2147483647.

Возвращает
int — Значение в диапазоне от -2147483648 до 2147483647.

Выдает
EOFError Недостаточно данных, доступных для чтения. Если локальный SWF-файл запускает предупреждение системы безопасности, то проигрыватель Flash Player закрывает для ActionScript доступ к данным URLStream. При этом свойство bytesAvailable возвращает значение 0 даже в случае получения данных, а любой из методов считывания создает исключение EOFError. Эта ошибка относится к содержимому SWF; она не встречается в коде JavaScript, выполняемом в приложении AIR.
 
IOError — В потоке возникла ошибка ввода-вывода или поток не был открыт.
readMultiByte()метод 
public function readMultiByte(length:uint, charSet:String):String

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Считывает из потока байт многобайтовую строку заданной длины с использованием заданного набора знаков.

Параметры

length:uint — Число считываемых из потока байтов.
 
charSet:String — Строка, обозначающая набор символов, которые используются для интерпретации байтов. Возможные строки наборов символов: "shift_jis", "CN-GB", "iso-8859-1" и другие. Полный список см. в разделе Поддерживаемые наборы символов.

Примечание. Если текущая система не распознает значение параметра charSet, то в качестве набора символов приложение будет использовать кодовую страницу по умолчанию. Например, значение параметра charSet, например в myTest.readMultiByte(22, "iso-8859-01"), которое использует 01вместо 1 может работать на вашем компьютере, но привести к сбою на другой рабочей станции. На другом компьютере приложение будет использовать кодовую страницу, заданную по умолчанию в системе.

Возвращает
String — Строка в кодировке UTF-8.

Выдает
EOFError Недостаточно данных, доступных для чтения. Если локальный SWF-файл запускает предупреждение системы безопасности, то проигрыватель Flash Player закрывает для ActionScript доступ к данным URLStream. При этом свойство bytesAvailable возвращает значение 0 даже в случае получения данных, а любой из методов считывания создает исключение EOFError. Эта ошибка относится к содержимому SWF; она не встречается в коде JavaScript, выполняемом в приложении AIR.
readObject()метод 
public function readObject():*

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Считывает объект из сокета, зашифрованного в формат AMF.

Возвращает
* — Десериализованный объект.

Выдает
EOFError — Недостаточно данных, доступных для чтения. Если локальный SWF-файл запускает предупреждение системы безопасности, то проигрыватель Flash Player закрывает для ActionScript доступ к данным URLStream. При этом свойство bytesAvailable возвращает значение 0 даже в случае получения данных, а любой из методов считывания создает исключение EOFError.
 
IOError — В потоке возникла ошибка ввода-вывода или поток не был открыт.

См. также

readShort()метод 
public function readShort():int

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Считывает из потока 16-разрядное целое число со знаком.

Возвращенное значение находится в диапазоне от -32768 до 32767.

Возвращает
int — Значение в диапазоне от -32768 до 32767.

Выдает
EOFError Недостаточно данных, доступных для чтения. Если локальный SWF-файл запускает предупреждение системы безопасности, то проигрыватель Flash Player закрывает для ActionScript доступ к данным URLStream. При этом свойство bytesAvailable возвращает значение 0 даже в случае получения данных, а любой из методов считывания создает исключение EOFError. Эта ошибка относится к содержимому SWF; она не встречается в коде JavaScript, выполняемом в приложении AIR.
 
IOError — В потоке возникла ошибка ввода-вывода или поток не был открыт.
readUnsignedByte()метод 
public function readUnsignedByte():uint

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Считывает из потока байт без знака.

Возвращенное значение находится в диапазоне от 0 до 255.

Возвращает
uint — Значение в диапазоне от 0 до 255.

Выдает
EOFError Недостаточно данных, доступных для чтения. Если локальный SWF-файл запускает предупреждение системы безопасности, то проигрыватель Flash Player закрывает для ActionScript доступ к данным URLStream. При этом свойство bytesAvailable возвращает значение 0 даже в случае получения данных, а любой из методов считывания создает исключение EOFError. Эта ошибка относится к содержимому SWF; она не встречается в коде JavaScript, выполняемом в приложении AIR.
 
IOError — В потоке возникла ошибка ввода-вывода или поток не был открыт.
readUnsignedInt()метод 
public function readUnsignedInt():uint

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Считывает из потока 32-разрядное целое число без знака.

Возвращенное значение находится в диапазоне от 0 до 4294967295.

Возвращает
uint — Значение в диапазоне от 0 до 4294967295.

Выдает
EOFError Недостаточно данных, доступных для чтения. Если локальный SWF-файл запускает предупреждение системы безопасности, то проигрыватель Flash Player закрывает для ActionScript доступ к данным URLStream. При этом свойство bytesAvailable возвращает значение 0 даже в случае получения данных, а любой из методов считывания создает исключение EOFError. Эта ошибка относится к содержимому SWF; она не встречается в коде JavaScript, выполняемом в приложении AIR.
 
IOError — В потоке возникла ошибка ввода-вывода или поток не был открыт.
readUnsignedShort()метод 
public function readUnsignedShort():uint

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Считывает из потока 16-разрядное целое число без знака.

Возвращенное значение находится в диапазоне от 0 до 65535.

Возвращает
uint — Значение в диапазоне от 0 до 65535.

Выдает
EOFError Недостаточно данных, доступных для чтения. Если локальный SWF-файл запускает предупреждение системы безопасности, то проигрыватель Flash Player закрывает для ActionScript доступ к данным URLStream. При этом свойство bytesAvailable возвращает значение 0 даже в случае получения данных, а любой из методов считывания создает исключение EOFError. Эта ошибка относится к содержимому SWF; она не встречается в коде JavaScript, выполняемом в приложении AIR.
 
IOError — В потоке возникла ошибка ввода-вывода или поток не был открыт.
readUTF()метод 
public function readUTF():String

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Считывает из потока строку UTF-8. Предполагается, что в строку вставляется префикс с неподписанным значением, указывающим длину в байтах.

Возвращает
String — Строка UTF-8.

Выдает
EOFError Недостаточно данных, доступных для чтения. Если локальный SWF-файл запускает предупреждение системы безопасности, то проигрыватель Flash Player закрывает для ActionScript доступ к данным URLStream. При этом свойство bytesAvailable возвращает значение 0 даже в случае получения данных, а любой из методов считывания создает исключение EOFError. Эта ошибка относится к содержимому SWF; она не встречается в коде JavaScript, выполняемом в приложении AIR.
 
IOError — В потоке возникла ошибка ввода-вывода или поток не был открыт.
readUTFBytes()метод 
public function readUTFBytes(length:uint):String

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Считывает из потока последовательность байт UTF-8 и возвращает строку.

Параметры

length:uint — Последовательность байт UTF-8.

Возвращает
String — Строка в кодировке UTF-8, являющаяся байтовым представлением символов указанной длины.

Выдает
EOFError Недостаточно данных, доступных для чтения. Если локальный SWF-файл запускает предупреждение системы безопасности, то проигрыватель Flash Player закрывает для ActionScript доступ к данным URLStream. При этом свойство bytesAvailable возвращает значение 0 даже в случае получения данных, а любой из методов считывания создает исключение EOFError. Эта ошибка относится к содержимому SWF; она не встречается в коде JavaScript, выполняемом в приложении AIR.
 
IOError — В потоке возникла ошибка ввода-вывода или поток не был открыт.
Сведения о событии
complete Событие
Тип объекта события: flash.events.Event
свойство Event.type = flash.events.Event.COMPLETE

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Отправляется после успешной загрузки данных.

Константа Event.COMPLETE определяет значение свойства type объекта complete.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetСетевой объект, который завершил загрузку.
AIR-only httpResponseStatus Событие  
Тип объекта события: flash.events.HTTPStatusEvent
свойство HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_RESPONSE_STATUS

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

Отправляется, если вызов метода URLStream.load() пытается обратиться к данным через HTTP и Adobe AIR может обнаружить и вернуть код состояния для запроса.

Если объект URLStream регистрирует событие httpStatusEvent ответы с ошибкой доставляются так, будто это содержимое. Поэтому при загрузке ошибки объект URLStream отправляет события progress и complete вместо отправки события ioError.

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

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

Данное событие имеет следующие свойства.

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

См. также

httpStatus Событие  
Тип объекта события: flash.events.HTTPStatusEvent
свойство HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_STATUS

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Отправляется, если вызов метода URLStream.load() пытается обратиться к данным по протоколу HTTP, а Flash Player или приложение Adobe AIR может определить и вернуть код состояния для запроса. (В среде некоторых обозревателей данная информация не предоставляется.) Обратите внимание на то, что httpStatus (при наличии такового) будет отправляться до (как дополнение) любого события complete или error.

Константа HTTPStatusEvent.HTTP_STATUS определяет значение свойства type объекта события httpStatus.

Данное событие имеет следующие свойства.

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

См. также

ioError Событие  
Тип объекта события: flash.events.IOErrorEvent
свойство IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Отправляется, когда происходит ошибка ввода-вывода, приводящая к сбою операции загрузки.

Задает значение свойства type для объекта события ioError.

Данное событие имеет следующие свойства.

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

См. также

open Событие  
Тип объекта события: flash.events.Event
свойство Event.type = flash.events.Event.OPEN

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Отправляется при запуске операции загрузки.

Константа Event.OPEN определяет значение свойства type объекта события open.

Данное событие имеет следующие свойства.

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

См. также

progress Событие  
Тип объекта события: flash.events.ProgressEvent
свойство ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Отправляется в случае получения данных в ходе операции загрузки. Полученные данные можно сразу же прочитать с помощью методов класса URLStream.

Задает значение свойства type для объекта события progress.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
bytesLoadedЧисло элементов или байт, загруженных на момент обработки события прослушивателем.
bytesTotalОбщее число элементов или байт, которые в итоге будут получены в случае успешного завершения загрузки.
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetСетевой объект, сообщающий сведения о прогрессе.

См. также

securityError Событие  
Тип объекта события: flash.events.SecurityErrorEvent
свойство SecurityErrorEvent.type = flash.events.SecurityErrorEvent.SECURITY_ERROR

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Отправляется, если путем вызова метода URLStream.load() предпринимается попытка загрузить данные с сервера, расположенного за пределами изолированной среды.

Константа SecurityErrorEvent.SECURITY_ERROR определяет значение свойства type для объекта события securityError.

Данное событие имеет следующие свойства.

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

См. также

Примеры Как пользоваться примерами
URLStreamExample.as

В следующем примере загружается SWF-файл, начало заголовка которого затем анализируется для получения информации о сжатии и номере версии.

Чтобы запустить пример, поместите файл 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);
        }
    }
}