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

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

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

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

См. также

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

См. также

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

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

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

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

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

• Загрузка данных запрещена, если вызывающий SWF-файл находится в локальной изолированной среде "local-with-file-system", а целевой источник — в сетевой изолированной среде.
• Загрузка данных также запрещена, если вызывающий SWF-файл находится в изолированной программной среде сети, но при этом используется локальный целевой источник.
• По умолчанию загружаемый URL должен находиться в том же домене, что и вызывающий SWF-файл. Например, SWF-файл на www.adobe.com может загружать данные только из источников, которые также размещены на сайте www.adobe.com. Чтобы загрузить данные с другого домена, разместите файл политики для URL на сервере, где расположены эти данные.
• Можно запретить SWF-файлу, выполняемому в Flash Player, использовать этот метод путем установки параметра allowNetworking для тегов object и embed на странице HTML, содержащей SWF-содержимое.

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

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

• Глава о безопасности в книге Программирование на ActionScript 3.0 и последние комментарии на странице LiveDocs.
• Раздел "Understanding AIR Security" (Сведения о безопасности AIR) главы "Getting started with Adobe AIR" (Начало работы с Adobe AIR) книги Developing AIR Applications (Разработка приложений AIR).
• Раздел центра разработки Flash Player: Безопасность

Параметры

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

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

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

Считывает из потока число байт данных. Байты считываются в объект ByteArray, указанный параметром bytes, начиная с байтов offset в объекте ByteArray.

Параметры

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

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

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

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

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

Параметры

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

См. также

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

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

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

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

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

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

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

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

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

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

Параметры

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

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

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

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

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

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

См. также

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

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

См. также

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

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

См. также

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

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

См. также

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

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

См. также

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

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

См. также

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