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

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

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

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

默认值为 Endian.BIG_ENDIAN.

另请参见

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

另请参见

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

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

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

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

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

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

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

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

参数

另请参见

对套接字输出缓冲区中积累的所有数据进行刷新。write 方法写入的数据不会被立即传送；这些数据在调用 flush() 方法之前一直被保存在队列中。

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

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

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

参数

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

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

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

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

参数

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

另请参见

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

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

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

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

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

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

参数

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

注意：此方法写入的数据不会被立即传送；这些数据在调用 flush() 方法之前一直被保存在队列中。

参数

另请参见

将一个字节写入套接字。

注意：此方法写入的数据不会被立即传送；这些数据在调用 flush() 方法之前一直被保存在队列中。

参数

另请参见

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

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

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

如果 offset 或 length 超出了范围，则调整它们以匹配 bytes 数组的开头和结尾。

注意：此方法写入的数据不会被立即传送；这些数据在调用 flush() 方法之前一直被保存在队列中。

参数

另请参见

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

注意：此方法写入的数据不会被立即传送；这些数据在调用 flush() 方法之前一直被保存在队列中。

参数

另请参见

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

注意：此方法写入的数据不会被立即传送；这些数据在调用 flush() 方法之前一直被保存在队列中。

参数

另请参见

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

注意：此方法写入的数据不会被立即传送；这些数据在调用 flush() 方法之前一直被保存在队列中。

参数

另请参见

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

注意：此方法写入的数据不会被立即传送；这些数据在调用 flush() 方法之前一直被保存在队列中。

参数

另请参见

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

注意：此方法写入的数据不会被立即传送；这些数据在调用 flush() 方法之前一直被保存在队列中。

参数

另请参见

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

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

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

注意：此方法写入的数据不会被立即传送；这些数据在调用 flush() 方法之前一直被保存在队列中。

参数

另请参见

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

注意：此方法写入的数据不会被立即传送；这些数据在调用 flush() 方法之前一直被保存在队列中。

参数

另请参见

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

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

注意：此方法写入的数据不会被立即传送；这些数据在调用 flush() 方法之前一直被保存在队列中。

参数

另请参见

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

注意：此方法写入的数据不会被立即传送；这些数据在调用 flush() 方法之前一直被保存在队列中。

参数

另请参见

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

此事件具有以下属性：

在建立网络连接后调度。

此事件具有以下属性：

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

此事件具有以下属性：

若对 Socket.connect() 的调用尝试连接到调用方安全沙箱外部的服务器或端口号低于 1024 端口，则进行调度。

此事件具有以下属性：

另请参见

在套接字接收到数据后调度。socketData 类型的事件不使用 ProgressEvent.bytesTotal 属性。

此事件具有以下属性：

1. 该构造函数创建名为 socket 的 CustomSocket 实例，并将主机名 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 {

        public function SocketExample() {
            var socket:CustomSocket = 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();
    }
}