forked from ldcsaa/HP-Socket
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathChange-Log.txt
1418 lines (1165 loc) · 53.3 KB
/
Change-Log.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
==========================================================================================
v5.9.1 更新：
==========================================================================================
> 主要更新：
-----------------
1、更新流式压缩/解压相关的若干 API，支持分段压缩/解压（参考：Change-APIs.txt）
2、更新 SSL 模块，支持 OpenSSL 3.0
> 第三方库更新：
-----------------
1、llhttp 升级到 8.1.0 版本
2、zlib 升级到 1.2.13 版本
3、openssl 升级到 1.1.1s 版本
4、mimalloc 升级到 1.7.9 版本
5、jemalloc 升级到 5.3.0 版本
> 升级说明：
-----------------
1、除了流式压缩/解压相关的若干 API 外，HP-Socket v5.9.1 兼容 HP-Socket v5.8.8 版本，如果没有用到流式压缩/解压 API 可以直接替换升级
==========================================================================================
v5.8.8 更新：
==========================================================================================
> 主要更新：
-----------------
1、Client/Agent 连接服务端时支持指定主机名称，格式：<hostaddress>[^<hostname>]，其中 ^<hostname> 可选。应用场景之一：通过代理服务器向目标服务器传递 SSL SNI hostname
2、增加字符编码转换系列函数（参考：Change-APIs.txt），支持指定源字符串长度
3、修复 SSL Pull/Pack Server/Agent 组件在手工启动SSL（SetSSLAutoStart(FALSE)）场景下的异常问题
> 第三方库更新：
-----------------
1、zlib 升级到 1.2.12 版本
2、openssl 升级到 1.1.1n 版本
> 升级说明：
-----------------
1、HP-Socket v5.8.8 完全兼容 HP-Socket v5.8.7 版本，可以直接替换升级
==========================================================================================
v5.8.7 更新：
==========================================================================================
> 主要更新：
-----------------
1、优化垃圾对象回收检测机制，提高通信组件在高负载、高并发场景的健壮性
2、支持 VS 2022 开发环境
> 第三方库更新：
-----------------
1、mimalloc 升级到 1.7.5 版本
> 升级说明：
-----------------
1、HP-Socket v5.8.7 完全兼容 HP-Socket v5.8.6 版本，可以直接替换升级
==========================================================================================
v5.8.6 更新：
==========================================================================================
> 主要更新：
-----------------
1、增加 ZLib/GZip、Brotil 流式压缩/解压组件：IHPCompressor 和 IHPDecompressor
2、优化垃圾对象回收检测机制，提高通信组件在高负载、高并发场景的健壮性
> 第三方库更新：
-----------------
1、openssl 升级到 1.1.1m 版本
2、llhttp 升级到 6.0.6 版本
3、mimalloc 升级到 1.7.3 版本
> 升级说明：
-----------------
1、HP-Socket v5.8.6 完全兼容 HP-Socket v5.8.5 版本，可以直接替换升级
==========================================================================================
v5.8.5 更新：
==========================================================================================
> 主要更新：
-----------------
1、增加线程池监听器接口 IHPThreadPoolListener，监听线程池生命周期事件
2、消除隐患：Client 系列组件用作函数局部变量时，如果使用不当可能会在销毁 Client 对象时崩溃
3、支持通过指定平台工具集编译
4、增加 MSBuild 一键编译脚本
5、代码优化，提高代码健壮性
> 第三方库更新：
-----------------
1、openssl 升级到 1.1.1l 版本
2、llhttp 升级到 6.0.5 版本
> 升级说明：
-----------------
1、HP-Socket v5.8.5 完全兼容 HP-Socket v5.8.4 版本，可以直接替换升级
==========================================================================================
v5.8.4 更新：
==========================================================================================
> 主要更新：
-----------------
1、增加全局函数：SYS_Calloc()、SYS_Alloca()
2、TCP 系列组件增加接口方法：SetNoDelay()、IsNoDelay()
> 第三方库更新：
-----------------
1、mimalloc 升级到 1.7.2 版本
2、llhttp 升级到 6.0.4 版本
> 升级说明：
-----------------
1、HP-Socket v5.8.4 完全兼容 HP-Socket v5.8.3 版本，可以直接替换升级
==========================================================================================
v5.8.3 更新：
==========================================================================================
> 主要更新：
-----------------
1、Bug 修复：ARQ UDP 组件发送数据时可能发生死锁
> 第三方库更新：
-----------------
1、mimalloc 升级到 1.7.1 版本
2、llhttp 升级到 6.0.2 版本
3、OpenSSL 升级到 1.1.1k 版本
> 升级说明：
-----------------
1、HP-Socket v5.8.3 完全兼容 HP-Socket v5.8.2 版本，可以直接替换升级
==========================================================================================
v5.8.2 更新：
==========================================================================================
> 第三方库更新：
-----------------
1、mimalloc 升级到 1.7.0 版本
2、llhttp 升级到 4.0.0 版本
3、OpenSSL 升级到 1.1.1j 版本
> 升级说明：
-----------------
1、HP-Socket v5.8.2 完全兼容 HP-Socket v5.8.1 版本，可以直接替换升级
==========================================================================================
v5.8.1 更新：
==========================================================================================
> 第三方库更新：
-----------------
1、HTTP 解析器：llhttp 取代 http_parser
2、内存分配器：mimalloc 取代 jemalloc
3、OpenSSL 升级到 1.1.1i 版本
> 其他更新：
-----------------
1、库公开头文件移到 include/hpsocket 目录
2、Windows目录结构调整：Common/Src 改为 Src/Common，Common/Lib 改为 Dependent
> 升级说明：
-----------------
1、HP-Socket v5.8.1 完全兼容 HP-Socket v5.7.3 版本，可以直接替换升级
==========================================================================================
v5.7.3 更新：
==========================================================================================
> 常规更新：
-----------------
1、增加 Brotli 压缩/解压支持，（提供 _BROTLI_DISABLED 预编译宏用于关闭 Brotli 库功能）
2、OpenSSL 升级到 1.1.1h 版本
> 升级说明：
-----------------
1、HP-Socket v5.7.3 完全兼容 HP-Socket v5.7.2 版本，可以直接替换升级
==========================================================================================
v5.7.2 更新：
==========================================================================================
> 常规更新：
-----------------
1、代码优化，提高稳定性
2、OpenSSL 升级到 1.1.1g 版本
3、http-parser 升级到 2.9.4 版本
4、kcp 升级到 1.6 版本
> 升级说明：
-----------------
1、HP-Socket v5.7.2 完全兼容 HP-Socket v5.7.1 版本，可以直接替换升级
==========================================================================================
v5.7.1 更新：
==========================================================================================
> UDP 组件更新：
-----------------
1、增加新组件：UDP Node
1) UDP Node 没有“连接”的概念，可以与任意地址相互收发数据
2) UDP Node 支持三种运行模式：单播、组播和广播
3) 增加 UDP Node 组件示例 Demo ‘TestUDPNode’
> 其它更新：
-----------------
1、所有组件增加 Wait() 方法，用于等待组件关闭
2、所有通信组件增加 SetReuseAddressPolicy() 方法，支持设置地址重用策略
3、所有 SSL 通信组件增加 SetSSLCipherList() 方法，支持设置 SSL 加密套件
4、大量 API 更新，代码重构、优化
> 升级说明：
-----------------
1、HP-Socket v5.7.1 改动或删除了一些旧版本的 API，升级时请参考 Chang-APIs.txt
==========================================================================================
v5.6.4 更新：
==========================================================================================
> 常规更新：
-----------------
1、代码优化，提高稳定性
> 升级说明：
-----------------
1、HP-Socket v5.6.4 完全兼容 HP-Socket v5.6.3 版本，可以直接替换升级
==========================================================================================
v5.6.3 更新：
==========================================================================================
> 常规更新：
-----------------
1、代码优化，提高稳定性
> 升级说明：
-----------------
1、HP-Socket v5.6.3 完全兼容 HP-Socket v5.6.2 版本，可以直接替换升级
==========================================================================================
v5.6.2 更新：
==========================================================================================
> 常规更新：
-----------------
1、代码优化，提高稳定性
2、修复 v5.6.1 版本中 SSL 组件对 Windows XP 系统不兼容的问题
> 升级说明：
-----------------
1、HP-Socket v5.6.2 完全兼容 HP-Socket v5.6.1 版本，可以直接替换升级
==========================================================================================
v5.6.1 更新：
==========================================================================================
> SSL 组件更新：
-----------------
1、所有 SSL 组件增加以下接口方法支持加载内存证书
1) Server：SetupSSLContextByMemory(), AddSSLContextByMemory()
2) Agent：SetupSSLContextByMemory()
3) Client：SetupSSLContextByMemory()
2、所有 SSL 组件增加 GetSSLSessionInfo() 方法，用来获取 SSL 会话相关信息
3、SSL Server 组件提供默认的 SNI 服务器域名绑定机制，大多数情形下应用程序不必自定义 SNI 回调函数
1) 当 SetupSSLContext() 的 'fnServerNameCallback' 参数值为 nullptr 则启用默认的服务器域名绑定机制
2) BindSSLServerName()：绑定服务器域名到指定证书
3) HP_SSL_DefaultServerNameCallback()：默认 SNI 回调函数
> HTTP 组件更新：
-----------------
1、HTTP Server 组件的 SendWSMessage() 方法删除 lpszMask 参数
2、所有 HTTP 组件的 SendWSMessage() 方法的 pData 参数类型改为 const BYTE*，因此可以传入常量
3、所有 HTTP 组件添加 SendChunkData() 方法以方便地发送 Chunked 数据
> UDP 组件更新：
-----------------
1、优化 Linux 平台的 UDP Cast 组件，使得其与 Windows 平台的 UDP Cast 组件保持行为一致
2、提升所有 UDP 组件的 IPv6 兼容性
3、UDP Client/Server 组件关闭时自动向对端发送“关闭通知”数据报
> 其他更新：
-----------------
1、jemalloc 升级到 5.2.1 版本
2、OpenSSL 升级到 1.1.1d 版本
3、代码优化，提高稳定性
> 升级说明：
-----------------
1、HP-Socket v5.6.1 基本兼容 HP-Socket v5.5.3 版本（HTTP 组件的 SendWSMessage() 方法除外）
==========================================================================================
v5.5.3 更新：
==========================================================================================
> 常规更新：
-----------------
1、代码优化，提高稳定性
2、OpenSSL 升级到 1.1.0k 版本
> 升级说明：
-----------------
1、HP-Socket v5.5.3 完全兼容 HP-Socket v5.5.2 版本，可以直接替换升级
==========================================================================================
v5.5.2 更新：
==========================================================================================
> UDP 更新：
-----------------
1、放宽 UDP 组件的最大报文长度限制，SetMaxDatagramSize() 方法的最大值可以设置到 64KB
2、放宽 ARQ UDP 组件的最大传输单元长度限制，SetMaxTransUnit() 方法的最大值可以设置到 64KB
> 其他更新：
-----------------
1、完善 Delphi SDK 及其示例 Demo
> 升级说明：
-----------------
1、HP-Socket v5.5.2 完全兼容 HP-Socket v5.5.1 版本，可以直接替换升级
==========================================================================================
v5.5.1 更新：
==========================================================================================
> UDP 更新：
-----------------
1、增加 ARQ UDP 组件：IUdpArqServer、IUdpArqClient
2、增加 ARQ UDP 示例 TestEcho-ARQ 和性能测试示例 TestEcho-ARQ-PFM
3、ARQ UDP 组件详细说明请参考开发文档 《HP-Socket Development Guide》
4、优化 IUdpServer 组件，修复潜在缺陷
5、C# SDK 增加 UDP 组件封装类
> 其他更新：
-----------------
1、jemalloc 升级到 5.2.0 版本
2、http-parser 升级到 2.9.2 版本
> 升级说明：
-----------------
1、HP-Socket v5.5.1 完全兼容 HP-Socket v5.4.4 版本，可以直接替换升级
==========================================================================================
v5.4.4 更新：
==========================================================================================
> TCP 组件更新：
-----------------
1、IAgent 组件支持在连接服务器时指定本地IP地址和（或）本地端口
> 其他更新：
-----------------
1、代码优化
2、http-parser 升级到 2.9.0 版本
3、OpenSSL 升级到 1.1.0j 版本
4、提供 _UDP_DISABLED 预编译宏用于移除 UDP 组件
> 升级说明：
-----------------
1、HP-Socket v5.4.4 完全兼容 HP-Socket v5.4.3 版本，可以直接替换升级
==========================================================================================
v5.4.3 更新：
==========================================================================================
> HTTP 组件更新：
-----------------
1、HTTP 组件可以手工启动 HTTP 通信，从而可以对 HTTP 通信执行 SOCKS 代理服务器设置等前置操作
2、HTTP 组件（Server/Agent/Client）增加以下接口方法支持手工启动 HTTP 通信
1) StartHttp()：手工启动 HTTP 通信，当通信组件设置为非自动启动时，需要调用本方法启动 HTTP 通信
2) SetHttpAutoStart()：设置 HTTP 通信启动方式（默认：TRUE，自动启动）
3) IsHttpAutoStart()：获取 HTTP 通信启动方式
> 其他更新：
-----------------
1、Bug 修复：UDP Server 在高并发场景下可能重复触发 OnAccept 事件
> 升级说明：
-----------------
1、HP-Socket v5.4.3 完全兼容 HP-Socket v5.4.2 版本，可以直接替换升级
==========================================================================================
v5.4.2 更新：
==========================================================================================
> SSL 组件更新：
-----------------
1、SSL 组件可以手工启动 SSL 握手，从而可以对 SSL/Https 通信执行代理服务器设置等前置操作
2、SSL 组件（Server/Agent/Client）增加以下接口方法支持手工启动 SSL 握手
1) StartSSLHandShake()：手工启动 SSL 握手，当通信组件设置为非自动握手时，需要调用本方法启动 SSL 握手
2) SetSSLAutoHandShake()：设置通信组件握手方式（默认：TRUE，自动握手）
3) IsSSLAutoHandShake()：获取通信组件握手方式
> 其他更新：
-----------------
1、所有可能导致 Socket 关闭的组件接口方法都在 Socket 通信线程中异步触发 OnClose 事件
2、Server 与 Agent 组件的 DIRECT 发送策略也支持通过 GetPendingDataLength() 方法实现流控
3、Server 与 Agent 组件的 Disconnect() 方法不再支持‘非强制断开’（仍然保留bForce 参数），调用时都会强制断开
4、OnSend 事件支持 三种同步策略
1) OSSP_NONE：不同步（默认）
2) OSSP_CLOSE：同步 OnClose
3) OSSP_RECEIVE：同步 OnClose 和 OnReceive（只用于 TCP 组件）
5、OpenSSL 升级到 1.1.0i 版本
> 升级说明：
-----------------
1、HP-Socket v5.4.2 完全兼容 HP-Socket v5.4.1 版本，可以直接替换升级
==========================================================================================
v5.4.1 更新：
==========================================================================================
> 加入线程池公共组件：
-----------------
1、加入 IHPThreadPool 线程池公共组件
2、IHPThreadPool 主要方法：
1) Start：启动线程池
2) Stop：关闭线程池
3) Submit：提交任务
4) AdjustThreadCount：调整线程池大小
> 接口更新：
-----------------
1、IAgent 接口的 Connect() 方法增加参数 usLocalPort，连接时可绑定本地端口
2、IClient 接口的 Start() 方法增加参数 usLocalPort，连接时可绑定本地端口
3、IClient/IAgent/IServer 接口增加方法 IsConnected()，检测是否有效连接
> 其他更新：
-----------------
1、修复已知问题
2、性能优化
> 升级说明：
-----------------
1、HP-Socket v5.4.1 完全兼容 HP-Socket v5.3.2 版本，可以直接替换升级
==========================================================================================
v5.3.2 更新：
==========================================================================================
> 常规更新：
-----------------
1、更新版本号，保持与 Linux 版的版本号同步
> 升级说明：
-----------------
1、HP-Socket v5.3.2 完全兼容 HP-Socket v5.3.1 版本，可以直接替换升级
==========================================================================================
v5.3.1 更新：
==========================================================================================
> 常规更新：
-----------------
1、修复 C# SDK 关于 SSL 初始化失败 Bug
2、http-parser 升级到 2.8.1 版本
3、OpenSSL 升级到 1.1.0h 版本
4、提供 _ZLIB_DISABLED 预编译宏用于关闭 zlib 库功能
> 升级说明：
-----------------
1、HP-Socket v5.3.1 完全兼容 HP-Socket v5.2.1 版本，可以直接替换升级
==========================================================================================
v5.2.1 更新：
==========================================================================================
> 发布包调整：
-----------------
1、版本号修订：Windows 和 Linux 发行版使用统一版本号
2、发布文件不再区分非 SSL DLL 和 SSL DLL，统一为 HPSocket DLL 和 HPSocket4C DLL
3、发布文件默认包含 SSL 和 HTTP 组件
4、如果想移除 SSL 或 HTTP 组件，可以分别定义 _SSL_DISABLED 或 _HTTP_DISABLED 宏重新编译
> 其他更新：
-----------------
1、代码优化和已知 Bug 修复
> 升级说明：
-----------------
1、HP-Socket v5.2.1 完全兼容 HP-Socket v5.1.1 版本，可以直接替换升级
==========================================================================================
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、HP-Socket v5.1.1 完全兼容 HP-Socket v5.0.2 版本，可以直接替换升级
==========================================================================================
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 版本，可以直接替换升级
==========================================================================================
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 支持新的证书机制
2、公共代码包 vc-common-src 升级到 v2.3.20
> 升级说明：
-----------------
1、SSL 组件：需要调整 SSL Context 初始化方式
2、其他组件：HP-Socket v5.0.1 完全兼容 HP-Socket v4.x.x 版本，可以直接替换升级
==========================================================================================
v4.3.1 更新：
==========================================================================================
> HTTP：
-----------------
1、IHttpClient 和 IHttpAgent 组件兼容没有长度标识（如：Content-Length Header）的 HTTP 响应报文
2、IHttpClient 和 IHttpAgent 组件改进 HEAD 请求的响应处理方式，应用程序无需在 OnHeadersComplete 事件中返回特殊值 HPR_SKIP_BODY
> 其它更新：
-----------------
1、公共代码包 vc-common-src 升级到 v2.3.19
2、OpenSSL 升级到 1.1.0f
3、优化 IServer/IAgent 组件，提升性能和稳定性
> 升级说明：
-----------------
1、HP-Socket v4.3.1 完全兼容 HP-Socket v4.2.1 版本，可以直接替换升级
==========================================================================================
v4.2.1 更新：
==========================================================================================
> HTTP Cookie 管理：
-----------------
1、新增 Cookie 管理器，可在不同连接、不同组件对象间共享 Cookie
2、Cookie 管理器实现了标准 HTTP Cookie 功能，支持 Max-Age、expires、httpOnly、secure
3、Cookie 管理器支持 Cookie 序列化与反序列化
4、IHttpClient 和 IHttpAgent 组件可通过 SetUseCookie() 方法设置是否开启 Cookie 功能
> HTTP Sync Client 通信组件：
-----------------
1、Create_HP_HttpSyncClient 和 Create_HP_HttpsSyncClient 方法增加可选参数 pListener
2、如果 pListener 非空则可以通过 pListener 监听 HttpSyncClient 的所有通信事件
> 其它更新：
-----------------
1、Demo 更新：HttpProxy，TestEcho-Http，TestEcho-Http-4C
2、公共代码包 vc-common-src 升级到 v2.3.18
3、OpenSSL 升级到 1.1.0e
> 升级说明：
-----------------
1、HTTP Sync Client 组件：需要调整 Create_HP_HttpSyncClient 和 Create_HP_HttpsSyncClient 的调用参数
2、其他组件：HP-Socket v4.2.1 完全兼容 HP-Socket v4.1.x 版本，可以直接替换升级
==========================================================================================
v4.1.3 更新：
==========================================================================================
> 代码调整：
-----------------
1、修正 ITcpServer 和 ITcpAgent 组件的 Onclose 事件在 SP_DIRECT 发送模式下的触发规则
2、IClient 组件优化，提高稳定性
> 升级说明：
-----------------
1、HP-Socket v4.1.3 完全兼容 HP-Socket v4.1.2 版本，可以直接替换升级
==========================================================================================
v4.1.2 更新：
==========================================================================================
> 代码调整：
-----------------
1、采用新环形缓冲区算法提高异步操作安全性
2、采用延时释放策略提高 HTTP 异步操作安全性
> 升级说明：
-----------------
1、HP-Socket v4.1.2 完全兼容 HP-Socket v4.1.1 版本，可以直接替换升级
==========================================================================================
v4.1.1 更新：
==========================================================================================
> WebSocket 支持：
-----------------
1、所有 HTTP 组件增加 WebSocket 方法：
1) SendWSMessage(): 发送 WebSocket 数据包
2） GetWSMessageState(): 获取当前 WebSocket 状态
2、所有 HTTP 组件监听器增加 WebSocket 事件：
1) OnWSMessageHeader(): WebSocket 数据包头通知
2) OnWSMessageBody(): WebSocket 数据包体通知
3) OnWSMessageComplete(): WebSocket 数据包完成通知
3、示例 Demo TestEcho-Http 和 TestEcho-Http-4C 支持 WebSocket
> 增加 HTTP Sync Client 通信组件：
-----------------
1、HTTP Sync Client 实现同步 HTTP 通信，不需要事件监听器
2、HTTP Sync Client 组件类： CHttpSyncClient、CHttpsSyncClient
3、HTTP Sync Client 实现接口： ITcpClient / IHttpSyncRequester
4、示例 Demo TestEcho-Http 和 TestEcho-Http-4C 提供 HTTP Sync Client 示例
> 升级说明：
-----------------
1、HP-Socket v4.1.1 完全兼容 HP-Socket v4.0.1 版本，可以直接替换升级
==========================================================================================
v4.0.1 更新：
==========================================================================================
> 增加 HTTP 系列通信组件：
-----------------
1、新增 HTTP Server 组件：
1) 组件类： CHttpServer、CHttpsServer
2) 实现接口： ITcpServer / IComplexHttpResponder
3) 监听器接口： IHttpServerListener
2、新增 HTTP Agent 组件：
1) 组件类： CHttpAgent、CHttpsAgent
2) 实现接口： ITcpAgent / IComplexHttpRequester
3) 监听器接口： IHttpAgentListener
3、新增 HTTP Client 组件：
1) 组件类： CHttpClient、CHttpsClient
2) 实现接口： ITcpClient / IHttpRequester
3) 监听器接口： IHttpClientListener
4、新增 HTTP 示例 Demo：
1) TestEcho-Http （源代码）
2) TestEcho-Http-4C （4C LIB / 4C DLL）
5、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 : 终止解析，断开连接
> 组件接口调整：
-----------------
1、IServer 和 IAgent 组件的所有监听器回调方法增加‘事件源’参数，如：OnShutdown() -> OnShutdown(T* pSender)
2、IClient 组件的所有监听器回调方法增加‘连接ID’参数，如：OnHandShake(IClient* pClient) -> OnHandShake(T* pSender, CONNID dwConnID)
3、IServer 和 IAgent 接口增加接口方法： Get/SetMaxConnectionCount() 用于设置最大连接数，最大连接数默认：10000
4、OnHandShake() 事件触发规则调整：非 SSL 组件在 OnConnect() 事件后也触发 OnHandShake() 事件，使 SSL 组件和 SSL 组件处理流程一致
5、HPSocket4C 增加 PACK 组件监听器的创建、销毁方法，新版本必须使用下列方法创建、销毁 PACK 组件监听器：
1) Create_HP_TcpPackServerListener / Destroy_HP_TcpPackServerListener
2) Create_HP_TcpPackAgentListener / Destroy_HP_TcpPackAgentListener
3) Create_HP_TcpPackClientListener / Destroy_HP_TcpPackClientListener
6、SSL 组件支持 SNI：
1) SSL 初始化方法 HP_SSL_Initialize()，增加 SNI 回调函数指针参数
2) 新增方法 HP_SSL_AddServerContext()，用于 加载 SNI 主机证书
> 其他更新：
-----------------
1、IServer 和 IAgent 组件采用 Ring Pool 取代 R/W Lock + Map 维护活动连接，提升读写和并发性能
2、更新所有 Demo 示例代码
> 升级说明：
-----------------
1、HP-Socket v4.0.1 与 HP-Socket v3.5.4 接口不兼容
2、IServer、IAgent 和 IClient 的所有监听器回调方法参数都有变化
3、注意：HPSocket4C 用新方法创建和销毁 PACK 组件监听器
4、注意：IServer 和 IAgent 应用程序需要根据实际使用场景设置最大连接数
==========================================================================================
v3.5.4 更新：
==========================================================================================
> Bug 修复：
-----------------
1、修复 IClient 组件在连接发送数据时连接被断开可能导致程序崩溃 Bug
2、优化 vc-common-src 公共代码包的 CCASQueue
> 升级说明：
-----------------
1、HP-Socket v3.5.4 完全兼容 HP-Socket v3.5.3 版本，可以直接替换升级
==========================================================================================
v3.5.3 更新：
==========================================================================================
> Bug 修复：
-----------------
1、修复 IClient 组件在极端情况下触发两次 OnClose() 事件 Bug
2、修复 IClient 组件在极端情况下销毁 IClient 对象导致程序崩溃 Bug
> 升级说明：
-----------------
1、HP-Socket v3.5.3 完全兼容 HP-Socket v3.5.2 版本，可以直接替换升级
==========================================================================================
v3.5.2 更新：
==========================================================================================
> 组件接口调整：
-----------------
1、IClient 组件 Start() 方法默认连接方式改为异步连接
2、IClient 组件 Start() 方法增加可选参数 lpszBindAddress，设置绑定地址
3、HP-Socket 4C 增加导出方法 HP_Client_StartWithBindAddress() 方法，可设置绑定地址
4、IUdpCast 组件删除接口方法 Get/SetBindAddress()
5、IServer 接口 增加 GetLocalAddress() 方法用于获取连接的本地地址信息
6、增加全局函数 SYS_GetSocketLocalAddress() 和 SYS_GetSocketRemoteAddress() 分别用于获取 SOCKET 本地和远程地址信息
> 升级说明：
-----------------
1、HP-Socket v3.5.2 完全兼容 HP-Socket v3.5.1 版本，可以直接替换升级
==========================================================================================
v3.5.1 更新：
==========================================================================================
> 增加 SSL 系列通信组件：
-----------------
1、新增 SSL PUSH 组件：CSSLServer、CSSLAgent、CSSLClient
2、新增 SSL PULL 组件：CSSLPullServer、CSSLPullAgent、CSSLPullClient
3、新增 SSL PACK 组件：CSSLPackServer、CSSLPackAgent、CSSLPackClient
4、SSL Server 实现 ITcpServer 接口，SSL Agent 实现 ITcpAgent 接口，SSL Client 实现 ITcpClient 接口
5、启动 SSL 通信组件前需要调用 HP_SSL_Initialize() 函数初始化 SSL 全局环境参数
6、通信结束后调用 HP_SSL_Cleanup() 函数清理 SSL 全局运行环境
7、新增 SSL 相关示例 Demo：
1) TestEcho-SSL （源代码）
2) TestEcho-SSL-Pack （DLL / 4C DLL）
3) TestEcho-SSL-4C （4C LIB）
4) TestEcho-SSL-PFM （LIB）
> 组件接口调整：
-----------------
1、ITcpServerListener 接口增加 SSL 握手成功事件：OnHandShake(CONNID dwConnID)
2、ITcpAgentListener 接口增加 SSL 握手成功事件：OnHandShake(CONNID dwConnID)
3、ITcpClientListener 接口增加 SSL 握手成功事件：OnHandShake(IClient* pClient)
4、枚举类型 EnSocketError 增加‘SSL 环境未就绪’错误代码 SE_SSL_ENV_NOT_READY
5、增加枚举类型：EnSSLSessionMode（SSL 工作模式），EnSSLVerifyMode（SSL 验证模式）
6、HPSocket-SSL DLL 主要头文件：SocketInterface-SSL.h，HPSocket-SSL.h
7、HPSocket4C-SSL DLL 主要头文件：HPSocket4C-SSL.h
8、Tcp Pack 系列组件可设置的最大包长调整为 4194303/0x3FFFFF 字节
9、Tcp Pack 系列组件的有效包头标识取值范围调整为 0 ~ 1023/0x3FF
> 增加静态库工程：
-----------------
1、新增项目工程 HPSocketLIB 和 HPSocketLIB4C 用于编译 HPSocket 和 HPSocket4C 静态库
2、静态库与动态库的使用方式一致（请参考示例 Demo：TestEcho-SSL-4C 和 TestEcho-SSL-PFM）
3、使用 HPSocket 或 HPSocket4C 静态库时，需要在工程属性中定义预处理宏 -> HPSOCKET_STATIC_LIB
4、静态库目标文件不包含在发布包中（因为太大），如果需要请自行编译
> 升级说明：
-----------------
1、HP-Socket v3.5.1 的非 SSL 版本不能二进制兼容 HP-Socket v3.4.x 版本，升级需重新编译应用程序
2、TCP 组件接口增加了 OnHandShake() 事件，使用 C++ 接口的应用程序需要处理该事件，对于非 SSL 组件则可提供一个空实现
==========================================================================================
v3.4.3 更新：
==========================================================================================
> Bug 修复：
-----------------
1、修复 vc-common-src 公共代码包的 CCASQueue 可能导致无限循环 Bug
> 升级说明：
-----------------
1、HP-Socket v3.4.3 完全兼容 HP-Socket v3.4.2 版本，可以直接替换升级
==========================================================================================
v3.4.2 更新：
==========================================================================================
> Bug 修复：
-----------------
1、修复 TcpPackServer 和 TcpPackAgent 某些属性设置不生效 Bug
> 升级说明：
-----------------
1、HP-Socket v3.4.2 完全兼容 HP-Socket v3.4.1 版本，可以直接替换升级
==========================================================================================
v3.4.1 更新：
==========================================================================================
> 增加 Tcp Pack 系列通信组件：
-----------------
1、Tcp Pack 系列组件保证每个 OnReceive 事件都向应用程序提供一个完整数据包
2、Tcp Pack 系列组件是 PUSH/PULL 模式的结合体，应用程序不必处理分包（如：PUSH）与数据抓取（如：PULL）
3、Tcp Pack 系列组件提供 Get/SetMaxPackSize() 和 Get/SetPackHeaderFlag() 方法，用来设置最大包长和包头标识
2、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()
> 升级说明：
-----------------
1、HP-Socket v3.3.2 及之前版本升级到 HP-Socket v3.4.1 版本，需要修改 OnClose/OnError 事件的处理代码
==========================================================================================
v3.3.2 更新：
==========================================================================================
> 代码调整：
-----------------
1、增强编译兼容性
2、修复 C#、E 语言 SDK 的已知 Bug
> 升级说明：
-----------------
1、HP-Socket v3.3.2 完全兼容 HP-Socket v3.3.1 版本，可以直接替换升级
==========================================================================================
v3.3.1 更新：
==========================================================================================
> 组件接口调整：
-----------------
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 组件增加“静默连接处理”相关方法：
1) DisconnectSilenceConnections()：断开超过指定时长的静默连接
2) GetSilencePeriod()：获取某个连接静默时间（毫秒）
3) SetMarkSilence()：设置是否标记静默时间（设置为 TRUE 时 DisconnectSilenceConnections() 和 GetSilencePeriod() 才有效，默认：FALSE）
4) IsMarkSilence()：检测是否标记静默时间
> 增加 UdpCast 通信组件：
-----------------
1、UdpClient / UdpServer 用于 C/S 模式的点对点单播通信，但在某些应用场景下，需要用到组播或广播通信
2、UdpCast 实现了组播或广播通信，UdpCast 提供 IUdpCast 接口，该接口继承自 IClient，有以下接口方法：
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
> 升级说明：
-----------------
1、HP-Socket v3.3.1 在功能上兼容 HP-Socket v3.2.3 版本，但代码级别不完全兼容
2、HP-Socket v3.2.3 升级到 HP-Socket v3.3.1 需要注意以下调整：
1) Client 组件
a) IClientListener 监听器接口调整，所有通知方法的参数有调整
b) PULL Client 用 IPullClient 作为基接口，Fetch()/Peek()方法参数有调整
2) Agent/Server 组件
a) OnShutdown 取代 OnServerShutdown/OnAgentShutdown
==========================================================================================
v3.2.3 更新：
==========================================================================================
> common-src 优化：
-----------------
1、优化通信组件的同步机制
2、整体性能提升约 10%
> 升级说明：
-----------------
1、使用 HP-Socket v3.2.2 及以前版本的应用程序可以安全升级到 HP-Socket v3.2.3
==========================================================================================
v3.2.2 更新：
==========================================================================================
> 增加若干帮助方法：
-----------------
1、批量发送方法 SendPackets()
1) IClient / IServer / IAgent 增加批量发送方法 SendPackets(dwConnID, pBuffers[], iBufferCount)
2) 对于 TCP 组件 - 顺序发送所有数据包
3) 对于 UDP 组件 - 把所有数据包组合成一个数据包发送（数据包的总长度不能大于设置的 UDP 包最大长度）
2、小文件发送方法 SendSmallFile()
1) ITcpClient / ITcpServer / ITcpAgent 增加小文件发送方法 SendSmallFile(dwConnID, lpszFileName, pHead, pTail)
2) 通过 pHead 和 pTail 参数，可以分别在文件数据的头部和尾部加入自定义数据
3) SendSmallFile() 只能发送 4096 KB 以内大小的文件
3、HPSocket.dll 和 HPSocket4C.dll 增加以下导出方法
1) SYS_WSAGetLastError()：调用系统的 WSAGetLastError()
2) SYS_SetSocketOption()：调用系统的 setsockopt()
3) SYS_GetSocketOption()：调用系统的 getsockopt()
4) SYS_IoctlSocket() ：调用系统的 ioctlsocket()
5) SYS_WSAIoctl() ：调用系统的 WSAIoctl()
> 升级说明：
-----------------
1、使用 HP-Socket v3.2.1 及以前版本的应用程序可以安全升级到 HP-Socket v3.2.2
==========================================================================================
v3.2.1 更新：
==========================================================================================
> 增加 TcpAgent / TcpPullAgent 通信组件：
-----------------
1、对于代理服务器或中转服务器等应用场景，服务器自身也作为客户端向其它服务器发起大规模连接
2、TcpClient / TcpPullClient 基于 Event Select 通信模型，每个组件对象管理一个 Socket，并开启一个线程，不适合上述应用场景
3、TcpAgent / TcpPullAgent 基于 IOCP 通信模型，一个组件对象管理多个 Socket，适合用作代理服务器或中转服务器的客户端通信组件
4、TcpAgent / TcpPullAgent 的使用方式依然简单，提供以下接口方法：
1) 通知接口方法：
OnPrepareConnect(CONNID dwConnID, SOCKET socket)
OnConnect(CONNID dwConnID)
OnSend(CONNID dwConnID, const BYTE* pData, int iLength)
OnReceive(CONNID dwConnID, const BYTE* pData, int iLength) //（Push 模型）
OnReceive(CONNID dwConnID, int iLength) //（Pull 模型）
OnClose(CONNID dwConnID)
OnError(CONNID dwConnID, EnSocketOperation enOperation, int iErrorCode)
OnAgentShutdown()
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)
Disconnect(CONNID dwConnID, BOOL bForce = TRUE)
Fetch(CONNID dwConnID, BYTE* pData, int iLength) //（Pull 模型）
5、增加 TcpAgent / TcpPullAgent 使用示例：
1) Agent-PFM
2) Agent-Pull
3) Agent-4C
6、增加 TcpAgent + TcpServer 实现的 HTTP 代理服务器示例：HttpProxy
> 增加 HPSocket for Java SDK：
-----------------
1、提供 Java 开发包：hpsocket-3.2.1.jar（通过 JNA 实现，目前只支持 Windows 平台）