========================================================================================== v6.0.3 更新: ========================================================================================== > 主要更新: ----------------- 1、修复BUG:上个版本升级 llhttp 时,意外导出了 llhttp 库函数 > 第三方库更新: ----------------- 1、openssl 升级到 3.0.15 > 升级说明: ----------------- 1、HP-Socket v6.0.2 兼容 HP-Socket v6.0.1 版本,可以直接替换升级 ========================================================================================== v6.0.2 更新: ========================================================================================== > 主要更新: ----------------- 1、支持定时回收垃圾内存和被动回收垃圾内存(默认使用定时回收,回收间隔 15 秒) 2、支持在没有安装 MFC 的环境下编译 > 第三方库更新: ----------------- 1、openssl 升级到 3.0.14 版本 2、llhttp 升级到 9.2.1 版本 3、mimalloc 升级到 2.1.7 版本 > 升级说明: ----------------- 1、HP-Socket v6.0.2 兼容 HP-Socket v6.0.1 版本,可以直接替换升级 ========================================================================================== v6.0.1 更新: ========================================================================================== > 主要更新: ----------------- 1、用 VS2022 及后续编译器编译 HP-Socket,会自动为 HP-Socket 工作线程设置唯一线程名称,方便跟踪调试 2、TCP Client/Agent 以同步方式连接服务端时,支持通过 SetSyncConnectTimeout() 设置连接超时时间 > 第三方库更新: ----------------- 1、openssl 升级到 3.0.13 版本 2、zlib 升级到 1.3.1 版本 > 升级说明: ----------------- 1、HP-Socket v6.0.1 兼容 HP-Socket v5.9.5 版本,可以直接替换升级 ========================================================================================== v5.9.5 更新: ========================================================================================== > 主要更新: ----------------- 1、问题修复:由于 v5.9.4 版本升级了 KCP 导致 UDP ARQ 组件不可用 > 升级说明: ----------------- 1、HP-Socket v5.9.5 兼容 HP-Socket v5.9.4 版本,可以直接替换升级 ========================================================================================== v5.9.4 更新: ========================================================================================== > 第三方库更新: ----------------- 1、openssl 升级到 3.0.12 版本 2、llhttp 升级到 9.1.3 版本 3、brotli 升级到 1.1.0 版本 > 升级说明: ----------------- 1、HP-Socket v5.9.4 兼容 HP-Socket v5.9.3 版本,可以直接替换升级 ========================================================================================== v5.9.3 更新: ========================================================================================== > 主要更新: ----------------- 1、问题修复:通过 POST/PUT 等带有请求内容的 HTTP 方法升级 websocket 协议时,可能会导致 HTTP Server 异常 2、UDP Client/Server 之间的单个心跳包发送失败不会立刻断开连接,只检测心跳是否超时来判断是否要断开连接 > 第三方库更新: ----------------- 1、openssl 升级到 1.1.1v 版本 2、llhttp 升级到 8.1.1 版本 > 升级说明: ----------------- 1、HP-Socket v5.9.3 兼容 HP-Socket v5.9.2 版本,可以直接替换升级 ========================================================================================== v5.9.2 更新: ========================================================================================== > 主要更新: ----------------- 1、HTTP Cookie 请求和响应头 ‘Cookie’、‘Set-Cookie’ 支持不区分大小写 2、小范围代码优化 > 第三方库更新: ----------------- 1、openssl 升级到 1.1.1u 版本 > 升级说明: ----------------- 1、HP-Socket v5.9.2 兼容 HP-Socket v5.9.1 版本,可以直接替换升级 ========================================================================================== 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 服务端程序加入“连接过滤”和“主动断开连接”示例