HP-socket-4.3.1（高性能通信组件）

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 服务端程序加入“连接过滤”和“主动断开连接”示例

资源下载：