高性能 TCP/UDP/HTTP 通訊框架 HP-Socket v4.0.1

　　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 v4.0 開發指南》

----------------------------------------------------------------

通用性

• 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 系列通訊組件：

-----------------

1. 新增 HTTP Server 組件
   1) 組件類：CHttpServer、CHttpsServer
   2) 實現接口：ITcpServer / IComplexHttpResponder
   3) 監聽器接口：IHttpServerListener
2. 新增 HTTP Agent 組件
   1) 組件類：CHttpAgent、CHttpsAgent
   2) 實現接口：ITcpAgent / IComplexHttpRequester
   3) 監聽器接口：IHttpAgentListener
3. 新增 HTTP Client 組件
   1) 組件類：CHttpClient、CHttpsClient
   2) 實現接口：ITcpClient / IHttpRequester
   3) 監聽器接口：IHttpServerListener
4. 新增 HTTP 示例 Demo
   1) TestEcho-Http （源代碼）
   2) TestEcho-Http-4C （4C LIB / 4C DLL）
5. 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	: 終止解析，斷開鏈接

 > 組件接口調整：

-----------------

1. IServer 和 IAgent 組件的全部監聽器回調方法增長‘事件源’參數，如：OnShutdown() -> OnShutdown(T* pSender)
2. IClient 組件的全部監聽器回調方法增長‘鏈接ID’參數，如：OnHandShake(IClient* pClient) -> OnHandShake(T* pSender, CONNID dwConnID)
3. IServer 和 IAgent 接口增長接口方法： Get/SetMaxConnectionCount() 用於設置最大鏈接數，最大鏈接數默認：10000
4. OnHandShake() 事件觸發規則調整：非 SSL 組件在 OnConnect() 事件後也觸發 OnHandShake() 事件，使 SSL 組件和 SSL 組件處理流程一致
5. HPSocket4C 增長 PACK 組件監聽器的建立、銷燬方法，新版本必須使用下列方法建立、銷燬 PACK 組件監聽器：
   1) Create_HP_TcpPackServerListener / Destroy_HP_TcpPackServerListener
   2) Create_HP_TcpPackAgentListener / Destroy_HP_TcpPackAgentListener
   3) Create_HP_TcpPackClientListener / Destroy_HP_TcpPackClientListener
   
6. SSL 組件支持 SNI
   1) SSL 初始化方法 HP_SSL_Initialize()，增長 SNI 回調函數指針參數
   2) 新增方法 HP_SSL_AddServerContext()，用於 加載 SNI 主機證書

 > 其餘更新：

-----------------

1. IServer 和 IAgent 組件採用 Ring Pool 取代 R/W Lock + Map 維護活動鏈接，提高讀寫和併發性能
2. 更新全部 Demo 示例代碼

---

*** v3.5.1更新 ***

 > 增長 SSL 系列通訊組件：

-----------------

1. 新增 SSL PUSH 組件：CSSLServer、CSSLAgent、CSSLClient
2. 新增 SSL PULL 組件：CSSLPullServer、CSSLPullAgent、CSSLPullClient
3. 新增 SSL PACK 組件：CSSLPackServer、CSSLPackAgent、CSSLPackClient
4. SSL Server 實現 ITcpServer 接口，SSL Agent 實現 ITcpAgent 接口，SSL Client 實現 ITcpClient 接口
5. 啓動 SSL 通訊組件前須要調用 HP_SSL_Initialize() 函數初始化 SSL 全局環境參數
6. 通訊結束後調用 HP_SSL_Cleanup() 函數清理 SSL 全局運行環境
7. 新增 SSL 相關示例 Demo：

   1) TestEcho-SSL		（源代碼）
   2) TestEcho-SSL-Pack	（DLL / 4C DLL）
   3) TestEcho-SSL-4C	（4C LIB）
   4) TestEcho-SSL-PFM	（LIB）

> 組件接口調整：

-----------------

1. ITcpServerListener 接口增長 SSL 握手成功事件：OnHandShake(CONNID dwConnID)
2. ITcpAgentListener 接口增長 SSL 握手成功事件：OnHandShake(CONNID dwConnID)
3. ITcpClientListener 接口增長 SSL 握手成功事件：OnHandShake(IClient* pClient)
4. 枚舉類型 EnSocketError 增長‘SSL 環境未就緒’錯誤代碼 SE_SSL_ENV_NOT_READY 
5. 增長枚舉類型：EnSSLSessionMode（SSL 工做模式），EnSSLVerifyMode（SSL 驗證模式） 
6. HPSocket-SSL DLL 主要頭文件：SocketInterface-SSL.h，HPSocket-SSL.h
7. HPSocket4C-SSL DLL 主要頭文件：HPSocket4C-SSL.h
8. Tcp Pack 系列組件可設置的最大包長調整爲 4194303/0x3FFFFF 字節
9. Tcp Pack 系列組件的有效包頭標識取值範圍調整爲 0 ~ 1023/0x3FF

> 增長靜態庫工程：

-----------------

1. 新增項目工程 HPSocketLIB 和 HPSocketLIB4C 用於編譯 HPSocket 和 HPSocket4C 靜態庫
2. 靜態庫與動態庫的使用方式一致（請參考示例 Demo：TestEcho-SSL-4C 和 TestEcho-SSL-PFM）
3. 使用 HPSocket 或 HPSocket4C 靜態庫時，須要在工程屬性中定義預處理宏 -> HPSOCKET_STATIC_LIB
4. 靜態庫目標文件不包含在發佈包中（由於太大），若是須要請自行編譯

---

*** v3.4.4更新 ***

 > 增長 Tcp Pack 系列通訊組件：

-----------------

1. Tcp Pack 系列組件保證每一個 OnReceive 事件都向應用程序提供一個完整數據包
2. Tcp Pack 系列組件是 PUSH/PULL 模式的結合體，應用程序沒必要處理分包（如：PUSH）與數據抓取（如：PULL）
3. Tcp Pack 系列組件提供 Get/SetMaxPackSize() 和 Get/SetPackHeaderFlag() 方法，用來設置最大包長和包頭標識
4. CTcpPackServer 實現 ITcpServer 接口，CTcpPackAgent 實現 ITcpAgent 接口，CTcpPackClient 實現 ITcpClient 接口

> 組件接口調整：

-----------------

1. OnClose/OnError 合併爲一個通訊事件： OnClose(CONNID dwConnID, EnSocketOperation enOperation, int iErrorCode)
2. 枚舉類型 EnSocketOperation 增長一個枚舉值： SO_CLOSE = 5，標識關閉 Socket 操做
3. IServer 和 IAgent 接口刪除接口方法： Get/SetRecvPolicy()
4. IServer 和 IAgent 接口刪除接口方法： Get/SetMaxShutdownWaitTime()

> Bug 修復：

-----------------

1. 修復 TCP Pack Agent 「異步鏈接失敗致使程序崩潰」 Bug
2. 修復 vc-common-src 公共代碼包的 CCASQueue 可能致使無限循環 Bug