高性能 TCP & UDP 通信框架 HP-Socket v3.2.2 正式發布

　　HP-Socket 是一套通用的高性能 TCP/UDP 通信框架，包含服務端組件、客戶端組件和 Agent 組件，廣泛適用于各種不同應用場景的 TCP/UDP 通信系統，提供 C/C++、C#、Delphi、E（易語言）、Java、Python 等編程語言接口。HP-Socket 對通信層實現完全封裝，應用程序不必關注通信層的任何細節；HP-Socket 提供基于事件通知模型的 API 接口，能非常簡單高效地整合到新舊應用程序中。

　　為了讓使用者能方便快速地學習和使用 HP-Socket，迅速掌握框架的設計思想和使用方法，特此精心制作了大量 Demo 示例（如：PUSH 模型示例、PULL 模型示例、性能測試示例以及其它編程語言示例）。HP-Socket 目前運行在 Windows 平臺，將來會實現跨平臺支持。

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

通用性

• HP-Socket 的唯一職責就是接收和發送字節流，不參與應用程序的協議解析等工作。
• HP-Socket 與應用程序通過接口進行交互，并完全解耦。任何應用只要實現了 HP-Socket 的接口規范都可以無縫整合 HP-Socket。

易用性

　　易用性對所有通用框架都是至關重要的，如果太難用還不如自己重頭寫一個來得方便。因此，HP-Socket 的接口設計得非常簡單和統一。

　　HP-Socket 完全封裝了所有底層通信細節，應用程序不必也不能干預底層通信操作。通信連接被抽象為 Connection ID，Connection ID 作為連接的唯一標識提供給應用程序來處理不同的連接。

高性能

　　HP-Socket 作為底層的通用框架，性能是關鍵指標，絕對不能成為系統的瓶頸。HP-Socket 在設計上充分考慮性能、使用場景、復雜性和易用性等因素，作出以下幾點設計決策：

• Client 組件：基于 Event Select 通信模型，在單獨線程中執行通信操作，避免與主線程或其他線程相互干擾。每個組件對象管理一個 Socket 連接。
• Server 組件：基于 IOCP 通信模型，并結合緩存池、私有堆（Private Heap）等技術，支持超大規模連接，在高并發場景下實現高效內存管理。
• Agent 組件：對于代理服務器或中轉服務器等應用場景，服務器自身也作為客戶端向其它服務器發起大規模連接，一個 Agent 組件對象同時可管理多個 Socket 連接；Agent 組件與 Server 組件采用相同的技術架構，可以用作代理服務器或中轉服務器的客戶端部件。

伸縮性

　　應用程序能夠根據不同的容量要求、通信規模和資源狀況等現實場景調整 HP-Socket 的各項性能參數（如：工作線程的數量、緩存池的大小、發送模式和接收模式等），優化資源配置，在滿足應用需求的同時不必過度浪費資源。

　　 (項目主頁：點擊這里，下載地址：點擊這里)

*** v3.2.2 更新 ***

 > 增加若干幫助方法：

1. 批量發送方法 SendPackets()

   1) IClient/IServer/IAgent 增加方法 SendPackets(dwConnID, pBuffers[], iBufferCount)
   2) 對于 TCP 組件 - 順序發送所有數據包
   3) 對于 UDP 組件 - 把所有數據包組合成一個數據包發送（總長度不能大于 UDP 包最大長度）

2. 小文件發送方法 SendSmallFile()

   1) ITcpClient/ITcpServer/ITcpAgent 增加方法 SendSmallFile(lpszFileName, pHead, pTail)
   2) 通過 pHead 和 pTail 參數，可以分別在文件數據的頭部和尾部加入自定義數據
   3) SendSmallFile() 只能發送 4096 KB 以內大小的文件

3. HPSocket.dll 和 HPSocket4C.dll 增加以下導出方法

   1) SYS_WSAGetLastError()：調用系統的 WSAGetLastError()
   2) SYS_SetSocketOption()：調用系統的 setsockopt()
   3) SYS_GetSocketOption()：調用系統的 getsockopt()
   4) SYS_IoctlSocket()    ：調用系統的 ioctlsocket()
   5) SYS_WSAIoctl()       ：調用系統的 WSAIoctl()

> 升級說明：

1. 使用 HP-Socket v3.2.1 及以前版本的應用程序可以安全升級到 HP-Socket v3.2.2

*** v3.2.1 更新 ***

 > 增加 TcpAgent / TcpPullAgent 通信組件：

