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

　　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 组件增加“静默连接处理”相关方法：

C/C++ code

?

1 2 3 4

1) DisconnectSilenceConnections()： // 断开超过指定时长的静默连接   2) GetSilencePeriod()： // 获取某个连接静默时间（毫秒）   3) SetMarkSilence()： // 设置是否标记静默时间   4) IsMarkSilence()： // 检测是否标记静默时间

> 增加 UdpCast 通信组件：
-----------------
  1、UdpClient / UdpServer 用于 C/S 模式的点对点单播通信，但在某些应用场景下，需要用到组播或广播通信
  2、UdpCast 实现了组播或广播通信，UdpCast 提供 IUdpCast 接口，该接口继承自 IClient，有以下接口方法： 

C/C++ code

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14

/* 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