代码拉取完成，页面将自动刷新
同步操作将从 伤神小怪兽/HP-Socket 强制同步，此操作会覆盖自 Fork 仓库以来所做的任何修改，且无法恢复！！！
确定后同步将在后台操作，完成时将刷新页面，请耐心等待。
==========================================================================================
v4.1.3 更新：
==========================================================================================
> 代码调整：
-----------------
1、修正 ITcpServer 和 ITcpAgent 组件的 Onclose 事件在 SP_DIRECT 发送模式下的触发规则
2、IClient 组件优化，提高稳定性
> 升级说明：
-----------------
1、HP-Socket v4.1.3 完全兼容 HP-Socket v4.1.2 版本，可以直接替换升级
==========================================================================================
v4.1.2 更新：
==========================================================================================
> 代码调整：
-----------------
1、采用新环形缓冲区算法提高异步操作安全性
2、采用延时释放策略提高 HTTP 异步操作安全性
> 升级说明：
-----------------
1、HP-Socket v4.1.2 完全兼容 HP-Socket v4.1.1 版本，可以直接替换升级
==========================================================================================
v4.1.1 更新：
==========================================================================================
> WebSocket 支持：
-----------------
1、所有 HTTP 组件增加 WebSocket 方法：
1) SendWSMessage(): 发送 WebSocket 数据包
2） GetWSMessageState(): 获取当前 WebSocket 状态
2、所有 HTTP 组件监听器增加 WebSocket 事件：
1) OnWSMessageHeader(): WebSocket 数据包头通知
2) OnWSMessageBody(): WebSocket 数据包体通知
3) OnWSMessageComplete(): WebSocket 数据包完成通知
3、示例 Demo TestEcho-Http 和 TestEcho-Http-4C 支持 WebSocket
> 增加 HTTP Sync Client 通信组件：
-----------------
1、HTTP Sync Client 实现同步 HTTP 通信，不需要事件监听器
2、HTTP Sync Client 组件类： CHttpSyncClient、CHttpsSyncClient
3、HTTP Sync Client 实现接口： ITcpClient / IHttpSyncRequester
4、示例 Demo TestEcho-Http 和 TestEcho-Http-4C 提供 HTTP Sync Client 示例
> 升级说明：
-----------------
1、HP-Socket v4.1.1 完全兼容 HP-Socket v4.0.1 版本，可以直接替换升级
==========================================================================================
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) 监听器接口： IHttpClientListener
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 示例代码
> 升级说明：
-----------------
1、HP-Socket v4.0.1 与 HP-Socket v3.5.4 接口不兼容
2、IServer、IAgent 和 IClient 的所有监听器回调方法参数都有变化
3、注意：HPSocket4C 用新方法创建和销毁 PACK 组件监听器
4、注意：IServer 和 IAgent 应用程序需要根据实际使用场景设置最大连接数
==========================================================================================
v3.5.4 更新：
==========================================================================================
> Bug 修复：
-----------------
1、修复 IClient 组件在连接发送数据时连接被断开可能导致程序崩溃 Bug
2、优化 vc-common-src 公共代码包的 CCASQueue
> 升级说明：
-----------------
1、HP-Socket v3.5.4 完全兼容 HP-Socket v3.5.3 版本，可以直接替换升级
==========================================================================================
v3.5.3 更新：
==========================================================================================
> Bug 修复：
-----------------
1、修复 IClient 组件在极端情况下触发两次 OnClose() 事件 Bug
2、修复 IClient 组件在极端情况下销毁 IClient 对象导致程序崩溃 Bug
> 升级说明：
-----------------
1、HP-Socket v3.5.3 完全兼容 HP-Socket v3.5.2 版本，可以直接替换升级
==========================================================================================
v3.5.2 更新：
==========================================================================================
> 组件接口调整：
-----------------
1、IClient 组件 Start() 方法默认连接方式改为异步连接
2、IClient 组件 Start() 方法增加可选参数 lpszBindAddress，设置绑定地址
3、HP-Socket 4C 增加导出方法 HP_Client_StartWithBindAddress() 方法，可设置绑定地址
4、IUdpCast 组件删除接口方法 Get/SetBindAddress()
5、IServer 接口 增加 GetLocalAddress() 方法用于获取连接的本地地址信息
6、增加全局函数 SYS_GetSocketLocalAddress() 和 SYS_GetSocketRemoteAddress() 分别用于获取 SOCKET 本地和远程地址信息
> 升级说明：
-----------------
1、HP-Socket v3.5.2 完全兼容 HP-Socket v3.5.1 版本，可以直接替换升级
==========================================================================================
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、静态库目标文件不包含在发布包中（因为太大），如果需要请自行编译
> 升级说明：
-----------------
1、HP-Socket v3.5.1 的非 SSL 版本不能二进制兼容 HP-Socket v3.4.x 版本，升级需重新编译应用程序
2、TCP 组件接口增加了 OnHandShake() 事件，使用 C++ 接口的应用程序需要处理该事件，对于非 SSL 组件则可提供一个空实现
==========================================================================================
v3.4.3 更新：
==========================================================================================
> Bug 修复：
-----------------
1、修复 vc-common-src 公共代码包的 CCASQueue 可能导致无限循环 Bug
> 升级说明：
-----------------
1、HP-Socket v3.4.3 完全兼容 HP-Socket v3.4.2 版本，可以直接替换升级
==========================================================================================
v3.4.2 更新：
==========================================================================================
> Bug 修复：
-----------------
1、修复 TcpPackServer 和 TcpPackAgent 某些属性设置不生效 Bug
> 升级说明：
-----------------
1、HP-Socket v3.4.2 完全兼容 HP-Socket v3.4.1 版本，可以直接替换升级
==========================================================================================
v3.4.1 更新：
==========================================================================================
> 增加 Tcp Pack 系列通信组件：
-----------------
1、Tcp Pack 系列组件保证每个 OnReceive 事件都向应用程序提供一个完整数据包
2、Tcp Pack 系列组件是 PUSH/PULL 模式的结合体，应用程序不必处理分包（如：PUSH）与数据抓取（如：PULL）
3、Tcp Pack 系列组件提供 Get/SetMaxPackSize() 和 Get/SetPackHeaderFlag() 方法，用来设置最大包长和包头标识
2、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()
> 升级说明：
-----------------
1、HP-Socket v3.3.2 及之前版本升级到 HP-Socket v3.4.1 版本，需要修改 OnClose/OnError 事件的处理代码
==========================================================================================
v3.3.2 更新：
==========================================================================================
> 代码调整：
-----------------
1、增强编译兼容性
2、修复 C#、E 语言 SDK 的已知 Bug
> 升级说明：
-----------------
1、HP-Socket v3.3.2 完全兼容 HP-Socket v3.3.1 版本，可以直接替换升级
==========================================================================================
v3.3.1 更新：
==========================================================================================
> 组件接口调整：
-----------------
1、IClientListener 监听器接口用 IClient* 参数取代 CONNID 参数标识 Client 组件对象
2、增加 IPullClient 接口，用作 PULL Client 组件的基接口
3、IPullSocket 和 IPullClient 接口增加 Peek() 方法用于窥探缓冲区数据（不会移除缓冲区数据）
4、增加 IComplexSocketListener 监听器接口，用作 Server/Agent 组件的监听器基接口
5、IComplexSocketListener 提供 OnShutdown 通知方法取代 Server/Agent 组件原来的 OnServerShutdown/OnAgentShutdown
6、IClient 组件增加 Get/SetExtra() 方法用于保存自定义附加数据
7、IServer 和 IAgent 组件增加“静默连接处理”相关方法：
1) DisconnectSilenceConnections()：断开超过指定时长的静默连接
2) GetSilencePeriod()：获取某个连接静默时间（毫秒）
3) SetMarkSilence()：设置是否标记静默时间（设置为 TRUE 时 DisconnectSilenceConnections() 和 GetSilencePeriod() 才有效，默认：FALSE）
4) IsMarkSilence()：检测是否标记静默时间
> 增加 UdpCast 通信组件：
-----------------
1、UdpClient / UdpServer 用于 C/S 模式的点对点单播通信，但在某些应用场景下，需要用到组播或广播通信
2、UdpCast 实现了组播或广播通信，UdpCast 提供 IUdpCast 接口，该接口继承自 IClient，有以下接口方法：
1) 通知接口方法：
OnPrepareConnect(IClient* pClient, SOCKET socket)
OnConnect(IClient* pClient)
OnSend(IClient* pClient, const BYTE* pData, int iLength)
OnReceive(IClient* pClient, const BYTE* pData, int iLength)
OnClose(IClient* pClient)
OnError(IClient* pClient, EnSocketOperation enOperation, int iErrorCode)
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, int iOffset = 0)
SendPackets(const WSABUF pBuffers[], int iCount)
3、增加 UdpCast 使用示例：TestUDPCast
> 升级说明：
-----------------
1、HP-Socket v3.3.1 在功能上兼容 HP-Socket v3.2.3 版本，但代码级别不完全兼容
2、HP-Socket v3.2.3 升级到 HP-Socket v3.3.1 需要注意以下调整：
1) Client 组件
a) IClientListener 监听器接口调整，所有通知方法的参数有调整
b) PULL Client 用 IPullClient 作为基接口，Fetch()/Peek()方法参数有调整
2) Agent/Server 组件
a) OnShutdown 取代 OnServerShutdown/OnAgentShutdown
==========================================================================================
v3.2.3 更新：
==========================================================================================
> common-src 优化：
-----------------
1、优化通信组件的同步机制
2、整体性能提升约 10%
> 升级说明：
-----------------
1、使用 HP-Socket v3.2.2 及以前版本的应用程序可以安全升级到 HP-Socket v3.2.3
==========================================================================================
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(dwConnID, 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, int iOffset = 0)
Disconnect(CONNID dwConnID, BOOL bForce = TRUE)
Fetch(CONNID dwConnID, BYTE* pData, int iLength) //（Pull 模型）
5、增加 TcpAgent / TcpPullAgent 使用示例：
1) Agent-PFM
2) Agent-Pull
3) 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、增加示例工程 TestEcho-4J，展示 HPSocket4J 的使用方法（包括 PULL 模型示例和性能测试示例）
4、MBCS 和 Unicode 版本分布位于包 org.jessma.hpsocket.mbcs 和 org.jessma.hpsocket.unicode
5、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 模型
6、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);
> 优化数据发送/接收策略：
-----------------
1、Server 和 Agent 组件提供以下三种数据发送策略：
1）PACK - 打包模式（默认） ：尽量把多个发送操作的数据组合在一起发送，增加传输效率
2）SAFE - 安全模式 ：尽量把多个发送操作的数据组合在一起发送，并控制传输速度，避免缓冲区溢出
3）DIRECT - 直接模式 ：对每一个发送操作都直接投递，适用于负载不高但要求实时性较高的场合
2、Server 和 Agent 组件提供以下两种数据接收策略：
1）SERIAL - 串行模式（默认）：顺序触发同一连接的 OnReceive 和 OnClose/OnError 事件
2）PARALLEL - 并行模式 ：在不同的通信线程中同时触发同一连接的 OnReceive 和 OnClose/OnError 事件
> 其它更新：
-----------------
1、IServer 的 GetClientAddress() 方法改名为 GetRemoteAddress()
2、IClient 的 Send() 方法删除 “CONNID dwConnID” 参数
3、IClient/IServer/IAgent 的 Send() 方法增加发送数据缓冲区指针偏移量参数 “int iOffset”
4、增加 EnSendPolicy 枚举类型，IServer/IAgent 增加发送模式设置方法 SetSendPolicy()
5、增加 EnRecvPolicy 枚举类型，IServer/IAgent 增加接收模式设置方法 SetRecvPolicy()
6、IServer/IAgent 增加方法：BOOL GetAllConnectionIDs()，获取所有连接的 CONNID
7、IUdpServer 增加方法：SetPostReceiveCount()，设置 Receive 预投递数量
8、EnServerError / EnClientError 枚举类型合并为 EnSocketError
9、EnSocketError / EnHandleResult / EnFetchResult 枚举类型从原所在类中移到外部
10、IClient/IServer/IAgent 增加方法：BOOL GetPendingDataLength()，获取连接中未发出数据的长度
11、HPSocket4C.dll 增加方法 SendPart()，支持指定缓冲区指针偏移量
12、增加 HPSocket for C# SDK（由 int 2e 提供）
13、增加 HPSocket 易语言支持库（由 Yecate 提供）
14、公共代码包 vc-common-src 更新为 v2.3.5（参考：vc-common-src v2.3.5 的 Change Log）
> 升级说明：
-----------------
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’）则被错误地判断为域名
2) 影响组件：所有 TCP/UDP 客户端组件
3) 影响版本：v3.1.2 及之前所有版本
2、修复域名或主机名的 IP 地址解析错误 Bug：
1) 客户端组件通过域名或主机名连接服务器时，可能会解析到错误的 IP 地址
2) 影响组件：所有 TCP/UDP 客户端组件
3) 影响版本：v3.1.2 及之前所有版本
> 升级说明：
-----------------
1、使用 HP-Socket v3.1.2 及以前版本的应用程序可以安全升级到 HP-Socket v3.1.3
==========================================================================================
v3.1.2 更新：
==========================================================================================
> 修改 Server 组件的 OnClose() / OnError() 事件的触发规则：
-----------------
1、以前版本的 TCP/UDP Server 组件中，当关闭一个连接时可能会同时触发一个 OnClose() 事件和若干个 OnError() 事件
2. 由于存在上述可能性，所以应用程序需要对 OnClose() / OnError() 的处理事件代码段进行同步
3、从 v3.1.2 开始，当多个 OnClose() / OnError() 事件同时发生时，组件只会向应用程序通知第一个事件，后续事件则忽略
4. 因此，应用程序在处理 OnClose() / OnError() 事件时不必处理同步，减少了出错的可能和编写同步及检测代码的负担
示例代码一：
--------------------------------------------------------------------------------------
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;
}
> 其它更新：
-----------------
1、调整 TCP Server 默认参数：
1) DEFAULT_SOCKET_LISTEN_QUEUE : 300
2) DEFAULT_ACCEPT_SOCKET_COUNT : 300
3) DEFAULT_FREE_SOCKETOBJ_POOL : 150
4) DEFAULT_FREE_SOCKETOBJ_HOLD : 450
5) DEFAULT_FREE_BUFFEROBJ_POOL : 300
6) DEFAULT_FREE_BUFFEROBJ_HOLD : 900
2、调整 UDP Server 默认参数：
1) DEFAULT_FREE_SOCKETOBJ_POOL : 150
2) DEFAULT_FREE_SOCKETOBJ_HOLD : 450
3) DEFAULT_FREE_BUFFEROBJ_POOL : 300
4) DEFAULT_FREE_BUFFEROBJ_HOLD : 900
> 升级说明：
-----------------
1、使用 HP-Socket v3.1.1 及以前版本的应用程序可以安全升级到 HP-Socket v3.1.2
==========================================================================================
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、HPSocket4C.dll 动态链接库发行版本
(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、CTcpClient 用 CItemPool 和 TItemList 实现发送缓冲区
4、CUdpClient 用 CItemPool 和 TItemList 实现发送缓冲区
5、CTcpPullClient 用 CItemPool 和 TItemList 实现发送缓冲区和 PULL 缓冲区
6、CTcpPullServer 用 CBufferPool 和 TBuffer 实现 PULL 缓冲区
> 其它更新：
-----------------
1、IServer 增加接口方法 DisconnectLongConnections() 用于断开所有超长连接
2、IServer 删除接口方法 GetConnectionCriSec()
3、IClient 增加方法 Get/SetFreeBufferPoolSize()、Get/SetFreeBufferPoolHold() 用于设置 Buffer Pool 缓存大小和阀值
4、IPullServer 删除方法 Get/SetFreePullBufferPool()、Get/SetFreePullBufferHold()
5、HPSocket.dll 和 HPSocket4C.dll 使用 /MT(d) 选项重新编译，消除对运行时库的依赖
6、增加示例工程 TestEcho-4C，展示 HPSocket4C.dll 的使用方法
> 升级说明：
-----------------
1、使用 HP-Socket v3.0.2 及以前版本的应用程序可以安全升级到 HP-Socket v3.1.1
2、如果工程想通过导入 HPSocket4C.dll 的方式使用 HP-Socket，请参考 TestEcho-4C 示例工程
==========================================================================================
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)
> 其它更新：
-----------------
1、把组件接口以及监听器接口的声明移到 SocketInterface.h
2、IServer 增加接口方法 GetConnectionCount()/GetConnectPeriod() 分别获取当前连接数和某个连接的时长
3、IServer 接口方法 GetListenAddress()/GetClientAddress() 的 CString& 参数改为 LPTSTR
4、IClient 接口方法 GetLocalAddress() 的 CString& 参数改为 LPTSTR
5、SocketHelper.h 中所有全局函数的 CString& 参数均改为 LPTSTR
6、示例工程 TestEcho-Pull 和 TestEcho-PFM 改为用动态链接库方式使用 HP-Socket
> 升级说明：
-----------------
1、使用 HP-Socket v3.0.1 的应用程序可以安全升级到 HP-Socket v3.0.2
2、由于某些接口方法的参数作了调整，因此请参考测试工程作相应修改
3、如果工程想通过动态链接库方式使用 HP-Socket，请参考 TestEcho-Pull 或 TestEcho-PFM 示例工程
==========================================================================================
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 对象缓存列表设置了锁定时间，提高访问的安全性
> 升级说明：
-----------------
1、使用 HP-Socket v2.2.3 的应用程序可以安全升级到 HP-Socket v3.0.1
2、由于重命名了大量接口、类以及代码文件，因此升级时需要作相应调整
==========================================================================================
v2.2.3 更新：
==========================================================================================
> 连接 ID 的数据类型改为‘CONNID’：
-----------------
1、在SocketHelper.h 中定义 CONNID 数据类型（默认：typedef ULONG_PTR CONNID）
2、应用程序可以把 CONNID 定义为其希望的类型（如：ULONG / ULONGLONG 等）
3、为了便于移植与维护，应用程序的任何地方都应该用‘CONNID’类型引用连接 ID
> 服务端 Socket 组件支持为每个连接绑定附加数据：
-----------------
1、IServerSocket 和 CIocpServer 增加方法 Get/SetConnectionExtra()
2、通过上述两个方法，应用程序可以为每个连接绑定任意附加数据并把数据获取出来
> 其它更新：
-----------------
1、放宽 CIocpServer 的最大 IOCP 工作线程数目限制（64 改为 500）
2、服务端 Socket 组件的 Disconnect() 方法增加一个标识参数‘bForce’，指示是否强制断开连接
3、调整连接 ID 的生成规则，避免生成数值为 0 的连接 ID
==========================================================================================
v2.2.2 更新：
==========================================================================================
> 优化心跳检测相关功能：
-----------------
1、IServerSocket 和 IClientSocket 的 Get/SetKeepAliveTimes() 方法改为 Get/SetKeepAliveTime()
2、CIocpServer 和 CClientSocket 的默认 KeepAliveTime 属性改为 5000
3、CIocpServer 和 CClientSocket 的默认 KeepAliveInterval 属性改为 3000
==========================================================================================
v2.2.1 更新：
==========================================================================================
> PULL 模型支持：
-----------------
1、ISocketListener 增加 PULL 模型数据接收通知方法 OnReceive(dwConnID, int)
2、增加 PULL Socket 接口 IPullSocket，该接口的 Fetch(dwConnID, pBuffer, iLength) 方法用于抓取通信数据
> Server：
-----------------
1、服务端 Socket 接口 ISocketServer 改名为 IServerSocket
2、增加 PULL Server Socket 监听器抽象类 CPullServerSocketListener
3、增加 PULL Server Socket 接口 IPullServerSocket
4、增加 PULL Server Socket 实现类 CIocpPullServer
> Client：
-----------------
1、客户端 Socket 接口 ISocketClient 改名为 IClientSocket
2、客户端 Socket 实现类 CSocketClient 改名为 CClientSocket
3、增加 PULL Client Socket 监听器抽象类 CPullClientSocketListener
4、增加 PULL Client Socket 接口 IPullClientSocket
5、增加 PULL Client Socket 实现类 CPullClientSocket
> 其他更新：
-----------------
1、增加 PULL Socket 测试程序 TestEcho-Pull
2、在 SocketHelper.h (.cpp) 中添加若干帮助结构体
> 升级说明：
-----------------
1、使用 HP-Socket v2.1.1 的应用程序可以安全升级到 v2.2.1
2、由于 ISocketServer、ISocketClient 和 CSocketClient 的名称已修改，因此，应用程序需要对引用的名称和包含的头文件名作相应修改
==========================================================================================
v2.1.1 更新：
==========================================================================================
> Server：
-----------------
1、IServerSocketListener 取消 OnPrepareSocket(connID, socket) 通知方法
2、IServerSocketListener 修改 OnAccept((connID, soClient) 通知方法，增加参数‘soClient’，用于实现原 OnPrepareSocket(connID, socket) 通知方法的功能
3、IServerSocketListener 增加 OnPrepareListen(soListen) 通知方法，用于设置监听 socket 的 SOCKET 选项
4、ISocketServer 增加方法 GetListenAddress(strAddress, usPort)，用于获取监听 Socket 的地址信息
5、ISocketServer 增加方法 GetClientAddress(connID, strAddress, usPort)，用于某个客户端连接的地址信息
6、优化 Socket 缓存池和内存块缓存池管理
7、调整一些属性访问方法的方法名
8、修复BUG：特殊情形下可能出现死锁现象
> Client：
-----------------
1、ISocketServer 增加方法 GetLocalAddress(strAddress, usPort)，用于获取 Client Socket 的地址信息
2、优化数据发送方式，提升数据发送效率
> 其他更新：
-----------------
1、优化 TestEcho 和 TestEcho-PFM 测试程序
3、在 SocketHelper.h (.cpp) 中添加若干帮助函数
4、为 SocketHelper.h 中定义的所有接口、类和方法加入注释
==========================================================================================
v2.0.1 更新：
==========================================================================================
> Server：
-----------------
1、IServerSocketListener 增加 OnPrepareSocket(connID, socket) 通知方法用于在使用 socket 前设置 SOCKET 选项或过滤客户端连接
2、ISocketServer 增加方法 Disconnect(connID) 用于主动断开客户端连接
3、增加 IServerSocketListener 的子类 CServerSocketListener，提供默认（空的）通知处理方法
> Client：
-----------------
1、IClientSocketListener 增加 OnPrepareSocket(connID, socket) 通知方法用于在使用 socket 前设置 SOCKET 选项
2、支持异步 Connect：ISocketServer 的 Start() 方法增加一个参数 （BOOL bAsyncConnect） 设置是否采用异步 Connect
3、增加 IClientSocketListener 的子类 CClientSocketListener，提供默认（空的）通知处理方法。
4、修复BUG：超高负载情形下出现丢包现象
> 其他更新：
-----------------
1、支持 Windows x64 平台
2、优化 TestEcho 和 TestEcho-PFM 测试程序
3、TestEcho 客户端程序加入“异步连接”示例
4、TestEcho 服务端程序加入“连接过滤”和“主动断开连接”示例
此处可能存在不合适展示的内容，页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容，可点击提交进行申诉，我们将尽快为您处理。
马建仓 AI 助手
