高性能 Socket 组件 HP-Socket v3.1.3 正式发布

DuMiYue 2014-03-31 10:22:27

加精

　　HP-Socket 是一套通用的高性能 Windows Socket 组件包，包含服务端组件（IOCP 模型）和客户端组件（Event Select 模型），广泛适用于 Windows 平台的 TCP 通信系统。HP-Socket 对通信层实现完全封装，上层应用不必关注通信层的任何细节；HP-Socket 提供基于事件通知模型的 API 接口，能非常简单高效地整合到各类应用程序中；另外，为了让大家能更方便的学习 HP-Socket，特此精心制作了一个功能测试示例（Test Echo）一个性能测试示例（Test Echo-PFM）和一个 PULL 模型测试示例（Test Echo-Pull），用户可以通过这两个测试示例入手，迅速掌握组件的设计思想和使用方法。

* HP-Socket 官方网站：http://www.jessma.org
* HP-Socket 下载地址：http://www.oschina.net/p/hp-socket
------------------------------------------------------------------------------------------------
通用性
　　通信组件的唯一职责就是接受和发送字节流，绝对不能参与上层协议解析等工作；
与上层使用者解耦、互不依赖，组件与使用者通过操作接口和监听器接口进行交互，组件实现操作接口为上层提供操作方法；使用者实现监听器接口把自己注册为组件的 Listener，接收组件通知。因此，任何使用者只要实现了监听器接口都可以使用组件；另一方面，甚至可以自己重新写一个实现方式完全不同的组件实现给使用者调用，只要该组件遵从组件的操作接口，这也是 DIP 设计原则的体现。

可用性
　　可用性对所有通用组件都是至关重要的，如果太难用还不如自己重头写一个来得方便。因此，组件的操作接口和监听器接口设计得尽量简单易用（通俗来说就是“傻瓜化”），这两个接口的主要方法均不超过 5 个。另外，组件完全封装了所有的底层 Socket 通信，上层应用看不到任何通信细节，不必也不能干预任何通信操作，Socket 连接被抽象为 Connection ID，该参数作为连接标识提供给上层应用识别不同的连接。

高性能
　　作为底层的通用组件，性能问题是必须考虑的，绝对不能成为系统的瓶颈。而另一方面，从实际出发，根据客户端组件与服务端组件的性能要求采用不同的 Socket 模型。组件在设计上充分考虑了性能、现实使用情景、可用性和实现复杂性等因素，确保满足性能要求的同时又不会写得太复杂。做出以下两点设计决策：
　　客户端：在单独线程中实现 Socket 通信交互。这样可以避免与主线程或其他线程相互干扰；I/O 模型选择 Event Select 通信模型。
　　服务端：采用 Windows 平台效率最高的 IOCP 通信模型；利用缓存池技术，在通信的过程中，通常需要频繁的申请和释放内存缓冲区，建立了动态缓存池，只有当缓存池中没有可用对象时才创建新对象，而当缓存对象过多时则会压缩缓存池；另外，组件的动态内存通过私有堆（Private Heap）机制分配，避免与 new / malloc 竞争同时又减少内存空洞。

伸缩性
　　可以根据实际的使用环境要求设置组件的各项性能参数（如：工作线程的数量、各种缓存池的大小、收发缓冲区的大小、Socket 监听队列的大小、Accep 派发的数目以及心跳检查的间隔等）。
------------------------------------------------------------------------------------------------

*** 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;

}

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

*** 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 缓冲区
------------------------------------------------------------------------------------------------

*** 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) Bin/x86/HPSocket.dll    - (32位/MBCS/Release)

       (2) Bin/x86/HPSocket_D.dll  - (32位/MBCS/DeBug)

       (3) Bin/x86/HPSocket_U.dll  - (32位/UNICODE/Release)

       (4) Bin/x86/HPSocket_UD.dll - (32位/UNICODE/DeBug)

       (5) Bin/x64/HPSocket.dll    - (64位/MBCS/Release)

       (6) Bin/x64/HPSocket_D.dll  - (64位/MBCS/DeBug)

       (7) Bin/x64/HPSocket_U.dll  - (64位/UNICODE/Release)

       (8) Bin/x64/HPSocket_UD.dll - (64位/UNICODE/DeBug)

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

