傳統網頁要提交註冊資料,路徑大致是 POST 或 AJAX 送到伺服器端處理。到了 HTML5 時代,我們多了一個選項:透過 WebSocket 進行資料交互。
WebSocket 的靈活性是傳統 HTTP 請求難以比擬的。長連線建立之後,伺服器可以主動向 client 推送資料,而且每次溝通不必再背著大量 HTTP 標頭。WebSocket 協定本身支援文字與二進位流兩種格式,其中文字格式的 JSON 與 JavaScript 配合起來格外順手,網頁與 WebSocket 之間的通訊因此變得便利。
但要真正享受這份便利,還是需要一層簡單的包裝。所幸 JSON 在各平台的元件都相當成熟,我們得以把 JSON 資料映射到伺服器端對應的方法去執行。以下用一個簡單的註冊流程,說明 HTML5 中 JSON 與 WebSocket 協作的處理過程。由於已做過封裝,使用起來相當直觀。

功能很單純:連上 WebSocket 服務後提交註冊資料。為了讓流程更順,我們在偵測到連線關閉時自動重開連線視窗。相關 JS 如下:
function connect() {
channel = new TcpChannel();
channel.Connected = function (evt) {
$('#dlgConnect').dialog('close');
};
channel.Disposed = function (evt) {
$('#dlgConnect').dialog('open');
};
channel.Error = function (evt) {
alert(evt);
};
channel.Connect($('#txtHost').val());
}
程式碼之所以這麼精簡,是因為我們在 WebSocket 之上封裝了一個 TcpChannel,把連線、斷線與錯誤都收攏成三個回呼函式(詳細實作可另見原始碼)。連線成功後即進入註冊表單。

填好資料、按下註冊後,表單內容會透過 WebSocket 送到伺服器端:
var invokeregister = { url: 'Handler.OnRegister', parameters: { UserName: '', Email: '', PassWord: ''} };
function register() {
$('#frmRegister').form('submit', {
onSubmit: function () {
var isValid = $(this).form('validate');
if (isValid) {
invokeregister.parameters = $('#frmRegister').serializeObject();
channel.Send(invokeregister, function (result) {
alert(result.data);
});
}
return false;
}
});
}
驗證通過後,只要透過 TcpChannel 送出一個「方法呼叫描述物件」即可。其中 url 指定要呼叫的類別方法,parameters 是該方法的參數,也可以是複雜的結構型別;第二個參數則是回呼函式,用來接收伺服器回傳的結果。這種寫法基本上就是把遠端方法呼叫的模型搬到了 WebSocket 上。
由於服務是基於 Beetle 的擴充機制處理,程式碼非常精簡。對應上述註冊邏輯的方法如下:
public class Handler
{
public string OnRegister(string UserName, string Email, string PassWord)
{
Console.WriteLine(UserName);
Console.WriteLine(Email);
Console.WriteLine(PassWord);
return UserName;
}
}
方法只需宣告相關參數即可,Beetle 的消息擴充控制器會自動解析前端送來的 JSON 並綁定到對應方法上執行(控制器實作同樣可於原始碼中查看)。邏輯寫完,接著只要把 WebSocket 服務開起來:
class Program : WebSocketJsonServer
{
static void Main(string[] args)
{
Beetle.Controllers.Controller.Register(new Handler());
TcpUtils.Setup("beetle");
Program server = new Program();
server.Open(8088);
Console.WriteLine("websocket start@8088");
System.Threading.Thread.Sleep(-1);
}
protected override void OnError(object sender, ChannelErrorEventArgs e)
{
base.OnError(sender, e);
Console.WriteLine(e.Exception.Message);
}
protected override void OnConnected(object sender, ChannelEventArgs e)
{
base.OnConnected(sender, e);
Console.WriteLine("{0} connected", e.Channel.EndPoint);
}
protected override void OnDisposed(object sender, ChannelDisposedEventArgs e)
{
base.OnDisposed(sender, e);
Console.WriteLine("{0} disposed", e.Channel.EndPoint);
}
}
如此一來,一個基於 HTML5 的 WebSocket 訊息交互與處理流程就完成了——只用了很少的程式碼,就打通了 JS 與伺服器之間的資料通道。
要實現這樣順手的交互體驗,有三層封裝省不掉:WebSocket 協定分析、物件與 JSON 的相互轉換、以及消息的分發控制。想了解細節可以下載原始碼研究。

WebSocket.Server.rar (641.79 kb)
最後補充一點實務提醒:這種模式把方法名直接暴露在協定裡,上 production 前務必加上身分驗證與權限檢查,否則等於把伺服器端的公開方法都開給外界呼叫。另外,長連線需留意心跳機制與連線數量上限,避免閒置連線累積佔用資源。