hp-socket 是一套通用的高性能 tcp/udp socket 组件,包含服务端组件、客户端组件和 agent 组件,广泛适用于各种不同应用场景的 tcp/udp 通信系统,提供 c/c++、c#、delphi、e、java
等编程语言开发接口。hp-socket 对通信层实现完全封装,上层应用不必关注通信层的任何细节;hp-socket 提供基于事件通知模型的 api 接口,能非常简单高效地整合到新旧应用程序中。为了让使用者能方便快速地学习和使用 hp-socket,迅速掌握组件的设计思想和使用方法,特此精心制作了大量 demo 示例,包括 push 模型示例、pull模型示例和性能测试示例等。hp-socket 目前运行在 windows 平台,将来会实现跨平台支持。
----------------------------------------------------------------
通用性
通信组件的唯一职责就是接受和发送字节流,绝对不能参与上层协议解析等工作;
与上层使用者解耦、互不依赖,组件与使用者通过操作接口和监听器接口进行交互,组件实现操作接口为上层提供操作方法;使用者实现监听器接口把自己注册为组件的 listener,接收组件通知。因此,任何使用者只要实现了监听器接口都可以使用组件;另一方面,甚至可以自己重新写一个实现方式完全不同的组件实现给使用者调用,只要该组件遵从组件的操作接口,这也是 dip 设计原则的体现。
可用性
可用性对所有通用组件都是至关重要的,如果太难用还不如自己重头写一个来得方便。因此,组件的操作接口和监听器接口设计得尽量简单易用(通俗来说就是“傻瓜化”),这两个接口的主要方法均不超过 5 个。另外,组件完全封装了所有的底层 socket 通信,上层应用看不到任何通信细节,不必也不能干预任何通信操作,socket 连接被抽象为 connection id,该参数作为连接标识提供给上层应用识别不同的连接。
高性能
作为底层的通用组件,性能问题是必须考虑的,绝对不能成为系统的瓶颈。而另一方面,从实际出发,根据客户端组件与服务端组件的性能要求采用不同的 socket 模型。组件在设计上充分考虑了性能、现实使用情景、可用性和实现复杂性等因素,确保满足性能要求的同时又不会写得太复杂。做出以下两点设计决策:
客户端:在单独线程中实现 socket 通信交互,这样可以避免与主线程或其他线程相互干扰;i/o 模型选择 event select 通信模型。每个组件对象管理一个 socket 连接。
服务端:采用高效的 iocp 通信模型;利用缓存池技术,在通信的过程中,通常需要频繁的申请和释放内存缓冲区,建立了动态缓存池, 只有当缓存池中没有可用对象时才创建新对象,而当缓存对象过多时则会压缩缓存池;另外,组件的动态内存通过私有堆(private heap)机制分配,避免与 new / malloc 竞争同时又减少内存空洞。
agent:对于代理服务器或中转服务器等应用场景,服务器自身也作为客户端向其它服务器发起大规模连接,一个 agent 组件对象管理多个 socket 连接,与服务端采用相同的技术架构,可以用作代理服务器或中转服务器的客户端部件。
伸缩性
可以根据实际的使用环境要求设置组件的各项性能参数(如:工作线程的数量、各种缓存池的大小、收发缓冲区的大小、socket 监听队列的大小、accep 派发的数目以及心跳检查的间隔等)。
(项目主页:,下载地址:)
*** v3.2.1 更新 ***
> 增加 tcpagent / tcppullagent 通信组件:
-----------------
对于代理服务器或中转服务器等应用场景,服务器自身也作为客户端向其它服务器发起大规模连接
tcpclient / tcppullclient 基于 event select 通信模型,每个组件对象管理一个 socket,并开启一个线程,不适合上述应用场景
tcpagent / tcppullagent 基于 iocp 通信模型,一个组件对象管理多个 socket,适合用作代理服务器或中转服务器的客户端通信组件
tcpagent / tcppullagent 的使用方式依然简单,提供以下接口方法:
增加 tcpagent / tcppullagent 使用示例:agent-pfm / agent-pull / agent-4c

