发布于 2016-11-30 07:26:11 | 178 次阅读 | 评论: 0 | 来源: 网友投递
HP-Socket 高性能 TCP/UDP 通信框架
HP-Socket 是一套通用的高性能 TCP/UDP 通信框架,包含服务端组件、客户端组件和Agent组件,广泛适用于各种不同应用场景的 TCP/UDP 通信系统,提供 C/C++、C#、Delphi、E(易语言)、Java、Python 等编程语言接口。HP-Socket 对通信层实现完全封装,应用程序不必关注通信层的任何细节;HP-Socket 提供基于事件通知模型的 API 接口,能非常简单高效地整合到新旧应用程序中。
高性能通信框架 HP-Socket v4.1.1 发布了,更新如下
*** 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() -> OnShutdown(T* pSender)
IClient 组件的所有监听器回调方法增加‘连接ID’参数,如:OnHandShake(IClient* pClient) -> OnHandShake(T* pSender, CONNID dwConnID)
IServer 和 IAgent 接口增加接口方法: Get/SetMaxConnectionCount() 用于设置最大连接数,最大连接数默认:10000
OnHandShake() 事件触发规则调整:非 SSL 组件在 OnConnect() 事件后也触发 OnHandShake() 事件,使 SSL 组件和 SSL 组件处理流程一致
HPSocket4C 增加 PACK 组件监听器的创建、销毁方法,新版本必须使用下列方法创建、销毁 PACK 组件监听器:
1) Create_HP_TcpPackServerListener / Destroy_HP_TcpPackServerListener
2) Create_HP_TcpPackAgentListener / Destroy_HP_TcpPackAgentListener
3) Create_HP_TcpPackClientListener / Destroy_HP_TcpPackClientListener
SSL 组件支持 SNI
1) SSL 初始化方法 HP_SSL_Initialize(),增加 SNI 回调函数指针参数
2) 新增方法 HP_SSL_AddServerContext(),用于 加载 SNI 主机证书
> 其他更新:
-----------------
IServer 和 IAgent 组件采用 Ring Pool 取代 R/W Lock + Map 维护活动连接,提升读写和并发性能
更新所有 Demo 示例代码
*** v3.5.1更新 ***
> 增加 SSL 系列通信组件:
-----------------
新增 SSL PUSH 组件:CSSLServer、CSSLAgent、CSSLClient
新增 SSL PULL 组件:CSSLPullServer、CSSLPullAgent、CSSLPullClient
新增 SSL PACK 组件:CSSLPackServer、CSSLPackAgent、CSSLPackClient
SSL Server 实现 ITcpServer 接口,SSL Agent 实现 ITcpAgent 接口,SSL Client 实现 ITcpClient 接口
启动 SSL 通信组件前需要调用 HP_SSL_Initialize() 函数初始化 SSL 全局环境参数
通信结束后调用 HP_SSL_Cleanup() 函数清理 SSL 全局运行环境
新增 SSL 相关示例 Demo:
1) TestEcho-SSL (源代码) 2) TestEcho-SSL-Pack (DLL / 4C DLL) 3) TestEcho-SSL-4C (4C LIB) 4) TestEcho-SSL-PFM (LIB)
> 组件接口调整:
-----------------
ITcpServerListener 接口增加 SSL 握手成功事件:OnHandShake(CONNID dwConnID)
ITcpAgentListener 接口增加 SSL 握手成功事件:OnHandShake(CONNID dwConnID)
ITcpClientListener 接口增加 SSL 握手成功事件:OnHandShake(IClient* pClient)
枚举类型 EnSocketError 增加‘SSL 环境未就绪’错误代码 SE_SSL_ENV_NOT_READY
增加枚举类型:EnSSLSessionMode(SSL 工作模式),EnSSLVerifyMode(SSL 验证模式)
HPSocket-SSL DLL 主要头文件:SocketInterface-SSL.h,HPSocket-SSL.h
HPSocket4C-SSL DLL 主要头文件:HPSocket4C-SSL.h
Tcp Pack 系列组件可设置的最大包长调整为 4194303/0x3FFFFF 字节
Tcp Pack 系列组件的有效包头标识取值范围调整为 0 ~ 1023/0x3FF
> 增加静态库工程:
-----------------
新增项目工程 HPSocketLIB 和 HPSocketLIB4C 用于编译 HPSocket 和 HPSocket4C 静态库
静态库与动态库的使用方式一致(请参考示例 Demo:TestEcho-SSL-4C 和 TestEcho-SSL-PFM)
使用 HPSocket 或 HPSocket4C 静态库时,需要在工程属性中定义预处理宏 -> HPSOCKET_STATIC_LIB
静态库目标文件不包含在发布包中(因为太大),如果需要请自行编译
*** v3.4.4更新 ***
> 增加 Tcp Pack 系列通信组件:
-----------------
Tcp Pack 系列组件保证每个 OnReceive 事件都向应用程序提供一个完整数据包
Tcp Pack 系列组件是 PUSH/PULL 模式的结合体,应用程序不必处理分包(如:PUSH)与数据抓取(如:PULL)
Tcp Pack 系列组件提供 Get/SetMaxPackSize() 和 Get/SetPackHeaderFlag() 方法,用来设置最大包长和包头标识
CTcpPackServer 实现 ITcpServer 接口,CTcpPackAgent 实现 ITcpAgent 接口,CTcpPackClient 实现 ITcpClient 接口
> 组件接口调整:
-----------------
OnClose/OnError 合并为一个通信事件: OnClose(CONNID dwConnID, EnSocketOperation enOperation, int iErrorCode)
枚举类型 EnSocketOperation 增加一个枚举值: SO_CLOSE = 5,标识关闭 Socket 操作
IServer 和 IAgent 接口删除接口方法: Get/SetRecvPolicy()
IServer 和 IAgent 接口删除接口方法: Get/SetMaxShutdownWaitTime()
> Bug 修复:
-----------------
修复 TCP Pack Agent “异步连接失败导致程序崩溃” Bug
修复 vc-common-src 公共代码包的 CCASQueue 可能导致无限循环 Bug