高性能 Socket 組件 HP-Socket v3.2.1-RC2 發布

> 升級說明：

1. HP-Socket v3.2.1 在功能上兼容 HP-Socket v3.1.3 及以前版本
2. 接口有變化，需要根據提示修改程序代碼；注意：現有程序不能直接替換 v3.1.3 的 DLL
3. EnServerError / EnClientError 枚舉類型合并為 EnSocketError，注意一些枚舉值發生了變化

*** v3.1.3 更新 ***

 > 增加其它語言 Demo：

1. C#
2. Delphi
3. E 語言

> Bug Fix：

1. 修復 IP 地址判斷錯誤 Bug
    

   1) 客戶端連接服務器時，如果服務器 IP 地址滿位（12個數字：‘AAA.BBB.CCC.DDD’），IP 地址解析錯誤
   2) 影響組件：所有 TCP/UDP 客戶端組件
   3) 影響版本：v3.1.2 及之前所有版本

    
2. 修復域名或主機名的 IP 地址解析錯誤 Bug
    

   1) 客戶端組件通過域名或主機名連接服務器時，可能會解析到錯誤的 IP 地址
   2) 影響組件：所有 TCP/UDP 客戶端組件
   3) 影響版本：v3.1.2 及之前所有版本

*** v3.1.2 更新 ***

 > 修改 Server 組件的 OnClose() / OnError() 事件的觸發規則：

1. 以前版本的 TCP/UDP Server 組件中，當關閉一個連接時可能會同時觸發一個 OnClose() 事件和若干個 OnError() 事件
2. 由于存在上述可能性，所以應用程序需要對 OnClose() / OnError() 的處理事件代碼段進行同步
3. 從 v3.1.2 開始，當多個 OnClose() / OnError() 事件同時發生時，組件只會向應用程序通知第一個事件，后續事件則忽略
   
4. 因此，應用程序在處理 OnClose() / OnError() 事件時不必處理同步，減少了出錯的可能和編寫同步及檢測代碼的負擔
5. 示例代碼
   
   

   /* 示例代碼一：*/
   /*----------------------------------------------------------------------------*/
   ISocketListener::EnHandleResult CServerDlg::OnClose(CONNID dwConnID)
   {
       // 以前版本：有可能存在并發的 OnClose()/OnError()，要把代碼放在臨界區中并檢測返回值
   
       CCriSecLock locallock(m_csPkgInfo); // <-- 臨界區
   
       PVOID pInfo = nullptr;
       // <-- 檢測返回值
       if(m_Server->GetConnectionExtra(dwConnID, &pInfo) && pInfo != nullptr)
       {
           m_Server->SetConnectionExtra(dwConnID, nullptr);
           delete pInfo;
       }
   }
   
   /* 示例代碼二：*/
   /*----------------------------------------------------------------------------*/
   ISocketListener::EnHandleResult CServerDlg::OnClose(CONNID dwConnID)
   {
       // v3.1.2 版本：只會接收到一個 OnClose()/OnError() 事件，能安全地移除臨界區代碼和檢測代碼
   
       PVOID pInfo = nullptr;
       m_Server->GetConnectionExtra(dwConnID, &pInfo);
       ASSERT(pInfo != nullptr);
   
       delete pInfo;
   }

*** v3.1.1 更新 ***

 > 增加導出純 C 函數的動態鏈接庫 HPSocket4C.dll：

1. 增加代碼文件 HPSocket4C.h 和 HPSocket4C.cpp，用于創建 HPSocket4C.dll
2. 導出純 C 函數，讓其它語言（如：C/C#/Delphi 等）能方便地使用 HPSocket
   
3. HPSocket4C.dll 使用方法

   方法一：
   ------------------------------------------------------------------------------
   (0) （C/C++ 程序）包含 HPSocket4C.h 頭文件
   (1) 調用 ::Create_HP_XxxListener() 函數創建監聽器對象
   (2) 調用 ::Create_HP_Xxx(pListener) 函數創建 HPSocket 對象
   (3) 調用 ::HP_Set_FN_Xxx_OnYyy(pListener, ...) 函數設置監聽器的回調函數
   (4) 調用相關導出函數操作 HPSocket 對象
   (5) ...... ......
   (6) 調用 ::Destroy_HP_Xxx(pSocket) 函數銷毀 HPSocket 對象
   (7) 調用 ::Destroy_HP_XxxListener(pListener) 函數銷毀監聽器對象
   
   方法二：
   ------------------------------------------------------------------------------
   (1) 應用程序把需要用到的導出函數封裝到特定語言的包裝類中
   (2) 通過包裝類封裝后，以面向對象的方式使用 HPSocket