> 增加 hpsocket for java sdk:
提供 java 开发包:hpsocket-3.2.1.jar(通过 jna 实现,目前只支持 windows 平台)
运行环境:jdk 1.6+,jvm 运行在 server 模式("java -server",在 client 模式下性能受影响)
mbcs 和 unicode 版本分布位于包 org.jessma.hpsocket.mbcs 和 org.jessma.hpsocket.unicode
hpsocket for java sdk 提供以下通信组件:
hpsocket4j 的使用方法(以 tcpagent 为例):
增加示例工程 testecho-4j,展示 hpsocket4j 的使用方法(包括 pull 模型示例和性能测试示例)
> 优化数据发送策略:
iclient/iserver/iagent 组件的 send() 方法不直接把数据投递到完成端口
在高负载情形下,数据会放入发送队列,并进行数据包合并,避免高负载下发生 10055 错误
当发送大量小数据包时,自动组包机制能大大提高发送效率
应用程序可以通过 getpendingdatalength() 获取队列中未发出的数据,从而实现流量控制
> 其它更新:
iserver 的 getclientaddress() 方法改名为 getremoteaddress()
iclient 的 send() 方法删除 “connid dwconnid” 参数
iclient/iserver/iagent 的 send() 方法增加发送数据缓冲区指针偏移量参数 “int ioffset”
enservererror / enclienterror 枚举类型合并为 ensocketerror
ensocketerror / enhandleresult / enfetchresult 枚举类型从原所在类中移到外部
iclient/iserver/iagent 增加方法:bool getpendingdatalength(),获取连接中未发出数据的长度
hpsocket4c.dll 增加方法 sendpart(),支持指定缓冲区指针偏移量
增加 hpsocket for c# sdk(由 int 2e 提供)
公共代码包 vc-common-src 更新为 v2.3.4(参考:vc-common-src v2.3.4 的 change log)
> 升级说明:
hp-socket v3.2.1 在功能上兼容 hp-socket v3.1.3 及以前版本
接口有变化,需要根据提示修改程序代码;注意:现有程序不能直接替换 v3.1.3 的 dll
enservererror / enclienterror 枚举类型合并为 ensocketerror,注意一些枚举值发生了变化
*** v3.1.3 更新 ***
> 增加其它语言 demo:
c#
delphi
e 语言
> bug fix:
修复 ip 地址判断错误 bug
修复域名或主机名的 ip 地址解析错误 bug
*** v3.1.2 更新 ***
> 修改 server 组件的 onclose() / onerror() 事件的触发规则:
以前版本的 tcp/udp server 组件中,当关闭一个连接时可能会同时触发一个 onclose() 事件和若干个 onerror() 事件
由于存在上述可能性,所以应用程序需要对 onclose() / onerror() 的处理事件代码段进行同步
从 v3.1.2 开始,当多个 onclose() / onerror() 事件同时发生时,组件只会向应用程序通知第一个事件,后续事件则忽略
因此,应用程序在处理 onclose() / onerror() 事件时不必处理同步,减少了出错的可能和编写同步及检测代码的负担
示例代码
*** v3.1.1 更新 ***
> 增加导出纯 c 函数的动态链接库 hpsocket4c.dll:
增加代码文件 hpsocket4c.h 和 hpsocket4c.cpp,用于创建 hpsocket4c.dll
导出纯 c 函数,让其它语言(如:c/c#/delphi 等)能方便地使用 hpsocket
hpsocket4c.dll 使用方法
动态链接库发行版本
> 全面启用 buffer pool 缓存机制:
common/src 增加代码文件 bufferpool.h 和 bufferpool.cpp,实现 buffer pool 缓存机制
通过 buffer pool 缓存机制提升内存使用效率,减少动态内存分配和释放操作,避免内存空洞
ictcpclient 用 citempool 和 titemlist 实现发送缓冲区
cudpclient 用 citempool 和 titemlist 实现发送缓冲区
ctcppullclient 用 citempool 和 titemlist 实现发送缓冲区和 pull 缓冲区
ctcppullserver 用 cbufferpool 和 tbuffer 实现 pull 缓冲区
*** v3.0.2 更新 ***
> 把 hp-socket 编译为动态链接库:
应用程序可以通过导入源代码或动态链接库方式使用 hp-socket
动态链接库使用方法
*** v3.0.1 更新 ***
> 新增 udp 通信组件:
新增两个 udp 通信组件:cudpserver 为服务端组件,cudpclient 为客户端组件
服务端组件 cudpserver 采用 iocp 通信模型
客户端组件 cudpclient 采用 event select 通信模型
udp 通信组件的接口与原 tcp 通信组件一致,简单实用
udp 通信组件内置通信线路自动监测机制
新增 udp 通信组件示例工程 testecho-udp
> 代码重构与优化:
规范所有接口、类以及代码文件的命名
重构和优化了大量组件代码
服务端组件加入读写锁机制,有效平衡处理性能与安全性
服务端组件的 socket 对象缓存列表设置了锁定时间,提高访问的安全性