高性能 Socket 组件 HP-Socket v3.2.1-RC5 公布

> 升级说明：

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) client连接server时，假设server IP 地址满位（12个数字：‘AAA.BBB.CCC.DDD’），IP 地址解析错误
   2) 影响组件：全部 TCP/UDP client组件
   3) 影响版本号：v3.1.2 及之前全部版本号

    
2. 修复域名或主机名的 IP 地址解析错误 Bug
    

   1) client组件通过域名或主机名连接server时，可能会解析到错误的 IP 地址
   2) 影响组件：全部 TCP/UDP client组件
   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 为client组件
2. 服务端组件 CUdpServer 採用 IOCP 通信模型
3. client组件 CUdpClient 採用 Event Select 通信模型
4. UDP 通信组件的接口与原 TCP 通信组件一致，简单有用
5. UDP 通信组件内置通信线路自己主动监測机制
6. 新增 UDP 通信组件演示样例project TestEcho-UDP

> 代码重构与优化：

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

1. 规范全部接口、类以及代码文件的命名
2. 重构和优化了大量组件代码
3. 服务端组件添?读写锁机制，有效平衡处理性能与安全性
4. 服务端组件的 Socket 对象缓存列表设置了锁定时间，提高訪问的安全性