URLStream  - AS3

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

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

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

Значением по умолчанию является Endian.BIG_ENDIAN.

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

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

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

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

Начинает загрузку 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.

Параметры

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

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

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

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

Параметры

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

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

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

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

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

Параметры

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

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

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

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

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

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

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

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

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

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

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

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

Параметры

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Связанные элементы 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);
        }
    }
}