*** 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 对象缓存列表设置了锁定时间，提高访问的安全性
------------------------------------------------------------------------------------------------

*** 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、通过上述两个方法，应用程序可以为每个连接绑定任意附加数据并把数据获取出来
------------------------------------------------------------------------------------------------

*** 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

...全文

2221 66 打赏收藏转发到动态举报

写回复

用AI写文章

66 条回复

切换为时间正序

请发表友善的回复…

发表回复

孤飞俊驰 2014-10-13

打赏
举报

可以私下交流一些问题吗？我QQ445013639

孤飞俊驰 2014-10-13

打赏
举报

我看了下你的代码，我有几点疑问，如何处理连续收包的问题，如一个5K的文件，客户端每次只发1K到服务端，服务器连续接受5次(当然，协议里面有总包数和包序号)，接受完成之后工作线程才处理数据，请问我上层怎么调用你的函数？

teaccc2000 2014-04-19

打赏
举报

用到了，在一个winform 程序中用到了，，还在测试中，服务器同时连接数在2到5个左右，每次传递的数据在20-30个字节左右，挺稳定的。谢谢先。

DuMiYue 2014-04-15

打赏
举报

引用 51 楼 teaccc 的回复:

关注，正在找类似的程序，谢谢先。

用起来了没有呢？~

DuMiYue 2014-04-15

打赏
举报

引用 62 楼 gufeijunchi 的回复:

[quote=引用 60 楼 DuMiYue 的回复:] [quote=引用 35 楼 gufeijunchi 的回复:] 过来关注一下，没用到楼主的组件，但是用到了IOCP模型。

haha, 可以考虑换了~[/quote] 在下了看，对了你的VC-Logger 功能有没有log4cxx强大？[/quote] 何谓强大~？如果指性能的话你下来测试比较一下~

孤飞俊驰 2014-04-15

打赏
举报

引用 60 楼 DuMiYue 的回复:

[quote=引用 35 楼 gufeijunchi 的回复:] 过来关注一下，没用到楼主的组件，但是用到了IOCP模型。

haha, 可以考虑换了~[/quote] 在下了看，对了你的VC-Logger 功能有没有log4cxx强大？

DuMiYue 2014-04-11

打赏
举报

引用 35 楼 gufeijunchi 的回复:

过来关注一下，没用到楼主的组件，但是用到了IOCP模型。

haha, 可以考虑换了~

DuMiYue 2014-04-10

打赏
举报

引用 56 楼 DuMiYue 的回复:

[quote=引用 54 楼 oldmtn 的回复:] 经过本人又一次研究，自己回答了自己的问题。你在HPSocket.h里面给出的方法是：方法一： -------------------------------------------------------------------------------------- 0. 应用程序包含 SocketInterface.h 和 HPSocket.h 头文件 1. 调用 HP_Create_Xxx() 函数创建 HPSocket 对象 2. 使用完毕后调用 HP_Destroy_Xxx() 函数销毁 HPSocket 对象这是常规调用DLL的用法。但是你的Sample-TestEcho里面却将Common文件夹以及CTcpServer这个类直接包含了进来，因此可以直接调用类，而不需要指针。啊呀，，，，，，。。也许也是为了方便吧。。。

HPSocket提供3种使用方式： 1、源代码方式：不解释，例子 TestEcho、TestEcho-UDP 2、C++ DLL 方式：C++程序通过 HPSocket.dll使用 HP-Socket，对C++程序来说是首选 3、C DLL方式：其他语言程序通过 HPSocket4C.dll使用 HP-Socket，对C++程序来说不是首选[/quote] 1、源代码方式：TestEcho、TestEcho-UDP 2、C++ DLL 方式：TestEcho-PFM、TestEcho-Pull 3、C DLL方式：TestEcho-4

DuMiYue 2014-04-10

