HP-Socket 是一套通用的高性能 TCP/UDP/HTTP 通信框架,包含服務端組件、客戶端組件和 Agent 組件,廣泛適用於各種不同應用場景的 TCP/UDP/HTTP 通信系統,提供 C/C++、C#、Delphi、E(易語言)、Java、Python 等編程語言介面。HP-Socket ...
HP-Socket 是一套通用的高性能 TCP/UDP/HTTP 通信框架,包含服務端組件、客戶端組件和 Agent 組件,廣泛適用於各種不同應用場景的 TCP/UDP/HTTP 通信系統,提供 C/C++、C#、Delphi、E(易語言)、Java、Python 等編程語言介面。HP-Socket 對通信層實現完全封裝,應用程式不必關註通信層的任何細節;HP-Socket 提供基於事件通知模型的 API 介面,能非常簡單高效地整合到新舊應用程式中。
為了讓使用者能方便快速地學習和使用 HP-Socket,迅速掌握框架的設計思想和使用方法,特此精心製作了大量 Demo 示例(如:PUSH 模型示例、PULL 模型示例、PACK 模型示例、性能測試示例以及其它編程語言示例)。HP-Socket 目前運行在 Windows 平臺,將來會實現跨平臺支持。
----------------------------------------------------------------
通用性
- HP-Socket 的唯一職責就是接收和發送位元組流,不參與應用程式的協議解析等工作。
- HP-Socket 與應用程式通過介面進行交互,並完全解耦。任何應用只要實現了 HP-Socket 的介面規範都可以無縫整合 HP-Socket。
易用性
- 易用性對所有通用框架都是至關重要的,如果太難用還不如自己重頭寫一個來得方便。因此,HP-Socket 的介面設計得非常簡單和統一。
- HP-Socket 完全封裝了所有底層通信細節,應用程式不必也不能幹預底層通信操作。通信連接被抽象為 Connection ID,Connection ID 作為連接的唯一標識提供給應用程式來處理不同的連接。
- HP-Socket 提供 PUSH / PULL / PACK 等接收模型, 應用程式可以靈活選擇以手工方式、 半自動方式或全自動方式處理封解包, PULL / PACK 接收模型在降低封解包處理複雜度的同時能大大減少出錯幾率。
高性能
- Client 組件:基於 Event Select 通信模型,在單獨線程中執行通信操作,避免與主線程或其他線程相互干擾。每個組件對象管理一個 Socket 連接。
- Server 組件:基於 IOCP 通信模型,並結合緩存池、私有堆(Private Heap)等技術,支持超大規模連接,在高併發場景下實現高效記憶體管理。
- Agent 組件:對於代理伺服器或中轉伺服器等應用場景,伺服器自身也作為客戶端向其它伺服器發起大規模連接,一個 Agent 組件對象同時可管理多個 Socket 連接;Agent 組件與 Server 組件採用相同的技術架構,可以用作代理伺服器或中轉伺服器的客戶端部件。
伸縮性
應用程式能夠根據不同的容量要求、通信規模和資源狀況等現實場景調整 HP-Socket 的各項性能參數(如:工作線程的數量、緩存池的大小、發送模式和接收模式等),優化資源配置,在滿足應用需求的同時不必過度浪費資源。
*** v4.1.1更新 ***
> WebSocket 支持:
-----------------
- 所有 HTTP 組件增加 WebSocket 方法
1) SendWSMessage(): 發送 WebSocket 數據包
2) GetWSMessageState(): 獲取當前 WebSocket 狀態 -
所有 HTTP 組件監聽器增加 WebSocket 事件
1) OnWSMessageHeader(): WebSocket 數據包頭通知
2) OnWSMessageBody(): WebSocket 數據包體通知
3) OnWSMessageComplete(): WebSocket 數據包完成通知 - 示例 Demo TestEcho-Http 和 TestEcho-Http-4C 支持 WebSocket
> 增加 HTTP Sync Client 通信組件:
-----------------
- HTTP Sync Client 實現同步 HTTP 通信,不需要事件監聽器
- HTTP Sync Client 組件類: CHttpSyncClient、CHttpsSyncClient
- HTTP Sync Client 實現介面: ITcpClient / IHttpSyncRequester
- 示例 Demo TestEcho-Http 和 TestEcho-Http-4C 提供 HTTP Sync Client 示例
*** v4.0.1更新 ***
> 增加 HTTP 系列通信組件:
-----------------
-
新增 HTTP Server 組件
1) 組件類:CHttpServer、CHttpsServer
2) 實現介面:ITcpServer / IComplexHttpResponder
3) 監聽器介面:IHttpServerListener -
新增 HTTP Agent 組件
1) 組件類:CHttpAgent、CHttpsAgent
2) 實現介面:ITcpAgent / IComplexHttpRequester
3) 監聽器介面:IHttpAgentListener -
新增 HTTP Client 組件
1) 組件類:CHttpClient、CHttpsClient
2) 實現介面:ITcpClient / IHttpRequester
3) 監聽器介面:IHttpServerListener -
新增 HTTP 示例 Demo
1) TestEcho-Http (源代碼)
2) TestEcho-Http-4C (4C LIB / 4C DLL) - Http 監聽器
1) 監聽器事件:
OnMessageBegin() : 【可選】開始解析 OnRequestLine() : 【可選】請求行解析完成(僅用於 HTTP 服務端) OnStatusLine() : 【可選】狀態行解析完成(僅用於 HTTP 客戶端) OnHeader() : 【可選】請求頭通知 OnHeadersComplete() : 【必須】請求頭完成通知 OnBody() : 【必須】請求體報文通知 OnChunkHeader() : 【可選】Chunked 報文頭通知 OnChunkComplete() : 【可選】Chunked 報文結束通知 OnMessageComplete() : 【必須】完成解析通知 OnUpgrade() : 【可選】升級協議通知 OnParseError() : 【必須】解析錯誤通知
2) 監聽器事件返回值(EnHttpParseResult):
HPR_OK : 繼續解析 HPR_SKIP_BODY : 跳過當前請求 BODY(僅用於 OnHeadersComplete 事件) HPR_UPGRADE : 升級協議(僅用於 OnHeadersComplete 事件) HPR_ERROR : 終止解析,斷開連接
> 組件介面調整:
-----------------
- IServer 和 IAgent 組件的所有監聽器回調方法增加‘事件源’參數,如:OnShutdown() -> OnShutdown(T* pSender)
- IClient 組件的所有監聽器回調方法增加‘連接ID’參數,如:OnHandShake(IClient* pClient) -> OnHandShake(T* pSender, CONNID dwConnID)
- IServer 和 IAgent 介面增加介面方法: Get/SetMaxConnectionCount() 用於設置最大連接數,最大連接數預設:10000
- OnHandShake() 事件觸發規則調整:非 SSL 組件在 OnConnect() 事件後也觸發 OnHandShake() 事件,使 SSL 組件和 SSL 組件處理流程一致
- HPSocket4C 增加 PACK 組件監聽器的創建、銷毀方法,新版本必須使用下列方法創建、銷毀 PACK 組件監聽器:
1) Create_HP_TcpPackServerListener / Destroy_HP_TcpPackServerListener
2) Create_HP_TcpPackAgentListener / Destroy_HP_TcpPackAgentListener
3) Create_HP_TcpPackClientListener / Destroy_HP_TcpPackClientListener
-
SSL 組件支持 SNI
1) SSL 初始化方法 HP_SSL_Initialize(),增加 SNI 回調函數指針參數
2) 新增方法 HP_SSL_AddServerContext(),用於 載入 SNI 主機證書
> 其他更新:
-----------------
- IServer 和 IAgent 組件採用 Ring Pool 取代 R/W Lock + Map 維護活動連接,提升讀寫和併發性能
- 更新所有 Demo 示例代碼
*** v3.5.1更新 ***
> 增加 SSL 系列通信組件:
-----------------
- 新增 SSL PUSH 組件:CSSLServer、CSSLAgent、CSSLClient
- 新增 SSL PULL 組件:CSSLPullServer、CSSLPullAgent、CSSLPullClient
- 新增 SSL PACK 組件:CSSLPackServer、CSSLPackAgent、CSSLPackClient
- SSL Server 實現 ITcpServer 介面,SSL Agent 實現 ITcpAgent 介面,SSL Client 實現 ITcpClient 介面
- 啟動 SSL 通信組件前需要調用 HP_SSL_Initialize() 函數初始化 SSL 全局環境參數
- 通信結束後調用 HP_SSL_Cleanup() 函數清理 SSL 全局運行環境
- 新增 SSL 相關示例 Demo:
1) TestEcho-SSL (源代碼) 2) TestEcho-SSL-Pack (DLL / 4C DLL) 3) TestEcho-SSL-4C (4C LIB) 4) TestEcho-SSL-PFM (LIB)
> 組件介面調整:
-----------------
- ITcpServerListener 介面增加 SSL 握手成功事件:OnHandShake(CONNID dwConnID)
- ITcpAgentListener 介面增加 SSL 握手成功事件:OnHandShake(CONNID dwConnID)
- ITcpClientListener 介面增加 SSL 握手成功事件:OnHandShake(IClient* pClient)
- 枚舉類型 EnSocketError 增加‘SSL 環境未就緒’錯誤代碼 SE_SSL_ENV_NOT_READY
- 增加枚舉類型:EnSSLSessionMode(SSL 工作模式),EnSSLVerifyMode(SSL 驗證模式)
- HPSocket-SSL DLL 主要頭文件:SocketInterface-SSL.h,HPSocket-SSL.h
- HPSocket4C-SSL DLL 主要頭文件:HPSocket4C-SSL.h
- Tcp Pack 系列組件可設置的最大包長調整為 4194303/0x3FFFFF 位元組
- Tcp Pack 系列組件的有效包頭標識取值範圍調整為 0 ~ 1023/0x3FF
> 增加靜態庫工程:
-----------------
- 新增項目工程 HPSocketLIB 和 HPSocketLIB4C 用於編譯 HPSocket 和 HPSocket4C 靜態庫
- 靜態庫與動態庫的使用方式一致(請參考示例 Demo:TestEcho-SSL-4C 和 TestEcho-SSL-PFM)
- 使用 HPSocket 或 HPSocket4C 靜態庫時,需要在工程屬性中定義預處理巨集 -> HPSOCKET_STATIC_LIB
- 靜態庫目標文件不包含在發佈包中(因為太大),如果需要請自行編譯
*** v3.4.4更新 ***
> 增加 Tcp Pack 系列通信組件:
-----------------
- Tcp Pack 系列組件保證每個 OnReceive 事件都嚮應用程式提供一個完整數據包
- Tcp Pack 系列組件是 PUSH/PULL 模式的結合體,應用程式不必處理分包(如:PUSH)與數據抓取(如:PULL)
- Tcp Pack 系列組件提供 Get/SetMaxPackSize() 和 Get/SetPackHeaderFlag() 方法,用來設置最大包長和包頭標識
- CTcpPackServer 實現 ITcpServer 介面,CTcpPackAgent 實現 ITcpAgent 介面,CTcpPackClient 實現 ITcpClient 介面
> 組件介面調整:
-----------------
- OnClose/OnError 合併為一個通信事件: OnClose(CONNID dwConnID, EnSocketOperation enOperation, int iErrorCode)
- 枚舉類型 EnSocketOperation 增加一個枚舉值: SO_CLOSE = 5,標識關閉 Socket 操作
- IServer 和 IAgent 介面刪除介面方法: Get/SetRecvPolicy()
- IServer 和 IAgent 介面刪除介面方法: Get/SetMaxShutdownWaitTime()
> Bug 修複:
-----------------
- 修複 TCP Pack Agent “非同步連接失敗導致程式崩潰” Bug
- 修複 vc-common-src 公共代碼包的 CCASQueue 可能導致無限迴圈 Bug