HP-Socket 是一套通用的高性能 TCP/UDP/HTTP 通信框架,包含服务端组件、客户端组件和 Agent 组件,广泛适用于各种不同应用场景的 TCP/UDP/HTTP 通信系统,提供 C/C++、C#、Delphi、E(易语言)、Java、Python 等编程语言接口。HP-Socket 对通信层实现完全封装,应用程序不必关注通信层的任何细节;HP-Socket 提供基于事件通知模型的 API 接口,能非常简单高效地整合到新旧应用程序中。
为了让使用者能方便快速地学习和使用 HP-Socket,迅速掌握框架的设计思想和使用方法,特此精心制作了大量 Demo 示例(如:PUSH 模型示例、PULL 模型示例、PACK 模型示例、性能测试示例以及其它编程语言示例)。HP-Socket 目前运行在 Windows 平台,将来会实现跨平台支持。
《HP-Socket v4.1 开发指南》
----------------------------------------------------------------
通用性
- HP-Socket 的唯一职责就是接收和发送字节流,不参与应用程序的协议解析等工作。
- HP-Socket 与应用程序通过接口进行交互,并完全解耦。任何应用只要实现了 HP-Socket 的接口规范都可以无缝整合 HP-Socket。
易用性
- 易用性对所有通用框架都是至关重要的,如果太难用还不如自己重头写一个来得方便。因此,HP-Socket 的接口设计得非常简单和统一。
- HP-Socket 完全封装了所有底层通信细节,应用程序不必也不能干预底层通信操作。通信连接被抽象为 Connection ID,Connection ID 作为连接的唯一标识提供给应用程序来处理不同的连接。
- HP-Socket 提供 PUSH / PULL / PACK 等接收模型, 应用程序可以灵活选择以手工方式、 半自动方式或全自动方式处理封解包, PULL / PACK 接收模型在降低封解包处理复杂度的同时能大大减少出错几率。
高性能
- Client 组件:基于 Event Select 通信模型,在单独线程中执行通信操作,避免与主线程或其他线程相互干扰。每个组件对象管理一个 Socket 连接。
- Server 组件:基于 IOCP 通信模型,并结合缓存池、私有堆(Private Heap)等技术,支持超大规模连接,在高并发场景下实现高效内存管理。
- Agent 组件:对于代理服务器或中转服务器等应用场景,服务器自身也作为客户端向其它服务器发起大规模连接,一个 Agent 组件对象同时可管理多个 Socket 连接;Agent 组件与 Server 组件采用相同的技术架构,可以用作代理服务器或中转服务器的客户端部件。
伸缩性
应用程序能够根据不同的容量要求、通信规模和资源状况等现实场景调整 HP-Socket 的各项性能参数(如:工作线程的数量、缓存池的大小、发送模式和接收模式等),优化资源配置,在满足应用需求的同时不必过度浪费资源。
(项目主页:点击这里,下载地址:点击这里)
*** v4.1.1更新 ***
> WebSocket 支持:
-----------------
- 所有 HTTP 组件增加 WebSocket 方法
1) SendWSMessage(): 发送 WebSocket 数据包
2) GetWSMessageState(): 获取当前 WebSocket 状态
- 所有 HTTP 组件监听器增加 WebSocket 事件
1) OnWSMessageHeader(): WebSocket 数据包头通知
2) OnWSMessageBody(): WebSocket 数据包体通知
3) OnWSMessageComplete(): WebSocket 数据包完成通知
- 示例 Demo TestEcho-Http 和 TestEcho-Http-4C 支持 WebSocket
> 增加 HTTP Sync Client 通信组件:
-----------------
- HTTP Sync Client 实现同步 HTTP 通信,不需要事件监听器
- HTTP Sync Client 组件类: CHttpSyncClient、CHttpsSyncClient
- HTTP Sync Client 实现接口: ITcpClient / IHttpSyncRequester
- 示例 Demo TestEcho-Http 和 TestEcho-Http-4C 提供 HTTP Sync Client 示例
*** v4.0.1更新 ***
> 增加 HTTP 系列通信组件:
-----------------
- 新增 HTTP Server 组件
1) 组件类:CHttpServer、CHttpsServer
2) 实现接口:ITcpServer / IComplexHttpResponder
3) 监听器接口:IHttpServerListener
- 新增 HTTP Agent 组件
1) 组件类:CHttpAgent、CHttpsAgent
2) 实现接口:ITcpAgent / IComplexHttpRequester
3) 监听器接口:IHttpAgentListener
- 新增 HTTP Client 组件
1) 组件类:CHttpClient、CHttpsClient
2) 实现接口:ITcpClient / IHttpRequester
3) 监听器接口:IHttpServerListener
- 新增 HTTP 示例 Demo
1) TestEcho-Http (源代码)
2) TestEcho-Http-4C (4C LIB / 4C DLL)
- 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 : 终止解析,断开连接
> 组件接口调整:
-----------------
- IServer 和 IAgent 组件的所有监听器回调方法增加‘事件源’参数,如:OnShutdown() -&