1. 對于代理服務器或中轉服務器等應用場景，服務器自身也作為客戶端向其它服務器發起大規模連接
2. TcpClient / TcpPullClient 基于 Event Select 通信模型，每個組件對象管理一個 Socket，并開啟一個線程，不適合上述應用場景
3. TcpAgent / TcpPullAgent 基于 IOCP 通信模型，一個組件對象管理多個 Socket，適合用作代理服務器或中轉服務器的客戶端通信組件
4. TcpAgent / TcpPullAgent 的使用方式依然簡單，提供以下接口方法：

   /* 1) 通知接口方法 */
   OnPrepareConnect(CONNID dwConnID, SOCKET socket)
   OnConnect(CONNID dwConnID)
   OnSend(CONNID dwConnID, const BYTE* pData, int iLength)
   OnReceive(CONNID dwConnID, const BYTE* pData, int iLength)  //（Push 模型）
   OnReceive(CONNID dwConnID, int iLength)                     //（Pull 模型）
   OnClose(CONNID dwConnID)
   OnError(CONNID dwConnID, EnSocketOperation enOperation, int iErrorCode)
   OnAgentShutdown()
   
   /* 2) 主要操作方法 */
   Start(LPCTSTR pszBindAddress = nullptr, BOOL bAsyncConnect = TRUE)
   Stop()
   Connect(LPCTSTR pszRemoteAddress, USHORT usPort, CONNID* pdwConnID = nullptr)
   Send(CONNID dwConnID, const BYTE* pBuffer, int iLength)
   Disconnect(CONNID dwConnID, BOOL bForce = TRUE)
   Fetch(CONNID dwConnID, BYTE* pData, int iLength)    //（Pull 模型）

5. 增加 TcpAgent / TcpPullAgent 使用示例：Agent-PFM / Agent-Pull / Agent-4C
   
   
6. 增加 TcpAgent + TcpServer 實現的 HTTP 代理服務器示例：HttpProxy
   
   

> 增加 HPSocket for Java SDK：

1. 提供 Java 開發包：hpsocket-3.2.1.jar（通過 JNA 實現，目前只支持 Windows 平臺）
2. 運行環境：JDK 1.6+，JVM 運行在 server 模式（"java -server"，在 client 模式下性能受影響）
3. MBCS 和 Unicode 版本分布位于包 org.jessma.hpsocket.mbcs 和 org.jessma.hpsocket.unicode
4. HPSocket for Java SDK 提供以下通信組件：

   1) TcpServer：TCP 通信服務端組件，支持 PUSH/PULL 模型
   2) TcpClient：TCP 通信客戶端組件，支持 PUSH/PULL 模型
   3) TcpAgent ：TCP 通信 Agent 組件，支持 PUSH/PULL 模型
   4) UdpServer：UDP 通信服務端組件，支持 PUSH 模型
   5) UdpClient：UDP 通信客戶端組件，支持 PUSH 模型

5. HPSocket4J 的使用方法（以 TcpAgent 為例）：

   /* 0: 應用程序加入 hpsocket-3.2.1.jar 和 jna-4.1.0.jar */
   
   /* 1: 創建通信組件對象 */
   TcpAgent agent = TcpAgent.create(Mode.PUSH);
   
   /* 2: 設置回調函數對象 */
   // （可選）
   agent.setCallBackOnPrepareConnect(new OnPrepareConnectImpl());
   // （可選）
   agent.setCallBackOnConnect(new OnConnectImpl());
   // （必須）PUSH 模型需要設置 OnReceive 回調函數對象
   agent.setCallBackOnReceive(new OnReceiveImpl());
   // （必須）PULL 模型需要設置 OnPullReceive 回調函數對象
   // agent.setCallBackOnPullReceive(new OnPullReceiveImpl());
   // （可選）
   agent.setCallBackOnSend(new OnSendImpl());
   // （必須）
   agent.setCallBackOnClose(new OnCloseImpl());
   // （必須）
   agent.setCallBackOnError(new OnErrorImpl());
   // （可選）
   agent.setCallBackOnAgentShutdown(new OnAgentShutdownImpl());
   
   /* 3：啟動通信組件 */
   agent.start("127.0.0.1", false);
   
   /* 4：連接服務器 */
   agent.connect("localhost", (short)5555, pdwConnID);
   
   /* 5：處理通信數據 */
   // 響應 OnReceive / OnPullReceive 事件接收數據
   // 使用 agent.send(dwConnID, data, data.length) 發送數據
   
   /* 6：關閉通信組件 */
   agent.stop();
   
   /* 7：銷毀通信組件 */
   TcpAgent.destroy(agent);

6. 增加示例工程 TestEcho-4J，展示 HPSocket4J 的使用方法（包括 PULL 模型示例和性能測試示例）