最開始做這個項目,是因為發現了一個叫 PjSIP 的開源 SIP 協議棧,它的實現比 OSIP 成熟許多,用它開發 SIP 應用也更簡單方便,於是我打算基於 PjSIP 做一個 SIP 軟電話原型。
技術選型
我選擇用 C++ 來實現,因為想在這個項目中實作一些通用機制,而 C++ 比腳本語言更適合底層開發,語言特性也比 C 豐富許多。界面部分用 VC 來做,但考慮到這只是原型產品,界面難看點無妨,本著「能用就行」的原則,仍沿用我熟悉的 VC6。設定存儲則採用本地檔案與 MySQL 資料庫並行的方式,主要是想提供更多樣的選擇。
兩個開發階段
項目分為兩個階段。第一階段把 SIP 軟電話原型做了出來,也實作了一些基本的通用機制。隨著我對軟體系統架構理解的累積,我開始想把那些通用機制強化成一套通用組件框架,並能基於它方便地開發其他應用——這就對組件的通用性提出了更高要求。於是第二階段我進行了程式碼重構與增強,最終實作了一套通用的應用程式組件框架。為了驗證它的通用性,除了原本基於它實作的 SIP 軟電話原型(單執行緒模式),我還實作了一個日誌伺服器原型(多執行緒模式)。
至於作業系統接口,目前直接使用 Windows 的接口;後續若要相容多作業系統,再對系統接口做一層封裝即可,這純粹是工作量的問題。
功能實現
- 實作通用的應用程式組件框架,封裝作業系統基本接口,不依賴第三方庫,提供各類組件模組與方便的使用接口。
- 實作 SIP 軟電話原型,能透過界面完成基本通話,支援基本設定參數,發起呼叫可透過號碼按鍵或點擊最近通話號碼。
- 實作日誌伺服器原型,支援最多 10 個日誌客戶端同時連線,能顯示所選連線上接收到的日誌,並支援基本設定參數。
總體設計思路
- 組件框架包含數十個類,因此設計了一棵類的繼承體系樹,從最基本的 JObject 根類派生出各類。把同類功能的類封裝進一個模組;若某模組有多種類型的類,就定義一個抽象基類來統一它們的接口。
- 透過一系列通用模組構成組件框架,如:模組、異常、智慧指標、鎖、單件、字串、日誌、記憶體管理、定時器、通信、訊息路由、事件、鏈表、佇列、持久化、後台任務、執行緒管理等。
- 基於組件框架,加上上層的 SipUa 模組與代理模組即可實作 SIP 軟電話;加上日誌伺服器模組與代理模組即可實作日誌伺服器。
- 為避免命名污染,各模組都包在 JFrameWork 命名空間裡,軟電話與日誌伺服器再把它引用進來。
- 設定的存儲支援 Ini 檔、Xml 檔、MySQL 三種方式,依 JDaemon 後台任務的設定檔 jdaemon_cfg.ini 決定採用哪一種。
- 框架內部定義了進程、執行緒、模組三個層級。以軟電話與日誌伺服器進程為例,包含 JModuleThread、JTimer、JPjSipUa、JPhoneAgent、JLogServerAgent、JLogSrvThread、JLogMsgThread 等執行緒;而 JModuleThread 執行緒內又包含 JStaticMemory、JLog、JTimer、JDaemon、JPjSipUa 等模組。
- 考慮到框架要支援相對複雜的應用,執行緒與模組之間採用 Actor 模式的訊息序列通信,最大限度減少鎖的使用,提高併發性。
- 在執行緒內定義「模組」這個層級,主要是為了能透過設定模組優先級,在執行緒內對模組做執行調度,實現類似協程的機制來減少執行緒切換、提升效能。
- 部分核心模組採用全域單件物件的方式方便存取,並用鎖保護共享資料。
文件與類的設計(節選)
框架的核心類分布在各個檔案中,以下挑選幾個重點說明:
- JObject:所有類的基類,包含基本資料型別封裝與通用字串處理。模組基類 JModule、異常類 JException、事件體基類 JEventBody 等都由它派生。
- 智慧指標:JAutoPtr 系列提供引用計數式的智慧指標模板,並針對鎖型別做函數特化處理。
- 記憶體管理:JStaticMemory 自己管理記憶體的分配與釋放,內部同時採用「塊」與「堆」兩種模式;對分配的記憶體加上頭尾資訊,記錄分配時的函式呼叫序列與校驗欄位,並透過定時器偵測寫越界,還能印出未釋放的記憶體資訊,方便定位洩漏。
- 通信:JSocket 系列封裝了 UDP/TCP,JCommEngine 作為通信實體負責訊息與事件的收發——進程內的事件透過路由表投遞到目標執行緒的模組事件佇列,進程間則用 UDP 序列化後傳送。
- 日誌:JLog 支援控制台、檔案、遠端三種輸出方式,並用裝飾模式為日誌加上時間戳等資訊,還能追蹤函式呼叫序列、定時維護遠端 TCP 連線。
- 協議封裝:JPjSip 對 PjSIP 的用戶接口進行封裝,採用外觀模式提供更易用的 C++ 接口;JPjSipUa 則統籌所有 SIP 相關操作。
整套框架以「模組—執行緒—進程」三層架構為骨幹,透過事件驅動與 Actor 訊息傳遞,兼顧了通用性與效能。