通訊端

主 TelnetSocket.mxml 檔案負責建立整個應用程式的使用者介面 (UI)。

除了負責建立 UI 之外，這個檔案還會定義兩個方法 (login() 和 sendCommand())，用來讓使用者連線至指定的伺服器。

下列程式碼將列出主應用程式檔案中的 ActionScript：

import com.example.programmingas3.socket.Telnet; 
 
private var telnetClient:Telnet; 
private function connect():void 
{ 
    telnetClient = new Telnet(serverName.text, int(portNumber.text), output); 
    console.title = "Connecting to " + serverName.text + ":" + portNumber.text; 
    console.enabled = true; 
} 
private function sendCommand():void 
{ 
    var ba:ByteArray = new ByteArray(); 
    ba.writeMultiByte(command.text + "\n", "UTF-8"); 
    telnetClient.writeBytesToSocket(ba); 
    command.text = ""; 
}

程式碼的第一行會從自訂的 com.example.programmingas.socket 套件中匯入 Telnet 類別。程式碼的第二行會宣告 Telnet 類別的實體 telnetClient，這個實體稍後將由 connect() 方法進行初始化作業。接著，宣告 connect() 方法並對之前宣告的 telnetClient 變數進行初始化作業。這個方法會將使用者指定的 telnet 伺服器名稱、telnet 伺服器連接埠和參考傳遞給顯示清單上的 TextArea 組件，以顯示來自通訊端伺服器的文字回應。connect() 方法的最後兩行則是設定「面板」的 title 屬性並啟用「面板」組件，讓使用者可以將資料傳送至遠端伺服器。主應用程式檔案中的最後一個方法 sendCommand()，會用來將使用者的命令傳送到遠端伺服器做為 ByteArray 物件。

Telnet 類別負責連線至遠端 Telnet 伺服器以及傳送/接收資料。

Telnet 類別會宣告下列私有變數：

private var serverURL:String; 
private var portNumber:int; 
private var socket:Socket; 
private var ta:TextArea; 
private var state:int = 0;

第一個變數 serverURL 包含使用者指定要連線的伺服器位址。

第二個變數 portNumber 是目前正在執行 Telnet 伺服器的埠號。根據預設，Telnet 服務是在埠號 23 上執行。

第三個變數 socket 是 Socket 實體，它的工作是嘗試連線至由 serverURL 和 portNumber 變數定義的伺服器。

第四個變數 ta 是「舞台」上 TextArea 組件實體的參考。這個組件會用來顯示來自遠端 Telnet 伺服器的回應，或任何可能的錯誤訊息。

最後一個變數 state 是一項數值，用來決定您 Telnet 用戶端可支援的選項。

如前所述，Telnet 類別的建構函式是由主應用程式檔案中的 connect() 方法來呼叫。

Telnet 建構函式會使用三個參數：server、port 和 output。server 和 port 參數可以指定執行 Telnet 服務之伺服器的伺服器名稱和埠號。最後一個參數 output 是「舞台」上 TextArea 組件實體的參考，會用來將伺服器輸出顯示給使用者。

public function Telnet(server:String, port:int, output:TextArea) 
{ 
    serverURL = server; 
    portNumber = port; 
    ta = output; 
    socket = new Socket(); 
    socket.addEventListener(Event.CONNECT, connectHandler); 
    socket.addEventListener(Event.CLOSE, closeHandler); 
    socket.addEventListener(ErrorEvent.ERROR, errorHandler); 
    socket.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler); 
    socket.addEventListener(ProgressEvent.SOCKET_DATA, dataHandler); 
    Security.loadPolicyFile("http://" + serverURL + "/crossdomain.xml"); 
    try 
    { 
        msg("Trying to connect to " + serverURL + ":" + portNumber + "\n"); 
        socket.connect(serverURL, portNumber); 
    } 
    catch (error:Error) 
    { 
        msg(error.message + "\n"); 
        socket.close(); 
    } 
}

若要將資料寫入通訊端連線，您可以呼叫 Socket 類別中的任何寫入方法。這些寫入方法包括 writeBoolean()、writeByte()、writeBytes()、writeDouble() 以及其他等等。然後，使用 flush() 方法，清除輸出緩衝區的資料。在 Telnet 伺服器中，會使用 writeBytes() 方法將資料寫入通訊端連線，此方法會以位元組陣列做為參數，並將它傳送至輸出緩衝區。writeBytesToSocket() 方法如下所示：

public function writeBytesToSocket(ba:ByteArray):void 
{ 
    socket.writeBytes(ba); 
    socket.flush(); 
}

主應用程式檔案中的 sendCommand() 方法會呼叫此方法。

