高品质 Socket 组件 HP-Socket v3.1.2 正式公告

2020-02-07 10:45栏目:竞技宝app
TAG:

图片 1

HP-Socket是一套通用的高性能WindowsSocket组件包,包含服务端组件和客户端组件,广泛适用于Windows平台的TCP通信系统。HP-Socket对通信层实现完全封装,上层应用不必关注通信层的任何细节;HP-Socket提供基于事件通知模型的API接口,能非常简单高效地整合到各类应用程序中;另外,为了让大家能更方便的学习HP-Socket,特此精心制作了一个功能测试示例一个性能测试示例和一个PULL模型测试示例,用户可以通过这两个测试示例入手,迅速掌握组件的设计思想和使用方法。*HP-Socket官方网站:*HP-Socket下载地址:通用性 通信组件的唯一职责就是接受和发送字节流,绝对不能参与上层协议解析等工作;与上层使用者解耦、互不依赖,组件与使用者通过操作接口和监听器接口进行交互,组件实现操作接口为上层提供操作方法;使用者实现监听器接口把自己注册为组件的Listener,接收组件通知。因此,任何使用者只要实现了监听器接口都可以使用组件;另一方面,甚至可以自己重新写一个实现方式完全不同的组件实现给使用者调用,只要该组件遵从组件的操作接口,这也是DIP设计原则的体现。可用性 可用性对所有通用组件都是至关重要的,如果太难用还不如自己重头写一个来得方便。因此,组件的操作接口和监听器接口设计得尽量简单易用,这两个接口的主要方法均不超过5个。另外,组件完全封装了所有的底层Socket通信,上层应用看不到任何通信细节,不必也不能干预任何通信操作,Socket连接被抽象为ConnectionID,该参数作为连接标识提供给上层应用识别不同的连接。高性能 作为底层的通用组件,性能问题是必须考虑的,绝对不能成为系统的瓶颈。而另一方面,从实际出发,根据客户端组件与服务端组件的性能要求采用不同的Socket模型。组件在设计上充分考虑了性能、现实使用情景、可用性和实现复杂性等因素,确保满足性能要求的同时又不会写得太复杂。做出以下两点设计决策: 客户端:在单独线程中实现Socket通信交互。这样可以避免与主线程或其他线程相互干扰;I/O模型选择EventSelect通信模型。 服务端:采用Windows平台效率最高的IOCP通信模型;利用缓存池技术,在通信的过程中,通常需要频繁的申请和释放内存缓冲区,建立了动态缓存池,只有当缓存池中没有可用对象时才创建新对象,而当缓存对象过多时则会压缩缓存池;另外,组件的动态内存通过私有堆机制分配,避免与new/malloc竞争同时又减少内存空洞。伸缩性 可以根据实际的使用环境要求设置组件的各项性能参数。------------------------------------------------------------------------------------------------***v3.1.2更新***修改Server组件的OnClose()/OnError()事件的触发规则:-----------------1、以前版本的TCP/UDPServer组件中,当关闭一个连接时可能会同时触发一个OnClose()事件和若干个OnError()事件2.由于存在上述可能性,所以应用程序需要对OnClose()/OnError()的处理事件代码段进行同步3、从v3.1.2开始,当多个OnClose()/OnError()事件同时发生时,组件只会向应用程序通知第一个事件,后续事件则忽略4.因此,应用程序在处理OnClose()/OnError()事件时不必处理同步,减少了出错的可能和编写同步及检测代码的负担

