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.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