每當從通訊端伺服器收到訊息或發生事件時，就會呼叫自訂的 msg() 方法。這個方法會將字串附加至「舞台」上的 TextArea，然後呼叫自訂的 setScroll() 方法，讓 TextArea 組件捲動到底部。下列範例將示範如何使用 msg() 方法：

private function msg(value:String):void 
{ 
    ta.text += value; 
    setScroll(); 
}

如果沒有設定自動捲動 TextArea 組件的內容，使用者就必須以手動方式將捲軸拖曳到文字區域，才能看到最新的伺服器回應。

setScroll() 方法中只包含一行 ActionScript，可以垂直捲動 TextArea 組件的內容，以便讓使用者看到最後傳回的文字。下列程式碼片段將說明如何使用 setScroll() 方法：

public function setScroll():void 
{ 
    ta.verticalScrollPosition = ta.maxVerticalScrollPosition; 
}

這個方法會設定 verticalScrollPosition 屬性，也就是目前顯示的最上面一列字元的行號，並將它設為 maxVerticalScrollPosition 屬性的值。

下列程式碼將示範如何以 Java 撰寫一個簡單的 XMLSocket 伺服器，它會接受傳入的連線，並在命令提示視窗中顯示收到的訊息。雖然您可以在透過命令列啟動伺服器時，指定不同的埠號，但根據預設，新的伺服器會建立在本機電腦的連接埠 8080 上。

建立新的文字文件，並在其中加入下列程式碼：

import java.io.*; 
import java.net.*; 
 
class SimpleServer 
{ 
    private static SimpleServer server; 
    ServerSocket socket; 
    Socket incoming; 
    BufferedReader readerIn; 
    PrintStream printOut; 
 
    public static void main(String[] args) 
    { 
        int port = 8080; 
 
        try 
        { 
            port = Integer.parseInt(args[0]); 
        } 
        catch (ArrayIndexOutOfBoundsException e) 
        { 
            // Catch exception and keep going. 
        } 
 
        server = new SimpleServer(port); 
    } 
 
    private SimpleServer(int port) 
    { 
        System.out.println(">> Starting SimpleServer"); 
        try 
        { 
            socket = new ServerSocket(port); 
            incoming = socket.accept(); 
            readerIn = new BufferedReader(new InputStreamReader(incoming.getInputStream())); 
            printOut = new PrintStream(incoming.getOutputStream()); 
            printOut.println("Enter EXIT to exit.\r"); 
            out("Enter EXIT to exit.\r"); 
            boolean done = false; 
            while (!done) 
            { 
                String str = readerIn.readLine(); 
                if (str == null) 
                { 
                    done = true; 
                } 
                else 
                { 
                    out("Echo: " + str + "\r"); 
                    if(str.trim().equals("EXIT")) 
                    { 
                        done = true; 
                    } 
                } 
                incoming.close(); 
            } 
        } 
        catch (Exception e) 
        { 
            System.out.println(e); 
        } 
    } 
 
    private void out(String str) 
    { 
        printOut.println(str); 
        System.out.println(str); 
    } 
}

將文件儲存到硬碟並命名為 SimpleServer.java，然後使用 Java 編譯器加以編譯，以建立名為 SimpleServer.class 的 Java 類別檔案。

開啟命令列提示，並輸入 java SimpleServer，就可以啟動 XMLSocket 伺服器。SimpleServer.class 檔案可以位於本機電腦或網路上的任何位置，不一定要放在網站伺服器的根目錄下。

如果因為檔案不在 Java 類別路徑內而無法啟動伺服器，請嘗試使用 java -classpath .SimpleServer 來啟動伺服器。

若要從 應用程式連線至 XMLSocket，必須先建立 XMLSocket 類別的新實體，然後在傳遞主機名稱和埠號期間呼叫 XMLSocket.connect() 方法，如下所示：

var xmlsock:XMLSocket = new XMLSocket(); 
xmlsock.connect("127.0.0.1", 8080);

每當您從伺服器接收資料，就會傳送 data 事件 (flash.events.DataEvent.DATA)：

xmlsock.addEventListener(DataEvent.DATA, onData); 
private function onData(event:DataEvent):void 
{ 
    trace("[" + event.type + "] " + event.data); 
}

若要將資料傳送至 XMLSocket 伺服器，請使用 XMLSocket.send() 方法並傳遞 XML 物件或字串。Flash Player 會將所提供的參數轉換成 String 物件，並在內容後面加上零 (0) 位元組後傳送到 XMLSocket 伺服器：

xmlsock.send(xmlFormattedData);

XMLSocket.send() 方法並不會傳回值來指出資料是否已傳輸成功。如果在傳送資料時發生錯誤，就會擲出 IOError 錯誤。

傳送到 XML 通訊端伺服器的每項訊息都必須以換行 (\n) 字元做為結尾。

如需詳細資訊，請參閱 XMLSocket。