/*示例代码一:*//*-----------------------------------------------------------------------*/ISocketListener::EnHandleResultCServerDlg::OnClose(CONNIDdwConnID){//以前版本://有可能存在并发的OnClose()/OnError(),要把代码放在临界区中并检测返回值CCriSecLocklocallock(m_csPkgInfo);//--临界区PVOIDpInfo=nullptr;//--检测返回值if(m_Server-GetConnectionExtra(dwConnID,pInfo)pInfo!=nullptr){m_Server-SetConnectionExtra(dwConnID,nullptr);deletepInfo;}}/*示例代码二:*//*-----------------------------------------------------------------------*/ISocketListener::EnHandleResultCServerDlg::OnClose(CONNIDdwConnID){//v3.1.2版本://只会接收到一个OnClose()/OnError()事件,能安全地移除临界区代码和检测代码PVOIDpInfo=nullptr;m_Server-GetConnectionExtra(dwConnID,pInfo);ASSERT(pInfo!=nullptr);deletepInfo;}

其它更新:-----------------

1、调整TCPServer默认参数:1)DEFAULT_SOCKET_LISTEN_QUEUE:3002)DEFAULT_ACCEPT_SOCKET_COUNT:3003)DEFAULT_FREE_SOCKETOBJ_POOL:1504)DEFAULT_FREE_SOCKETOBJ_HOLD:4505)DEFAULT_FREE_BUFFEROBJ_POOL:3006)DEFAULT_FREE_BUFFEROBJ_HOLD:9002、调整UDPServer默认参数:1)DEFAULT_FREE_SOCKETOBJ_POOL:1502)DEFAULT_FREE_SOCKETOBJ_HOLD:4503)DEFAULT_FREE_BUFFEROBJ_POOL:3004)DEFAULT_FREE_BUFFEROBJ_HOLD:900

升级说明:-----------------1、使用HP-Socketv3.1.1及以前版本的应用程序可以安全升级到HP-Socketv3.1.2------------------------------------------------------------------------------------------------***v3.1.1更新***增加导出纯C函数的动态链接库HPSocket4C.dll:-----------------1、增加代码文件HPSocket4C.h和HPSocket4C.cpp,用于创建HPSocket4C.dll2、导出纯C函数,让其它语言能方便地使用HPSocket3、HPSocket4C.dll使用方法

方法一:----------------------------------------------------------------------------(0)包含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)全面启用BufferPool缓存机制:-----------------1、Common/Src增加代码文件bufferpool.h和bufferpool.cpp,实现BufferPool缓存机制2、通过BufferPool缓存机制提升内存使用效率,减少动态内存分配和释放操作,避免内存空洞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-Socket2、动态链接库使用方法

方法一:-----------------------------------------------------------------------(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采用EventSelect通信模型4、UDP通信组件的接口与原TCP通信组件一致,简单实用5、UDP通信组件内置通信线路自动监测机制6、新增UDP通信组件示例工程TestEcho-UDP代码重构与优化:-----------------1、规范所有接口、类以及代码文件的命名2、重构和优化了大量组件代码3、服务端组件加入读写锁机制,有效平衡处理性能与安全性4、服务端组件的Socket对象缓存列表设置了锁定时间,提高访问的安全性------------------------------------------------------------------------------------------------***v2.2.3更新***连接ID的数据类型改为‘CONNID’:-----------------1、在SocketHelper.h中定义CONNID数据类型2、应用程序可以把CONNID定义为其希望的类型3、为了便于移植与维护,应用程序的任何地方都应该用‘CONNID’类型引用连接ID服务端Socket组件支持为每个连接绑定附加数据:-----------------1、IServerSocket和CIocpServer增加方法Get/SetConnectionExtra()2、通过上述两个方法,应用程序可以为每个连接绑定任意附加数据并把数据获取出来------------------------------------------------------------------------------------------------***v2.2.2更新***优化心跳检测相关功能:-----------------1、IServerSocket和IClientSocket的Get/SetKeepAliveTimes()方法改为Get/SetKeepAliveTime()2、CIocpServer和CClientSocket的默认KeepAliveTime属性改为50003、CIocpServer和CClientSocket的默认KeepAliveInterval属性改为3000------------------------------------------------------------------------------------------------***v2.2.1更新***PULL模型支持:-----------------1、ISocketListener增加PULL模型数据接收通知方法OnReceive(dwConnID,int)2、增加PULLSocket接口IPullSocket,该接口的Fetch(dwConnID,pBuffer,iLength)方法用于抓取通信数据Server:-----------------1、服务端Socket接口ISocketServer改名为IServerSocket2、增加PULLServerSocket监听器抽象类CPullServerSocketListener3、增加PULLServerSocket接口IPullServerSocket4、增加PULLServerSocket实现类CIocpPullServerClient:-----------------1、客户端Socket接口ISocketClient改名为IClientSocket2、客户端Socket实现类CSocketClient改名为CClientSocket3、增加PULLClientSocket监听器抽象类CPullClientSocketListener4、增加PULLClientSocket接口IPullClientSocket5、增加PULLClientSocket实现类CPullClientSocket

版权声明:本文由龙竞技官网发布于竞技宝app,转载请注明出处:高品质 Socket 组件 HP-Socket v3.1.2 正式公告