Hp-Socket For E 5.2.1 Beta3 高性能TCP/UDP通信组件 源码+模块+例程

HP-Socket 是一套通用的高性能 TCP/UDP/HTTP 通信框架，包含服务端组件、客户Duan组件和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 官方网站：http://www.jessma.org
HP-Socket 项目主页：http://www.oschina.net/p/hp-socket
HP-Socket 开发文档：http://www.oschina.net/p/hp-socket/doc

[9:56 2017/12/26]
==========================================================================================
v5.2.1 更新：
==========================================================================================

> 发布文件调整：
-----------------
1、发布文件不再区分非 SSL DLL 和 SSL DLL，统一为 HPSocket DLL 和 HPSocket4C DLL
2、发布文件默认包含 SSL 和 HTTP 组件
3、如果想去除 SSL 或 HTTP 组件，可以分别定义 _SSL_DISABLED 或 _HTTP_DISABLED 宏重新编译

> 升级说明：
-----------------
1、HP-Socket v5.2.1 完全兼容 HP-Socket v5.1.1 版本，可以直接替换升级

> 模块说明：
-----------------
1、修改调用DLL名称
2、重新编译demo
无其它修改

[16:50 2017/11/20]
> 模块修复：
-----------------
1、修改模块部分参数为可选。
2、升级iwinhttp demo 为最新模块
3、修复模块iwinhttp组件参数无返回问题
4、升级dll为beta4

[9:51 2017/11/13]
==========================================================================================
v5.1.1 更新：
==========================================================================================

> 增加暂停接收功能：
-----------------
1、所有 Server/Agent/Client 组件增加‘暂停接收数据’功能（UDP Server 组件除外）
2、API 更新：
	1） HP_Server_PauseReceive			(增加)
	2） HP_Server_IsPauseReceive		(增加)
	3） HP_Agent_PauseReceive			(增加)
	4） HP_Agent_IsPauseReceive			(增加)
	5） HP_Client_PauseReceive			(增加)
	6） HP_Client_IsPauseReceive		(增加)

> 其它更新：
-----------------
1、TCP Agent 增加方法 HP_Agent_ConnectWithExtra()，支持在连接完成前绑定附加数据
2、公共代码包 vc-common-src 版本升级到 v2.3.22
3、OpenSSL 版本升级到 1.1.0g

> 模块修复：
-----------------
1、修复模块在2003下取IP地址为空的问题。

[15:03 2017/9/27]
> Bug 修复：
-----------------
1、修复 server 组件 SetupSSLContext 方法最后一个参数可选的问题
2、IServer、IClient、IAgent组件下的SetupSSLContext函数修改部分参数为可空

[17:34 2017/9/26]
==========================================================================================
v5.0.2 更新：
==========================================================================================

> Bug 修复：
-----------------
1、修复 PULL/PACK 组件可能会意外崩溃 Bug
2、受影响组件：Pull Server、Pull Agent、Pack Server、Pack Agent

> 升级说明：
-----------------
1、HP-Socket v5.0.2 完全兼容 HP-Socket v5.0.1 版本，可以直接替换升级

[11:07 2017/7/17]
==========================================================================================
v5.0.1 更新：
==========================================================================================

> IPv6 支持：
-----------------
1、所有通信组件支持 IPv6
2、组件接口没有变化，组件内部通过传入的地址参数自动识别 IPv4 / IPv6
3、API 更新：
	1） enum En_HP_IPAddrType			(增加)
	2） struct HP_TIPAddr				(增加)
	3） SYS_GetIPv4InAddr				(删除)
	4） SYS_GetOptimalIPByHostName		(删除)
	5） SYS_IsIPAddress					(修改)
	6） SYS_GetIPAddress					(修改)
	7） SYS_EnumHostIPAddresses			(增加)
	8） SYS_FreeHostIPAddresses			(增加)

