通訊端

主 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 檔案可以位於本機電腦或網路上的任何位置，不一定要放在網站伺服器的根目錄下。

若要從 應用程式連線至 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 錯誤。

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