高性能 TCP & UDP 通信框架 HP-Socket v3.4.1 正式发布

DuMiYue 2016-04-07 11:42:45

加精

　　HP-Socket 是一套通用的高性能 TCP/UDP 通信框架，包含服务端组件、客户端组件和 Agent 组件，广泛适用于各种不同应用场景的 TCP/UDP 通信系统，提供 C/C++、C#、Delphi、E（易语言）、Java、Python 等编程语言接口。HP-Socket 对通信层实现完全封装，应用程序不必关注通信层的任何细节；HP-Socket 提供基于事件通知模型的 API 接口，能非常简单高效地整合到新旧应用程序中。
　　为了让使用者能方便快速地学习和使用 HP-Socket，迅速掌握框架的设计思想和使用方法，特此精心制作了大量 Demo 示例（如：PUSH 模型示例、PULL 模型示例、性能测试示例以及其它编程语言示例）。HP-Socket 目前运行在 Windows 平台，将来会实现跨平台支持。

* HP-Socket 官方网站：http://www.jessma.org
* HP-Socket 项目主页：http://www.oschina.net/p/hp-socket
* HP-Socket 开发文档：http://www.oschina.net/p/hp-socket/doc
------------------------------------------------------------------------------------------------
【通用性】
　　1、HP-Socket 的唯一职责就是接收和发送字节流，不参与应用程序的协议解析等工作。
　　2、HP-Socket 与应用程序通过接口进行交互，并完全解耦。任何应用只要实现了 HP-Socket 的接口规范都可以无缝整合 HP-Socket。

【易用性】
　　1、易用性对所有通用框架都是至关重要的，如果太难用还不如自己重头写一个来得方便。因此，HP-Socket 的接口设计得非常简单和统一。
　　2、HP-Socket 完全封装了所有底层通信细节，应用程序不必也不能干预底层通信操作。通信连接被抽象为 Connection ID，Connection ID 作为连接的唯一标识提供给应用程序来处理不同的连接。
　　3、HP-Socket 提供 PUSH / PULL / PACK 等接收模型，应用程序可以灵活选择以手工方式、半自动方式或全自动方式处理封解包， PULL / PACK 接收模型在降低封解包处理复杂度的同时能大大减少出错几率。

【高性能】
　　Client 组件：基于 Event Select 通信模型，在单独线程中执行通信操作，避免与主线程或其他线程相互干扰。每个组件对象管理一个 Socket 连接。
　　Server 组件：基于 IOCP 通信模型，并结合缓存池、私有堆（Private Heap）等技术，支持超大规模连接，在高并发场景下实现高效内存管理。
　　Agent 组件：对于代理服务器或中转服务器等应用场景，服务器自身也作为客户端向其它服务器发起大规模连接，一个 Agent 组件对象同时可管理多个 Socket 连接；Agent 组件与 Server 组件采用相同的技术架构，可以用作代理服务器或中转服务器的客户端部件。

【伸缩性】
　　应用程序能够根据不同的容量要求、通信规模和资源状况等现实场景调整 HP-Socket 的各项性能参数（如：工作线程的数量、缓存池的大小、发送模式和接收模式等），优化资源配置，在满足应用需求的同时不必过度浪费资源。
------------------------------------------------------------------------------------------------

*** v3.4.1 更新 ***

> 增加 Tcp Pack 系列通信组件：
-----------------
1、Tcp Pack 系列组件保证每个 OnReceive 事件都向应用程序提供一个完整数据包
2、Tcp Pack 系列组件是 PUSH/PULL 模式的结合体，应用程序不必处理分包（如：PUSH）与数据抓取（如：PULL）
3、Tcp Pack 系列组件提供 Get/SetMaxPackSize() 和 Get/SetPackHeaderFlag() 方法，用来设置最大包长和包头标识
4、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()
------------------------------------------------------------------------------------------------

*** v3.3.2 更新 ***

> 组件接口调整：
-----------------
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()：// 设置是否标记静默时间  

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