========================================================================================== v5.9.1 更新： ========================================================================================== > 主要更新： ----------------- 1、更新流式压缩/解压相关的若干 API，支持分段压缩/解压（参考：Change-APIs.txt） 2、更新 SSL 模块，支持 OpenSSL 3.0 > 第三方库更新： ----------------- 1、llhttp 升级到 8.1.0 版本 2、zlib 升级到 1.2.13 版本 3、openssl 升级到 1.1.1s 版本 4、mimalloc 升级到 1.7.9 版本 5、jemalloc 升级到 5.3.0 版本 > 升级说明： ----------------- 1、除了流式压缩/解压相关的若干 API 外，HP-Socket v5.9.1 兼容 HP-Socket v5.8.8 版本，如果没有用到流式压缩/解压 API 可以直接替换升级 ========================================================================================== v5.8.8 更新： ========================================================================================== > 主要更新： ----------------- 1、Client/Agent 连接服务端时支持指定主机名称，格式：[^]，其中 ^ 可选。应用场景之一：通过代理服务器向目标服务器传递 SSL SNI hostname 2、增加字符编码转换系列函数（参考：Change-APIs.txt），支持指定源字符串长度 3、修复 SSL Pull/Pack Server/Agent 组件在手工启动SSL（SetSSLAutoStart(FALSE)）场景下的异常问题 > 第三方库更新： ----------------- 1、zlib 升级到 1.2.12 版本 2、openssl 升级到 1.1.1n 版本 > 升级说明： ----------------- 1、HP-Socket v5.8.8 完全兼容 HP-Socket v5.8.7 版本，可以直接替换升级 ========================================================================================== v5.8.7 更新： ========================================================================================== > 主要更新： ----------------- 1、优化垃圾对象回收检测机制，提高通信组件在高负载、高并发场景的健壮性 2、支持 VS 2022 开发环境 > 第三方库更新： ----------------- 1、mimalloc 升级到 1.7.5 版本 > 升级说明： ----------------- 1、HP-Socket v5.8.7 完全兼容 HP-Socket v5.8.6 版本，可以直接替换升级 ========================================================================================== v5.8.6 更新： ========================================================================================== > 主要更新： ----------------- 1、增加 ZLib/GZip、Brotil 流式压缩/解压组件：IHPCompressor 和 IHPDecompressor 2、优化垃圾对象回收检测机制，提高通信组件在高负载、高并发场景的健壮性 > 第三方库更新： ----------------- 1、openssl 升级到 1.1.1m 版本 2、llhttp 升级到 6.0.6 版本 3、mimalloc 升级到 1.7.3 版本 > 升级说明： ----------------- 1、HP-Socket v5.8.6 完全兼容 HP-Socket v5.8.5 版本，可以直接替换升级 ========================================================================================== v5.8.5 更新： ========================================================================================== > 主要更新： ----------------- 1、增加线程池监听器接口 IHPThreadPoolListener，监听线程池生命周期事件 2、消除隐患：Client 系列组件用作函数局部变量时，如果使用不当可能会在销毁 Client 对象时崩溃 3、支持通过指定平台工具集编译 4、增加 MSBuild 一键编译脚本 5、代码优化，提高代码健壮性 > 第三方库更新： ----------------- 1、openssl 升级到 1.1.1l 版本 2、llhttp 升级到 6.0.5 版本 > 升级说明： ----------------- 1、HP-Socket v5.8.5 完全兼容 HP-Socket v5.8.4 版本，可以直接替换升级 ========================================================================================== v5.8.4 更新： ========================================================================================== > 主要更新： ----------------- 1、增加全局函数：SYS_Calloc()、SYS_Alloca() 2、TCP 系列组件增加接口方法：SetNoDelay()、IsNoDelay() > 第三方库更新： ----------------- 1、mimalloc 升级到 1.7.2 版本 2、llhttp 升级到 6.0.4 版本 > 升级说明： ----------------- 1、HP-Socket v5.8.4 完全兼容 HP-Socket v5.8.3 版本，可以直接替换升级 ========================================================================================== v5.8.3 更新： ========================================================================================== > 主要更新： ----------------- 1、Bug 修复：ARQ UDP 组件发送数据时可能发生死锁 > 第三方库更新： ----------------- 1、mimalloc 升级到 1.7.1 版本 2、llhttp 升级到 6.0.2 版本 3、OpenSSL 升级到 1.1.1k 版本 > 升级说明： ----------------- 1、HP-Socket v5.8.3 完全兼容 HP-Socket v5.8.2 版本，可以直接替换升级 ========================================================================================== v5.8.2 更新： ========================================================================================== > 第三方库更新： ----------------- 1、mimalloc 升级到 1.7.0 版本 2、llhttp 升级到 4.0.0 版本 3、OpenSSL 升级到 1.1.1j 版本 > 升级说明： ----------------- 1、HP-Socket v5.8.2 完全兼容 HP-Socket v5.8.1 版本，可以直接替换升级 ========================================================================================== v5.8.1 更新： ========================================================================================== > 第三方库更新： ----------------- 1、HTTP 解析器：llhttp 取代 http_parser 2、内存分配器：mimalloc 取代 jemalloc 3、OpenSSL 升级到 1.1.1i 版本 > 其他更新： ----------------- 1、库公开头文件移到 include/hpsocket 目录 2、Windows目录结构调整：Common/Src 改为 Src/Common，Common/Lib 改为 Dependent > 升级说明： ----------------- 1、HP-Socket v5.8.1 完全兼容 HP-Socket v5.7.3 版本，可以直接替换升级 ========================================================================================== v5.7.3 更新： ========================================================================================== > 常规更新： ----------------- 1、增加 Brotli 压缩/解压支持，（提供 _BROTLI_DISABLED 预编译宏用于关闭 Brotli 库功能） 2、OpenSSL 升级到 1.1.1h 版本 > 升级说明： ----------------- 1、HP-Socket v5.7.3 完全兼容 HP-Socket v5.7.2 版本，可以直接替换升级 ========================================================================================== v5.7.2 更新： ========================================================================================== > 常规更新： ----------------- 1、代码优化，提高稳定性 2、OpenSSL 升级到 1.1.1g 版本 3、http-parser 升级到 2.9.4 版本 4、kcp 升级到 1.6 版本 > 升级说明： ----------------- 1、HP-Socket v5.7.2 完全兼容 HP-Socket v5.7.1 版本，可以直接替换升级 ========================================================================================== v5.7.1 更新： ========================================================================================== > UDP 组件更新： ----------------- 1、增加新组件：UDP Node 1) UDP Node 没有“连接”的概念，可以与任意地址相互收发数据 2) UDP Node 支持三种运行模式：单播、组播和广播 3) 增加 UDP Node 组件示例 Demo ‘TestUDPNode’ > 其它更新： ----------------- 1、所有组件增加 Wait() 方法，用于等待组件关闭 2、所有通信组件增加 SetReuseAddressPolicy() 方法，支持设置地址重用策略 3、所有 SSL 通信组件增加 SetSSLCipherList() 方法，支持设置 SSL 加密套件 4、大量 API 更新，代码重构、优化 > 升级说明： ----------------- 1、HP-Socket v5.7.1 改动或删除了一些旧版本的 API，升级时请参考 Chang-APIs.txt ========================================================================================== v5.6.4 更新： ========================================================================================== > 常规更新： ----------------- 1、代码优化，提高稳定性 > 升级说明： ----------------- 1、HP-Socket v5.6.4 完全兼容 HP-Socket v5.6.3 版本，可以直接替换升级 ========================================================================================== v5.6.3 更新： ========================================================================================== > 常规更新： ----------------- 1、代码优化，提高稳定性 > 升级说明： ----------------- 1、HP-Socket v5.6.3 完全兼容 HP-Socket v5.6.2 版本，可以直接替换升级 ========================================================================================== v5.6.2 更新： ========================================================================================== > 常规更新： ----------------- 1、代码优化，提高稳定性 2、修复 v5.6.1 版本中 SSL 组件对 Windows XP 系统不兼容的问题 > 升级说明： ----------------- 1、HP-Socket v5.6.2 完全兼容 HP-Socket v5.6.1 版本，可以直接替换升级 ========================================================================================== v5.6.1 更新： ========================================================================================== > SSL 组件更新： ----------------- 1、所有 SSL 组件增加以下接口方法支持加载内存证书 1) Server：SetupSSLContextByMemory(), AddSSLContextByMemory() 2) Agent：SetupSSLContextByMemory() 3) Client：SetupSSLContextByMemory() 2、所有 SSL 组件增加 GetSSLSessionInfo() 方法，用来获取 SSL 会话相关信息 3、SSL Server 组件提供默认的 SNI 服务器域名绑定机制，大多数情形下应用程序不必自定义 SNI 回调函数 1) 当 SetupSSLContext() 的 'fnServerNameCallback' 参数值为 nullptr 则启用默认的服务器域名绑定机制 2) BindSSLServerName()：绑定服务器域名到指定证书 3) HP_SSL_DefaultServerNameCallback()：默认 SNI 回调函数 > HTTP 组件更新： ----------------- 1、HTTP Server 组件的 SendWSMessage() 方法删除 lpszMask 参数 2、所有 HTTP 组件的 SendWSMessage() 方法的 pData 参数类型改为 const BYTE*，因此可以传入常量 3、所有 HTTP 组件添加 SendChunkData() 方法以方便地发送 Chunked 数据 > UDP 组件更新： ----------------- 1、优化 Linux 平台的 UDP Cast 组件，使得其与 Windows 平台的 UDP Cast 组件保持行为一致 2、提升所有 UDP 组件的 IPv6 兼容性 3、UDP Client/Server 组件关闭时自动向对端发送“关闭通知”数据报 > 其他更新： ----------------- 1、jemalloc 升级到 5.2.1 版本 2、OpenSSL 升级到 1.1.1d 版本 3、代码优化，提高稳定性 > 升级说明： ----------------- 1、HP-Socket v5.6.1 基本兼容 HP-Socket v5.5.3 版本（HTTP 组件的 SendWSMessage() 方法除外） ========================================================================================== v5.5.3 更新： ========================================================================================== > 常规更新： ----------------- 1、代码优化，提高稳定性 2、OpenSSL 升级到 1.1.0k 版本 > 升级说明： ----------------- 1、HP-Socket v5.5.3 完全兼容 HP-Socket v5.5.2 版本，可以直接替换升级 ========================================================================================== v5.5.2 更新： ========================================================================================== > UDP 更新： ----------------- 1、放宽 UDP 组件的最大报文长度限制，SetMaxDatagramSize() 方法的最大值可以设置到 64KB 2、放宽 ARQ UDP 组件的最大传输单元长度限制，SetMaxTransUnit() 方法的最大值可以设置到 64KB > 其他更新： ----------------- 1、完善 Delphi SDK 及其示例 Demo > 升级说明： ----------------- 1、HP-Socket v5.5.2 完全兼容 HP-Socket v5.5.1 版本，可以直接替换升级 ========================================================================================== v5.5.1 更新： ========================================================================================== > UDP 更新： ----------------- 1、增加 ARQ UDP 组件：IUdpArqServer、IUdpArqClient 2、增加 ARQ UDP 示例 TestEcho-ARQ 和性能测试示例 TestEcho-ARQ-PFM 3、ARQ UDP 组件详细说明请参考开发文档 《HP-Socket Development Guide》 4、优化 IUdpServer 组件，修复潜在缺陷 5、C# SDK 增加 UDP 组件封装类 > 其他更新： ----------------- 1、jemalloc 升级到 5.2.0 版本 2、http-parser 升级到 2.9.2 版本 > 升级说明： ----------------- 1、HP-Socket v5.5.1 完全兼容 HP-Socket v5.4.4 版本，可以直接替换升级 ========================================================================================== v5.4.4 更新： ========================================================================================== > TCP 组件更新： ----------------- 1、IAgent 组件支持在连接服务器时指定本地IP地址和（或）本地端口 > 其他更新： ----------------- 1、代码优化 2、http-parser 升级到 2.9.0 版本 3、OpenSSL 升级到 1.1.0j 版本 4、提供 _UDP_DISABLED 预编译宏用于移除 UDP 组件 > 升级说明： ----------------- 1、HP-Socket v5.4.4 完全兼容 HP-Socket v5.4.3 版本，可以直接替换升级 ========================================================================================== v5.4.3 更新： ========================================================================================== > HTTP 组件更新： ----------------- 1、HTTP 组件可以手工启动 HTTP 通信，从而可以对 HTTP 通信执行 SOCKS 代理服务器设置等前置操作 2、HTTP 组件（Server/Agent/Client）增加以下接口方法支持手工启动 HTTP 通信 1) StartHttp()：手工启动 HTTP 通信，当通信组件设置为非自动启动时，需要调用本方法启动 HTTP 通信 2) SetHttpAutoStart()：设置 HTTP 通信启动方式（默认：TRUE，自动启动） 3) IsHttpAutoStart()：获取 HTTP 通信启动方式 > 其他更新： ----------------- 1、Bug 修复：UDP Server 在高并发场景下可能重复触发 OnAccept 事件 > 升级说明： ----------------- 1、HP-Socket v5.4.3 完全兼容 HP-Socket v5.4.2 版本，可以直接替换升级 ========================================================================================== v5.4.2 更新： ========================================================================================== > SSL 组件更新： ----------------- 1、SSL 组件可以手工启动 SSL 握手，从而可以对 SSL/Https 通信执行代理服务器设置等前置操作 2、SSL 组件（Server/Agent/Client）增加以下接口方法支持手工启动 SSL 握手 1) StartSSLHandShake()：手工启动 SSL 握手，当通信组件设置为非自动握手时，需要调用本方法启动 SSL 握手 2) SetSSLAutoHandShake()：设置通信组件握手方式（默认：TRUE，自动握手） 3) IsSSLAutoHandShake()：获取通信组件握手方式 > 其他更新： ----------------- 1、所有可能导致 Socket 关闭的组件接口方法都在 Socket 通信线程中异步触发 OnClose 事件 2、Server 与 Agent 组件的 DIRECT 发送策略也支持通过 GetPendingDataLength() 方法实现流控 3、Server 与 Agent 组件的 Disconnect() 方法不再支持‘非强制断开’（仍然保留bForce 参数），调用时都会强制断开 4、OnSend 事件支持 三种同步策略 1) OSSP_NONE：不同步（默认） 2) OSSP_CLOSE：同步 OnClose 3) OSSP_RECEIVE：同步 OnClose 和 OnReceive（只用于 TCP 组件） 5、OpenSSL 升级到 1.1.0i 版本 > 升级说明： ----------------- 1、HP-Socket v5.4.2 完全兼容 HP-Socket v5.4.1 版本，可以直接替换升级 ========================================================================================== v5.4.1 更新： ========================================================================================== > 加入线程池公共组件： ----------------- 1、加入 IHPThreadPool 线程池公共组件 2、IHPThreadPool 主要方法： 1) Start：启动线程池 2) Stop：关闭线程池 3) Submit：提交任务 4) AdjustThreadCount：调整线程池大小 > 接口更新： ----------------- 1、IAgent 接口的 Connect() 方法增加参数 usLocalPort，连接时可绑定本地端口 2、IClient 接口的 Start() 方法增加参数 usLocalPort，连接时可绑定本地端口 3、IClient/IAgent/IServer 接口增加方法 IsConnected()，检测是否有效连接 > 其他更新： ----------------- 1、修复已知问题 2、性能优化 > 升级说明： ----------------- 1、HP-Socket v5.4.1 完全兼容 HP-Socket v5.3.2 版本，可以直接替换升级 ========================================================================================== v5.3.2 更新： ========================================================================================== > 常规更新： ----------------- 1、更新版本号，保持与 Linux 版的版本号同步 > 升级说明： ----------------- 1、HP-Socket v5.3.2 完全兼容 HP-Socket v5.3.1 版本，可以直接替换升级 ========================================================================================== v5.3.1 更新： ========================================================================================== > 常规更新： ----------------- 1、修复 C# SDK 关于 SSL 初始化失败 Bug 2、http-parser 升级到 2.8.1 版本 3、OpenSSL 升级到 1.1.0h 版本 4、提供 _ZLIB_DISABLED 预编译宏用于关闭 zlib 库功能 > 升级说明： ----------------- 1、HP-Socket v5.3.1 完全兼容 HP-Socket v5.2.1 版本，可以直接替换升级 ========================================================================================== v5.2.1 更新： ========================================================================================== > 发布包调整： ----------------- 1、版本号修订：Windows 和 Linux 发行版使用统一版本号 2、发布文件不再区分非 SSL DLL 和 SSL DLL，统一为 HPSocket DLL 和 HPSocket4C DLL 3、发布文件默认包含 SSL 和 HTTP 组件 4、如果想移除 SSL 或 HTTP 组件，可以分别定义 _SSL_DISABLED 或 _HTTP_DISABLED 宏重新编译 > 其他更新： ----------------- 1、代码优化和已知 Bug 修复 > 升级说明： ----------------- 1、HP-Socket v5.2.1 完全兼容 HP-Socket v5.1.1 版本，可以直接替换升级 ========================================================================================== v5.1.1 更新： ========================================================================================== > 增加暂停接收功能： ----------------- 1、所有 Server/Agent/Client 组件增加‘暂停接收数据’功能（UDP Server 组件除外） 2、API 更新： 1） HP_Server_PauseReceive (增加) 2） HP_Server_IsPauseReceive (增加) 3） HP_Agent_PauseReceive (增加) 4） HP_Agent_IsPauseReceive (增加) 5） HP_Client_PauseReceive (增加) 6） HP_Client_IsPauseReceive (增加) > 其它更新： ----------------- 1、TCP Agent 增加方法 HP_Agent_ConnectWithExtra()，支持在连接完成前绑定附加数据 2、公共代码包 vc-common-src 版本升级到 v2.3.22 3、OpenSSL 升级到 1.1.0g > 升级说明： ----------------- 1、HP-Socket v5.1.1 完全兼容 HP-Socket v5.0.2 版本，可以直接替换升级 ========================================================================================== v5.0.2 更新： ========================================================================================== > Bug 修复： ----------------- 1、修复 PULL/PACK 组件偶尔可能会意外崩溃 Bug 2、受影响组件：Pull Server、Pull Agent、Pack Server、Pack Agent > 升级说明： ----------------- 1、HP-Socket v5.0.2 完全兼容 HP-Socket v5.0.1 版本，可以直接替换升级 ========================================================================================== v5.0.1 更新： ========================================================================================== > IPv6 支持： ----------------- 1、所有通信组件支持 IPv6 2、组件接口没有变化，组件内部通过传入的地址参数自动识别 IPv4 / IPv6 3、API 更新： 1） enum En_HP_IPAddrType (增加) 2） struct HP_TIPAddr (增加) 3） SYS_GetIPv4InAddr (删除) 4） SYS_GetOptimalIPByHostName (删除) 5） SYS_IsIPAddress (修改) 6） SYS_GetIPAddress (修改) 7） SYS_EnumHostIPAddresses (增加) 8） SYS_FreeHostIPAddresses (增加) > SSL 通信组件： ----------------- 1、多 SSL 证书支持，每个通信组件对象可以使用不同的 SSL 证书 2、通信组件对象绑定独立的 SSL Context，取代旧版本的全局唯一 SSL Context 3、API 更新： 1） HP_SSL_Initialize (删除) 2） HP_SSL_Cleanup (删除) 3） HP_SSL_IsValid (删除) 4） HP_SSLAgent_SetupSSLContext (增加) 5） HP_SSLClient_SetupSSLContext (增加) 6） HP_SSLServer_SetupSSLContext (增加) 7） HP_SSLServer_AddSSLContext (增加) 8） HP_SSLAgent_CleanupSSLContext (增加) 9） HP_SSLClient_CleanupSSLContext (增加) 10） HP_SSLServer_CleanupSSLContext (增加) > 其它更新： ----------------- 1、Demo 更新：所有 Demo 支持 IPv6；所有 SSL Demo 支持新的证书机制 2、公共代码包 vc-common-src 升级到 v2.3.20 > 升级说明： ----------------- 1、SSL 组件：需要调整 SSL Context 初始化方式 2、其他组件：HP-Socket v5.0.1 完全兼容 HP-Socket v4.x.x 版本，可以直接替换升级 ========================================================================================== v4.3.1 更新： ========================================================================================== > HTTP： ----------------- 1、IHttpClient 和 IHttpAgent 组件兼容没有长度标识（如：Content-Length Header）的 HTTP 响应报文 2、IHttpClient 和 IHttpAgent 组件改进 HEAD 请求的响应处理方式，应用程序无需在 OnHeadersComplete 事件中返回特殊值 HPR_SKIP_BODY > 其它更新： ----------------- 1、公共代码包 vc-common-src 升级到 v2.3.19 2、OpenSSL 升级到 1.1.0f 3、优化 IServer/IAgent 组件，提升性能和稳定性 > 升级说明： ----------------- 1、HP-Socket v4.3.1 完全兼容 HP-Socket v4.2.1 版本，可以直接替换升级 ========================================================================================== v4.2.1 更新： ========================================================================================== > HTTP Cookie 管理： ----------------- 1、新增 Cookie 管理器，可在不同连接、不同组件对象间共享 Cookie 2、Cookie 管理器实现了标准 HTTP Cookie 功能，支持 Max-Age、expires、httpOnly、secure 3、Cookie 管理器支持 Cookie 序列化与反序列化 4、IHttpClient 和 IHttpAgent 组件可通过 SetUseCookie() 方法设置是否开启 Cookie 功能 > HTTP Sync Client 通信组件： ----------------- 1、Create_HP_HttpSyncClient 和 Create_HP_HttpsSyncClient 方法增加可选参数 pListener 2、如果 pListener 非空则可以通过 pListener 监听 HttpSyncClient 的所有通信事件 > 其它更新： ----------------- 1、Demo 更新：HttpProxy，TestEcho-Http，TestEcho-Http-4C 2、公共代码包 vc-common-src 升级到 v2.3.18 3、OpenSSL 升级到 1.1.0e > 升级说明： ----------------- 1、HTTP Sync Client 组件：需要调整 Create_HP_HttpSyncClient 和 Create_HP_HttpsSyncClient 的调用参数 2、其他组件：HP-Socket v4.2.1 完全兼容 HP-Socket v4.1.x 版本，可以直接替换升级 ========================================================================================== 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 服务端程序加入“连接过滤”和“主动断开连接”示例