URLStream  - AS3

返回可在输入缓冲区中读取的数据的字节数。您的代码必须调用 bytesAvailable 属性，以确保尝试使用其中一种 read 方法读取前有足够可用的数据。

表示此 URLStream 对象目前是否已连接。如果已连接 URLStream 对象，则调用该属性会返回值 true，否则会返回值 false。

表示数据的字节顺序。可能的值为 Endian.BIG_ENDIAN 或 Endian.LITTLE_ENDIAN。

默认值为 Endian.BIG_ENDIAN。

相关 API 元素

在写入或读取对象时，控制所使用的 Action Message Format (AMF) 的版本。

相关 API 元素

立即关闭该流并取消下载操作。无法在调用 close() 方法后从该流中读取数据。

开始下载 request 参数中指定的 URL。

注意：如果要加载的文件包含非 ASCII 字符（在许多非英语的语言中出现），则建议使用 UTF-8 或 UTF-16 编码（而不是 ASCII 等非 Unicode 格式）来保存文件。

如果加载操作很快失败，将引发描述失败情况的 IOError 或 SecurityError（包括本地文件安全错误）异常。否则，如果 URL 下载开始成功下载，将调度 open 事件；如果发生错误，将调度错误事件。

默认情况下，执行调用的 SWF 文件和加载的 URL 必须在同一域中。例如，位于 www.adobe.com 的 SWF 文件只能从同样位于 www.adobe.com 的源中加载数据。要从不同的域中加载数据，请在承载数据的服务器上放置一个 URL 策略文件。

在 Flash Player 中，无法连接到常用的保留端口。有关已阻止的端口的完整列表，请参阅《ActionScript 3.0 开发人员指南》中的“限制网络 API”。

在 Flash Player 中，可以通过在包含 SWF 内容的 HTML 页中设置 object 和 embed 标签的 allowNetworking 参数来禁止 SWF 文件使用此方法。

在 Flash Player 10 和更高版本中以及在 AIR 1.5 和更高版本中，如果使用包含上载（由 POST 正文内“content-disposition”标头中的“filename”参数所指）的 multipart Content-Type（例如“multipart/form-data”），则 POST 操作受应用于上载的安全规则的约束：

• 必须执行 POST 操作以响应用户启动的操作（如鼠标单击或按键）。
• 如果 POST 操作是跨域的（POST 目标与发送 POST 请求的 SWF 文件不在同一台服务器上），则目标服务器必须提供一个允许跨域访问的 URL 策略文件。

另外，对于任何 multipart Content-Type，语法必须有效（根据 RFC2046 标准）。如果语法无效，则 POST 操作受应用于上载的安全规则约束。

这些规则同样适用于非应用程序沙箱中的 AIR 内容。但在 Adobe AIR 中，应用程序沙箱中的内容（随 AIR 应用程序安装的内容）不受这些安全限制的约束。

有关安全性的详细信息，请参阅 Flash Player 开发人员中心主题：安全性。

在 AIR 中，URLRequest 对象可以注册 httpResponse 状态事件。与 httpStatus 事件不同，httpResponseStatus 事件在传送任何响应数据之前传送。此外，httpResponseStatus 事件还包括 responseHeaders 和 responseURL 属性的值（对于 httpStatus，这些属性未定义）。请注意，在发送任何 complete 或 error 事件之前还将发送 httpResponseStatus（如果有）。

如果有 httpResponseStatus 事件侦听器，则始终 将发送响应消息的正文；而 HTTP 状态代码响应始终将产生 complete 事件。无论 HTTP 响应状态代码表示成功还是错误，这种情况都适用。

在 AIR 中，如果没有 httpResponseStatus 事件侦听器，则行为因 SWF 版本而异：

• 对于 SWF 9 内容，只有 在 HTTP 响应状态代码指示成功时才会发送 HTTP 响应消息的正文。否则（如果有错误），将不发送正文，且 URLRequest 对象将调度一个 IOError 事件。
• 对于 SWF 10 内容，将始终 发送 HTTP 响应消息的正文。如果有错误，则 URLRequest 对象将调度一个 IOError 事件。

参数

从该流读取一个布尔值。读取单个字节，如果字节非零，则返回 true，否则返回 false。

从该流读取一个带符号字节。

返回值在 -128...127 之间。

从该流读取 length 字节的数据。这些字节会被读取到由 bytes 指定的 ByteArray 对象中，其起始位置是在 ByteArray 对象中偏移 offset 字节处。

参数

从该流读取一个 IEEE 754 双精度浮点数。

从该流读取一个 IEEE 754 单精度浮点数。

从该流读取一个带符号的 32 位整数。

返回值在 -2147483648...2147483647 之间。

使用指定的字符集从字节流中读取指定长度的多字节字符串。

参数

从以 Action Message Format (AMF) 编码的套接字读取一个对象。

相关 API 元素

从该流读取一个带符号的 16 位整数。

返回值在 -32768...32767 之间。

从该流读取一个无符号字节。

返回值在 0...255 之间。

从该流读取一个无符号的 32 位整数。

返回值在 0...4294967295 之间。

从该流读取一个无符号的 16 位整数。

返回值在 0...65535 之间。

从该流读取一个 UTF-8 字符串。假定字符串的前缀是无符号的短整型（以字节表示长度）。

从该流读取长度为 length 的 UTF-8 字节序列，并返回一个字符串。

参数

成功加载数据后调度。

此事件具有以下属性：

在 URLStream.load() 方法调用尝试通过 HTTP 访问数据，并且 Adobe AIR 可以检测并返回请求的状态代码时调度。

如果为 httpStatusEvent 事件注册了 URLStream 对象，则在传输错误响应时会将其视为内容。因此，在将错误数据加载到 URLStream 中时，URLStream 将调度 progress 和 complete 事件，而不调度 ioError 事件。

HTTPStatusEvent.HTTP_RESPONSE_STATUS 常量定义 httpResponseStatus 事件对象的 type 属性值。

此事件具有以下属性：

相关 API 元素

在 URLStream.load() 调用尝试通过 HTTP 访问数据，并且 Flash Player 或 Adobe AIR 可以检测并返回请求的状态代码时调度。（有些浏览器环境可能无法提供此信息。）请注意，在发送任何 complete 或 error 事件之前还将发送 httpStatus（如果有）。

此事件具有以下属性：

相关 API 元素

在出现输入/输出错误并由此导致加载操作失败时调度。

此事件具有以下属性：

相关 API 元素

在加载操作开始时调度。

此事件具有以下属性：

相关 API 元素

在下载操作过程中收到数据时调度。可以使用 URLStream 类方法立即读取已接收的数据。

此事件具有以下属性：

相关 API 元素

若对 URLStream.load() 的调用尝试从安全沙箱外部的服务器加载数据，则进行调度。

此事件具有以下属性：

相关 API 元素

为了运行该示例，请在与 SWF 文件相同的目录中放置一个名为 URLStreamExample.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);
        }
    }
}