Socket  - AS3

输入缓冲区中可读取的数据的字节数。

代码必须访问 bytesAvailable 以确保在尝试使用其中一种 read 方法读取数据之前，有足够的数据可用。

表示写缓冲区中剩余的字节数。

此属性与 OutputProgressEvent 一起使用。每当将数据从写缓冲区写到网络时，便会引发 OutputProgressEvent。在该事件处理函数中，您可以检查 bytesPending，查看还有多少数据仍留在缓冲区中等待写入。当 bytesPending 返回 0 时，说明所有数据已从写缓冲区传送到网络，可以安全执行诸如删除事件处理函数、清空套接字引用、启动队列中的下一个上载等操作。

相关 API 元素

表示此 Socket 对象目前是否已连接。如果该套接字当前已连接，则对此属性的调用将返回值 true，否则将返回 false。

表示数据的字节顺序。可能的值为来自 flash.utils.Endian 类的常量、Endian.BIG_ENDIAN 或 Endian.LITTLE_ENDIAN。

默认值为 Endian.BIG_ENDIAN。

相关 API 元素

本地计算机上此套接字绑定到的 IP 地址。

相关 API 元素

本地计算机上此套接字绑定到的端口。

相关 API 元素

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

相关 API 元素

此套接字连接到的远程计算机的 IP 地址。

您可以使用此属性确定 ServerSocketConnectEvent 中由 ServerSocket 对象调度的客户端套接字的 IP 地址。如果需要，使用 DNSResolver 类将 IP 地址转换为域名。

相关 API 元素

此套接字连接到的远程计算机的端口。

您可以使用此属性确定 ServerSocketConnectEvent 中由 ServerSocket 对象调度的客户端套接字的端口号。

相关 API 元素

表示建立连接时需等待的毫秒数。

如果在指定时间内未成功建立连接，则连接失败。默认值是 20,000（20 秒）。

创建新的 Socket 对象。若未指定参数，将创建一个最初处于断开状态的套接字。若指定了参数，则尝试连接到指定的主机和端口。

注意：强烈建议使用不带参数的构造函数形式，并添加任意事件侦听器，然后使用 host 和 port 参数调用 connect 方法。此序列将确保所有事件侦听器工作正常。

关闭套接字。在调用 close() 方法之后，将无法读取或写入任何数据。

仅在服务器关闭连接时调度 close 事件；在调用 close() 方法时不调度该事件。

可通过再次对 Socket 对象调用 connect() 方法来重复使用该对象。

将套接字连接到指定的主机和端口。

如果连接立即失败，则调度一个事件或引发一个异常。如果指定了主机，则调度一个错误事件；如果未指定主机，则引发异常。另外，连接的状态由事件来报告。如果已连接上套接字，则现有的连接将首先关闭。

参数

对套接字输出缓冲区中积累的所有数据进行刷新。

在某些操作系统上，在执行帧之间会自动调用 flush()，但在其他操作系统（如 Windows）上，除非明确调用 flush()，否则不会发送数据。要确保应用程序在所有操作系统上都具有可靠的功能，在将每条消息（或相关数据组）写入套接字之后，最好调用 flush() 方法。

从套接字读取一个布尔值。在读取一个字节之后，如果该字节不为零，则该方法返回 true，否则返回 false。

从套接字读取一个带符号字节。

从套接字读取 length 参数指定的数据字节数。从 offset 所表示的位置开始，将这些字节读入指定的字节数组。

参数

从套接字读取一个 IEEE 754 双精度浮点数。

从套接字读取一个 IEEE 754 单精度浮点数。

从套接字读取一个带符号的 32 位整数。

使用指定的字符集，从该字节流读取一个多字节字符串。

参数

从以 AMF 序列化格式编码的套接字读取一个对象。

相关 API 元素

从套接字读取一个带符号的 16 位整数。

从套接字读取一个无符号字节。

从套接字读取一个无符号的 32 位整数。

从套接字读取一个无符号的 16 位整数。

从套接字读取一个 UTF-8 字符串。假定该字符串的前缀是表示字符串长度（以字节为单位）的无符号短整数。

从套接字读取 length 参数所指定的 UTF-8 数据的字节数，并返回一个字符串。

参数

将一个布尔值写入套接字。此方法写入了一个字节，其值为 1 (true ) 或 0 ( false)。

参数

相关 API 元素

将一个字节写入套接字。

参数

相关 API 元素

从指定的字节数组写入一系列字节。写入操作从 offset 指定的位置开始。