> SSL 通信组件：
-----------------
1、多 SSL 证书支持，每个通信组件对象可以使用不同的 SSL 证书
2、通信组件对象绑定独立的 SSL Context，取代旧版本的全局唯一 SSL Context
3、API 更新：
	1） HP_SSL_Initialize				(删除)
	2） HP_SSL_Cleanup					(删除)
	3） HP_SSL_IsValid					(删除)
	4） HP_SSLAgent_SetupSSLContext		(增加)
	5） HP_SSLClient_SetupSSLContext		(增加)
	6） HP_SSLServer_SetupSSLContext		(增加)
	7） HP_SSLServer_AddSSLContext		(增加)
	8） HP_SSLAgent_CleanupSSLContext	(增加)
	9） HP_SSLClient_CleanupSSLContext	(增加)
	10） HP_SSLServer_CleanupSSLContext	(增加)

> 其它更新：
-----------------
1、Demo 更新：所有 Demo 支持 IPv6；所有 SSL Demo 支持新的证书机制

> 升级说明：
-----------------
1、SSL 组件：需要调整 SSL Context 初始化方式
2、其他组件：HP-Socket v5.0.1 完全兼容 HP-Socket v4.x.x 版本，可以直接替换升级

> 模块更新：
-----------------
1、增加函数：
	_HP_EnumHostIPAddresse()           /* 枚举主机 IP 地址 */
	_HP_IsIPAddress(）                 /* 检查字符串是否符合 IP 地址格式 */
	_HP_SSL_RemoveThreadLocalState()   名称：清理线程局部环境 SSL 资源 

2、Server类组件增加函数：
	SetupSSLContext()    初始化通信组件 SSL 环境参数
	AddSSLContext()      增加 SNI 主机证书
	CleanupSSLContext()  清理通信组件 SSL 运行环境

3、Agent类组件增加函数：
	SetupSSLContext()    初始化通信组件 SSL 环境参数
	CleanupSSLContext()  清理通信组件 SSL 运行环境

3、Client类组件增加函数：
	SetupSSLContext()    初始化通信组件 SSL 环境参数
	CleanupSSLContext()  清理通信组件 SSL 运行环境

[17:40 2017/4/12]
常规更新

[13:43 2017/4/7]

> HTTP Cookie 管理：
-----------------
1、新增 Cookie 管理器，可在不同连接、不同组件对象间共享 Cookie
2、Cookie 管理器实现了标准 HTTP Cookie 功能，支持 Max-Age、expires、httpOnly、secure
3、Cookie 管理器支持 Cookie 序列化与反序列化
4、IHttpClient 和 IHttpAgent 组件可通过 SetUseCookie() 方法设置是否开启 Cookie 功能

> 升级说明：
-----------------
1、HP-Socket v4.2.1 完全兼容 HP-Socket v4.1.4 版本，可以直接替换升级

# ======================================== #
HP-Socket v4.2.1 API 更新列表：
# ======================================== #
--------------------
1、TCP:
--------------------
HP_Server_IsSecure		(增加)
HP_Agent_IsSecure		(增加)
HP_Client_IsSecure		(增加)

--------------------
2、HTTP Sync Client:
--------------------
Create_HP_HttpSyncClient		(修改：增加可选参数 pListener，如果 pListener 非空则可以监听 HttpSyncClient 的通信事件)
Create_HP_HttpsSyncClient		(修改：增加可选参数 pListener，如果 pListener 非空则可以监听 HttpSyncClient 的通信事件)

--------------------
3、HTTP Client:
--------------------
HP_HttpClient_SetUseCookie		(增加)
HP_HttpClient_IsUseCookie		(增加)
HP_HttpClient_AddCookie			(删除)
HP_HttpClient_DeleteCookie		(删除)
HP_HttpClient_DeleteAllCookies	(删除)

--------------------
4、HTTP Agent:
--------------------
HP_HttpAgent_SetUseCookie		(增加)
HP_HttpAgent_IsUseCookie		(增加)
HP_HttpAgent_AddCookie			(删除)
HP_HttpAgent_DeleteCookie		(删除)
HP_HttpAgent_DeleteAllCookies	(删除)

--------------------
5、Cookie Management:
--------------------
HP_HttpCookie_MGR_LoadFromFile				(增加)
HP_HttpCookie_MGR_SaveToFile				(增加)
HP_HttpCookie_MGR_ClearCookies				(增加)
HP_HttpCookie_MGR_RemoveExpiredCookies		(增加)
HP_HttpCookie_MGR_SetCookie					(增加)
HP_HttpCookie_MGR_DeleteCookie				(增加)
HP_HttpCookie_MGR_SetEnableThirdPartyCookie	(增加)
HP_HttpCookie_MGR_IsEnableThirdPartyCookie	(增加)
HP_HttpCookie_HLP_ParseExpires				(增加)
HP_HttpCookie_HLP_MakeExpiresStr			(增加)
HP_HttpCookie_HLP_ToString					(增加)
HP_HttpCookie_HLP_CurrentUTCTime			(增加)
HP_HttpCookie_HLP_MaxAgeToExpires			(增加)
HP_HttpCookie_HLP_ExpiresToMaxAge			(增加)

增加httpCookie DEMO
由于httpCookie在httpclient和httpagent中使用，然而我并没有写这两个组件的demo，所以就先将就着httpCookie的用吧

[13:19 2017/3/22]

> HTTP Sync Client 通信组件：
-----------------
1、Create_HP_HttpSyncClient 和 Create_HP_HttpsSyncClient 方法增加可选参数 pListener
2、如果 pListener 非空则可以通过 pListener 监听 HttpSyncClient 的所有通信事件

> 其它更新：
-----------------
1、Demo 更新：HttpProxy，TestEcho-Http (SyncClient)，TestEcho-Http-4C (SyncClient)
2、OpenSSL 版本升级到 1.1.0e
3、IWinHttp 增加httpclient的所有事件回调接口，可以实现上传和下载的进度显示。

> 升级说明：
-----------------
1、HTTP Sync Client 组件：需要调整 Create_HP_HttpSyncClient 和 Create_HP_HttpsSyncClient 的调用参数
2、其他组件：HP-Socket v4.1.4 完全兼容 HP-Socket v4.1.3 版本，可以直接替换升级

[16:26 2017/1/20]
1、IWinhttp增加 ResponseText 方法，参数为是否utf8解码

[11:39 2017/1/19]
1、模块更新，修复取连接IP地址和端口时，IP地址取不出来的问题。
2、增加了udp的demo
3、http大文件发送效率更高，本机测试最高能到110M/s，实际因为检测缓冲区大小造成性能损失可能只有95-100m/s。
4、更新为最新版4.1.3 dll

[11:15 2017/1/16]
1、模块更新，修复server和agent 调用 GetAllConnectionIDs 错误问题，删除最后一个参数

可直接替换更新现有4.1.2及以上版本

[16:29 2017/1/12]
1、更新为最新版4.1.3
2、修正IWinHttp为调用open的时候创建对象
==========================================================================================
v4.1.3 更新：
==========================================================================================

> 代码调整：
-----------------
1、ITcpServer 和 ITcpAgent 组件在 SP_DIRECT 发送模式下，监听器的 OnReceive 事件内部可能触发 Onclose 事件，改为顺序触发
2、IClient 组件优化，提高稳定性

> 升级说明：
-----------------
1、HP-Socket v4.1.3 完全兼容 HP-Socket v4.1.2 版本，可以直接替换升级

[16:57 2016/12/28]
1、解决URL编码错误问题
2、增加几个API封装命令：
   _HP_Compress: 普通压缩
   _HP_Uncompress: 普通解压
   _HP_CompressEx: 高级压缩
   _HP_UncompressEx: 高级解压
   _HP_GZipCompress: Gzip 压缩
   _HP_GZipUncompress: Gzip 解压
   GetHttpDefaultStatusCodeDesc: 获取HTTP状态码文本描述

3、各个组件的send方法改为指针+长度方式，新曾SendBytes来发送字节集数据
4、dll更换为4.1.2-rc2，直接替换，完美兼容