打赏
举报

引用 54 楼 oldmtn 的回复:

经过本人又一次研究，自己回答了自己的问题。你在HPSocket.h里面给出的方法是：方法一： -------------------------------------------------------------------------------------- 0. 应用程序包含 SocketInterface.h 和 HPSocket.h 头文件 1. 调用 HP_Create_Xxx() 函数创建 HPSocket 对象 2. 使用完毕后调用 HP_Destroy_Xxx() 函数销毁 HPSocket 对象这是常规调用DLL的用法。但是你的Sample-TestEcho里面却将Common文件夹以及CTcpServer这个类直接包含了进来，因此可以直接调用类，而不需要指针。啊呀，，，，，，。。也许也是为了方便吧。。。

DuMiYue 2014-04-10

打赏
举报

引用 58 楼 oldmtn 的回复:

TO LZ: 我看了你的CUdpClient后，想提点意见。昨天本想发的，结果三连，发不了。你的UdpClient也同样要进行connect，然后再send发送。而很多时候udp需要直接调用sendto向不同的地址发送数据。你要是能把sendto也实现了就好了。。一点小意见。。。

这个 UDP 组件应用于 C/S 模式的场合，不处理随意发送的情形，这种情形其实不多，需要的话可以用Client+Server组合来实现。

oldmtn 2014-04-10

打赏
举报

TO LZ: 我看了你的CUdpClient后，想提点意见。昨天本想发的，结果三连，发不了。你的UdpClient也同样要进行connect，然后再send发送。

而很多时候udp需要直接调用sendto向不同的地址发送数据。你要是能把sendto也实现了就好了。。一点小意见。。。

DuMiYue 2014-04-09

打赏
举报

引用 50 楼 oldmtn 的回复:

另外，你的例子为什么不在 Server中加上send这个功能呢？？？

1、Apache 2.0 开源协议，随便你怎么用，只需要源文件保留 License 描述。 2、例子是 Echo，当然有 Send 功能了。

oldmtn 2014-04-09

打赏
举报

引用 52 楼 DuMiYue 的回复:

[quote=引用 50 楼 oldmtn 的回复:] 另外，你的例子为什么不在 Server中加上send这个功能呢？？？

1、Apache 2.0 开源协议，随便你怎么用，只需要源文件保留 License 描述。 2、例子是 Echo，当然有 Send 功能了。 [/quote] 但是你的Server没有主动点击按钮再发送指定字符串。不过我仔细看后，已经解决了。。。 tks.

oldmtn 2014-04-09

打赏
举报

经过本人又一次研究，自己回答了自己的问题。你在HPSocket.h里面给出的方法是：方法一： -------------------------------------------------------------------------------------- 0. 应用程序包含 SocketInterface.h 和 HPSocket.h 头文件 1. 调用 HP_Create_Xxx() 函数创建 HPSocket 对象 2. 使用完毕后调用 HP_Destroy_Xxx() 函数销毁 HPSocket 对象这是常规调用DLL的用法。但是你的Sample-TestEcho里面却将Common文件夹以及CTcpServer这个类直接包含了进来，因此可以直接调用类，而不需要指针。啊呀，，，，，，

。。也许也是为了方便吧。。。

oldmtn 2014-04-09

打赏
举报

引用 52 楼 DuMiYue 的回复:

[quote=引用 50 楼 oldmtn 的回复:] 另外，你的例子为什么不在 Server中加上send这个功能呢？？？

1、Apache 2.0 开源协议，随便你怎么用，只需要源文件保留 License 描述。 2、例子是 Echo，当然有 Send 功能了。 [/quote] 方法一： -------------------------------------------------------------------------------------- 0. 应用程序包含 SocketInterface.h 和 HPSocket.h 头文件 1. 调用 HP_Create_Xxx() 函数创建 HPSocket 对象 2. 使用完毕后调用 HP_Destroy_Xxx() 函数销毁 HPSocket 对象这是你提供的方法？但是你给出的TestEcho等例子中并没有这样做却也调用成功了，为什么？？？