如果省略了 length 参数，则默认长度 0 将导致该方法从 offset 开始写入整个缓冲区。

如果还省略了 offset 参数，则写入整个缓冲区。

参数

相关 API 元素

将一个 IEEE 754 双精度浮点数写入套接字。

参数

相关 API 元素

将一个 IEEE 754 单精度浮点数写入套接字。

参数

相关 API 元素

将一个带符号的 32 位整数写入套接字。

参数

相关 API 元素

使用指定的字符集，从该字节流写入一个多字节字符串。

参数

相关 API 元素

以 AMF 序列化格式将一个对象写入套接字。

参数

相关 API 元素

将一个 16 位整数写入套接字。写入的字节如下：

(v >> 8) & 0xff v & 0xff

使用了该参数的低 16 位；忽略了高 16 位。

参数

相关 API 元素

将一个无符号的 32 位整数写入套接字。

参数

相关 API 元素

将以下数据写入套接字：一个无符号 16 位整数，它表示了指定 UTF-8 字符串的长度（以字节为单位），后面跟随字符串本身。

写入字符串之前，该方法会计算表示该字符串的所有字符所需的字节数。

参数

相关 API 元素

将一个 UTF-8 字符串写入套接字。

参数

相关 API 元素

在服务器关闭套接字连接时调度。

仅在服务器关闭连接时调度 close 事件；在调用 Socket.close() 方法时不调度该事件。

此事件具有以下属性：

在建立网络连接后调度。

此事件具有以下属性：

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

此事件具有以下属性：

当套接字将其写缓冲区的数据移到网络传输层时调度

若对 Socket.connect() 的调用尝试连接到调用方的安全沙箱禁止的服务器或低于 1024 的端口，且不存在允许进行此类连接的套接字策略文件，则进行调度。

注意：在 AIR 应用程序中，不需要套接字策略文件即允许在应用程序安全沙箱中运行的内容连接到任何服务器和端口号。

此事件具有以下属性：

相关 API 元素

在套接字接收到数据后调度。

套接字接收的数据在被读取之前一直保持在套接字中。在此事件的处理期间，您不必读取所有可用的数据。

socketData 类型的事件不使用 ProgressEvent.bytesTotal 属性。

此事件具有以下属性：

1. 该构造函数创建 CustomSocket 实例，名为 socket，并将主机名 localhost 和端口 80 作为参数传递。由于 CustomSocket 扩展了 Socket，因此在调用 super() 时将调用 Socket 的构造函数。
2. 然后，该示例调用了 configureListeners() 方法，该方法可为 Socket 事件添加侦听器。
3. 最后，调用套接字 connect() 方法，其中使用 localhost 作为主机名并使用 80 作为端口号。

注意：为了运行该示例，您需要一台与 SWF 位于同一个域（在本例中为 localhost）服务器并侦听端口 80。

package {
    import flash.display.Sprite;

    public class SocketExample extends Sprite {
        private var socket:CustomSocket;
        
        public function SocketExample() {
            socket = new CustomSocket("localhost", 80);
        }
    }
}

import flash.errors.*;
import flash.events.*;
import flash.net.Socket;

class CustomSocket extends Socket {
    private var response:String;

    public function CustomSocket(host:String = null, port:uint = 0) {
        super();
        configureListeners();
        if (host && port)  {
            super.connect(host, port);
        }
    }

    private function configureListeners():void {
        addEventListener(Event.CLOSE, closeHandler);
        addEventListener(Event.CONNECT, connectHandler);
        addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
        addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
        addEventListener(ProgressEvent.SOCKET_DATA, socketDataHandler);
    }

    private function writeln(str:String):void {
        str += "\n";
        try {
            writeUTFBytes(str);
        }
        catch(e:IOError) {
            trace(e);
        }
    }

    private function sendRequest():void {
        trace("sendRequest");
        response = "";
        writeln("GET /");
        flush();
    }

    private function readResponse():void {
        var str:String = readUTFBytes(bytesAvailable);
        response += str;
    }

    private function closeHandler(event:Event):void {
        trace("closeHandler: " + event);
        trace(response.toString());
    }

    private function connectHandler(event:Event):void {
        trace("connectHandler: " + event);
        sendRequest();
    }

    private function ioErrorHandler(event:IOErrorEvent):void {
        trace("ioErrorHandler: " + event);
    }

    private function securityErrorHandler(event:SecurityErrorEvent):void {
        trace("securityErrorHandler: " + event);
    }

    private function socketDataHandler(event:ProgressEvent):void {
        trace("socketDataHandler: " + event);
        readResponse();
    }
}