Socket  - AS3

可在輸入緩衝區中讀取之資料的位元組數。

您的程式碼必須存取 bytesAvailable，確定在嘗試以其中一種 read 方法進行讀取之前，具有足夠的資料。

指出寫入緩衝區中剩餘的位元組數目。

將這個屬性與 OutputProgressEvent 結合。每當將寫入緩衝區中的資料寫入網路時，都會擲回 OutputProgressEvent。在事件處理常式中，您可以檢查 bytesPending 以查看緩衝區中還有多少資料等待寫入。當 bytesPending 傳回 0 時，表示所有資料已經從寫入緩衝區傳輸到網路，並且可以安全地執行如移除事件處理常式、使通訊端參考無效、啟動佇列中的下一個上傳等動作。

相關 API 元素

指出此 Socket 物件目前是否已連線。 如果此 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 (二十秒)。

建立新的 Socket 物件。如果沒有指定任何參數，就會建立最初中斷連線的通訊端。 如果有指定參數，就會嘗試連線至指定的主機和連接埠。

注意：強烈建議使用「不含參數」的建構函式形式，接著加入任何事件偵聽程式，最後再搭配 host 和 port 參數呼叫 connect 方法。這個序列會保證所有事件偵聽程式都會正常運作。

會關閉通訊端。在呼叫 close() 方法之後，您就無法讀取或寫入任何資料。

只有當伺服器關閉連線時，才會傳送 close 事件。當您呼叫 close() 方法時，則不會傳送此事件。

您可以透過再次針對 Socket 物件呼叫 connect() 方法，重複使用此物件。

會將通訊端連線至指定的主機和連接埠。

如果連線立即失敗，就會傳送事件或擲回例外： 如果已指定主機，就會傳送錯誤事件；如果沒有指定任何主機，就會擲回例外。 否則，事件會回報連線的狀態。 如果通訊端已經連線，就會先關閉現有的連線。

參數

會清除通訊端輸出緩衝區中累積的任何資料。

在某些作業系統中，會在執行影格之間自動呼叫 flush()，但在其他作業系統 (例如 Windows)，除非您明確呼叫 flush()，否則不會傳送資料。為了確保您的應用程式在所有的作業系統中，都能確實的發揮作用，建議您在寫入每個訊息 (或相關的資料群組) 至通訊端後，呼叫 flush() 方法。

會從通訊端讀取 Boolean 值。 讀取單一位元組之後，如果位元組不是零，此方法就會傳回 true，否則會傳回 false。

會從通訊端讀取具有正負號的位元組。

從通訊端讀取由 length 參數指定的資料位元組數目。這些位元組會讀入指定的位元組陣列 (從 offset 表示的位置開始)。

參數

會從通訊端讀取 IEEE 754 雙精度浮點數。

會從通訊端讀取 IEEE 754 單精度浮點數。

會從通訊端讀取具有正負號的 32 位元整數。

會使用指定的字元集，從位元組串流讀取多位元組字串。

參數

會從通訊端讀取物件，並以 AMF 序列化格式編碼。

相關 API 元素

會從通訊端讀取具有正負號的 16 位元整數。

會從通訊端讀取無正負號的位元組。

會從通訊端讀取無正負號的 32 位元整數。

會從通訊端讀取無正負號的 16 位元整數。

會從通訊端讀取 UTF-8 字串。 此字串會假設以無正負號的短整數為前置詞，指出以位元組為單位的長度。

會從通訊端讀取 length 參數指定的 UTF-8 資料位元組數目，然後傳回字串。

參數

會將 Boolean 值寫入通訊端。 這個方法會使用 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，然後將主機名稱和埠號 80 做為引數傳遞給 localhost。 由於 CustomSocket 會擴充 Socket，所以呼叫 super() 會呼叫 Socket 的建構函式。
2. 然後，此範例會呼叫 configureListeners() 方法，此方法會為 Socket 事件加入偵聽程式。
3. 最後，會使用 localhost 做為主機名稱並將 80 做為連接埠號，來呼叫通訊端 connect() 方法。

注意：如果要執行這個範例，執行的伺服器必須和正在偵聽埠號 80 的 SWF 位於相同的網域 (這個範例中的 localhost)。

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();
    }
}