4. 動態鏈接庫發行版本

   (1) x86/HPSocket4C.dll     - (32位/MBCS/Release)
   (2) x86/HPSocket4C_D.dll    - (32位/MBCS/DeBug)
   (3) x86/HPSocket4C_U.dll    - (32位/UNICODE/Release)
   (4) x86/HPSocket4C_UD.dll   - (32位/UNICODE/DeBug)
   (5) x64/HPSocket4C.dll      - (64位/MBCS/Release)
   (6) x64/HPSocket4C_D.dll    - (64位/MBCS/DeBug)
   (7) x64/HPSocket4C_U.dll    - (64位/UNICODE/Release)
   (8) x64/HPSocket4C_UD.dll   - (64位/UNICODE/DeBug)

> 全面啟用 Buffer Pool 緩存機制：

1. Common/Src 增加代碼文件 bufferpool.h 和 bufferpool.cpp，實現 Buffer Pool 緩存機制
2. 通過 Buffer Pool 緩存機制提升內存使用效率，減少動態內存分配和釋放操作，避免內存空洞
3. ICTcpClient 用 CItemPool 和 TItemList 實現發送緩沖區
4. CUdpClient 用 CItemPool 和 TItemList 實現發送緩沖區
5. CTcpPullClient 用 CItemPool 和 TItemList 實現發送緩沖區和 PULL 緩沖區
6. CTcpPullServer 用 CBufferPool 和 TBuffer 實現 PULL 緩沖區

*** v3.0.2 更新 ***

 > 把 HP-Socket 編譯為動態鏈接庫：

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

1. 應用程序可以通過導入源代碼或動態鏈接庫方式使用 HP-Socket
2. 動態鏈接庫使用方法

   方法一：
   ------------------------------------------------------------------------------
   (0) 應用程序包含 SocketInterface.h 和 HPSocket.h 頭文件
   (1) 調用 HP_Create_Xxx() 函數創建 HPSocket 對象
   (2) 使用完畢后調用 HP_Destroy_Xxx() 函數銷毀 HPSocket 對象
   
   方法二：
   ------------------------------------------------------------------------------
   (0) 應用程序包含 SocketInterface.h 和 HPSocket.h 頭文件
   (1) 創建 CXxxWrapper 包裝器，通過包裝器智能指針使用 HPSocket 對象

3. 動態鏈接庫發行版本

   (1) x86/HPSocket.dll      - (32位/MBCS/Release)
   (2) x86/HPSocket_D.dll    - (32位/MBCS/DeBug)
   (3) x86/HPSocket_U.dll    - (32位/UNICODE/Release)
   (4) x86/HPSocket_UD.dll   - (32位/UNICODE/DeBug)
   (5) x64/HPSocket.dll      - (64位/MBCS/Release)
   (6) x64/HPSocket_D.dll    - (64位/MBCS/DeBug)
   (7) x64/HPSocket_U.dll    - (64位/UNICODE/Release)
   (8) x64/HPSocket_UD.dll   - (64位/UNICODE/DeBug)

*** v3.0.1 更新 ***

 > 新增 UDP 通信組件：

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

1. 新增兩個 UDP 通信組件：CUdpServer 為服務端組件，CUdpClient 為客戶端組件
2. 服務端組件 CUdpServer 采用 IOCP 通信模型
3. 客戶端組件 CUdpClient 采用 Event Select 通信模型
4. UDP 通信組件的接口與原 TCP 通信組件一致，簡單實用
5. UDP 通信組件內置通信線路自動監測機制
6. 新增 UDP 通信組件示例工程 TestEcho-UDP

> 代碼重構與優化：

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

1. 規范所有接口、類以及代碼文件的命名
2. 重構和優化了大量組件代碼
3. 服務端組件加入讀寫鎖機制，有效平衡處理性能與安全性
4. 服務端組件的 Socket 對象緩存列表設置了鎖定時間，提高訪問的安全性