HP-Socket-TCP--UDP-通信框架开发指南-(v3.5-20160501).pdf

高性能 TCP UDP 通信框架 —— HP-Socket v3.5 Bruce Liang 前 言 HP-Socket 是一套通用的高性能 TCP/UDP 通信框架，包含服务端组件、客 户端组件和Agent 组件，广泛适用于各种不同应用场景的TCP/UDP 通信系统， 提供C/C++、C#、Delphi 、E （易语言）、Java 、Python 等编程语言接口。HP-Socket 对通信层完全封装，应用程序不必关注通信层的任何细节；HP-Socket 提供基于 事件通知模型的API 接口，能非常简单高效地整合到新旧应用程序中。 为了让使用者能方便快速地学习和使用 HP-Socket，迅速掌握框架的设计思 想和使用方法，特此精心制作了大量 Demo 示例（如：PUSH 模型示例、PULL 模型示例、PACK 模型示例、性能测试示例以及其它编程语言示例）。HP-Socket 目前运行在Windows 平台，将来会实现跨平台支持。  通用性  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 的 各项性能参数 （如：工作线程的数量、缓存池的大小、发送模式和接收模式等），优化资源 配置，在满足应用需求的同时不必过度浪费资源。 1 目录 前 言 1 1 概 述3 1.1 整体架构3 1.2 组件分类5 1.3 组件接口6 1.4 监听器接口8 2 框架详述 11 2.1 关键概念 11 2.1.1 接收模型 11 2.1.2 发