跳到主要内容
版本：3.1

历史更新

TouchSocket 框架升级/发版规则

升级前重点关注可能造成破坏性的标签类型：、、、

版本号规则：主版本号.次版本号.修订版本号

  • 只要确认为框架 bug，则当天修复，下个周日发版，修订版本号 加 1。
  • 其余情况，每年发布一个 主版本，发布时间跟随Dotnet的发布时间。

v3.1.14​

更新日期： 2025.7.20

更新描述：

  • HTTP模块性能优化和内存管理改进。

更新详情：

TouchSocket.Http​

  •   HttpResponse.GetContentAsync 方法中的内存流初始化，使用精确的内容长度预分配内存，提升性能。
  •   内存分配策略，减少不必要的内存占用。
  •   变量命名和局部变量使用，提升代码可读性。

v3.1.13​

更新日期： 2025.7.14

更新描述：

  • 修复和改进升级，提升稳定性和性能。
  • MQTT协议处理优化和错误修复。

更新详情：

TouchSocket.Mqtt​

  •   MQTT 协议名称统一为 "MQTT"（大写），修复协议标准一致性问题。
  •   MqttAdapter 中消息解析位置计算错误，修复数据包边界计算问题。
  •   VariableByteIntegerRecorder 中长度设置错误，修复变长整数记录器的边界处理。
v3.1

v3.1.12​

更新日期： 2025.7.8

更新描述：

  • 兼容性修复升级。
  • 代码质量和文档规范化改进，以及功能增强。

更新详情：

TouchSocket.Core​

  •   代码注释规范化，统一将 "null" 改为 <see langword="null"/> 的XML文档格式。
  •   EasyMemoryMarshal 类增加了更详细的文档和泛型约束。
  •   多个核心类的内存管理和线程安全性。
  •   TouchSocketBitConverter 中的异常文档注释。

TouchSocket.Mqtt​

  •   MQTT协议名称从 "MQTT" 统一为 "Mqtt"。
  •   MqttSessionActor 消息分发机制，提升性能和稳定性。
  •   ThreadSafeTopicSubscriptions 类，提供线程安全的主题订阅管理。
  •   MqttBroker 的消息转发逻辑，改进并发处理能力。
  •   MqttReceivedEventArgs 中属性命名一致性问题。

TouchSocket.SerialPorts​

  •   ISerialPortClient 和 SerialPortClient 实现 IConnectableClient 接口。
  •   ConnectAsync 方法支持异步连接操作。
  •   ISerialPortSession 接口继承关系，移除冗余接口。

TouchSocket.Modbus​

  •   IModbusRtuMaster 实现 IConnectableClient 接口。
  •   ModbusRtuMaster 增加 ConnectAsync 方法支持。

TouchSocket.WebApi​

  •   RegexRouterAttribute 类增加详细的XML文档注释。
  •   WebApiAttribute 中的路由处理逻辑和变量命名。

TouchSocket.Sockets​

  •   网络监听器和客户端基类的参数验证和错误处理。
  •   ReconnectionPlugin 的 Dispose 方法错误，修复无限循环任务的正确释放机制。(#68 by @godchadigo)

v3.1.9(10)(11)​

更新日期： 2025.6.24

更新描述：

兼容性修复升级。

更新详情：

TouchSocket.Core​

  •   Result和Result<T>在调试时的显示。
  •   IByteBlock的部分方法传参。

TouchSocket.Mqtt​

  •   IMqttTcpClient没有继承ISetupConfigObject的bug。

TouchSocket.SerialPort​

  •   StreamAsync异步流模式工作异常的bug。

TouchSocketPro.Modbus​

  •   ModbusCoilsDrive支持线圈读写。
  •   ModbusDiscreteInputsDrive支持离散输入读写。
  •   ModbusHoldingRegistersDrive支持保持寄存器读写。
  •   ModbusInputRegistersDrive支持输入寄存器读写。

TouchSocketPro.PlcBridges​

  •   PlcObject组件。

v3.1.8​

更新日期： 2025.6.15

更新描述：

兼容性修复升级。

更新详情：

TouchSocket.Core​

  •   DependencyProperty在调试时的显示。
  •   SafeDispose方法的返回，由void改为Result。此修改不影响代码编译，但是需要重新编译依赖dll。

TouchSocket.Http​

  •   当Http服务器在响应后，HttpResponse不会清空Content的bug。 #ICEVTN

TouchSocket.Modbus​

  •   IModbusResponse类新增IsSuccess属性，可用于快捷获取响应结果。
  •   IModbusResponse的Data属性由Byte[]改为ReadOnlyMemory<byte>。如果仍需使用数组，请使用Data.Span.ToArray()方法获取数据。

TouchSocket.SerialPort​

  •   StreamAsync性能异步流模式，可在SerialPortOption中直接启用。 #PR72

TouchSocketPro.PlcBridges​

  •   新组件发布。

v3.1.7​

更新日期： 2025.6.8

更新描述：

兼容性修复升级。

更新详情：

TouchSocket.Core​

  •   FileLogger在Windows服务发布时，保存路径错误的bug。

TouchSocket.Sockets​

  •   ClientFactory的MinCount失效的bug。

TouchSocket.Dmtp​

  •   FileResourceInfo类新增Create方法和Save的其他重载。更方便的支持断点续传方式。
  •   FileSectionResult类释放逻辑，减少异常的发生。

v3.1.6​

更新日期： 2025.6.2

更新描述：

兼容性修复升级。

更新详情：

TouchSocket.SerialPort​

  •   串口组件数据接收回调事件异常。#ICB8IN

v3.1.5​

更新日期： 2025.5.24

更新描述：

兼容性修复升级。

更新详情：

TouchSocket.Core​

  •   源生成器提示。

v3.1.3(4)​

更新日期： 2025.5.18

更新描述：

兼容性修复升级。

更新详情：

TouchSocket.Core​

  •   Method相关操作，具体请看新文档。

TouchSocket.Dmtp​

  •   Dmtp Channel的HoldOnAsync、CompleteAsync、CancelAsync等方法返回值改为Result，不再抛出异常。

v3.1.2​

更新日期： 2025.5.11

更新描述：

兼容性修复升级。

更新详情：

All​

  •   全系语法分析器和源生成器，使用增量源生成器，减少编译时间。

TouchSocket.Core​

  •   Logger在添加到容器时，支持直接设置日志等级。
  •   ByteBlock、ValueByteBlock在请求的length为0时，会抛出异常。 #69
  •   WaitHandlePool在waitData为null无法Destroy释放问题。#IC64WX
  •   弃用ManualContainer。

TouchSocket.Sockets​

  •   发送字符串的效率，极大减少GC的产生。
  •   UseCheckClear的使用体验，使用更为贴切的方法名称。
  •   CheckClearPlugin在应用到Client，第2次检验会失效的bug。#IC5J1I

TouchSocket.Http​

  •   HttpClientBase请求时，新增直接添加Host的逻辑。#IC6OU2
  •   WebSocket在断开时，会判断是否带有主动断开消息，如果带有，则投递主动断开的消息。
  •   SetStatus的使用体验，在默认参数（成功）时，则使用SetStatusWithSuccess代替。
  •   WebSocket的Ping与Pong使用Result进行返回。不再抛出异常。
  •   Http在处理请求时，阻塞接收执行上下文的bug，这会导致如果收到http请求，且需要较长时间执行时，如果连接方已断开，则断开消息不会立即执行的bug。也会间接导致WebApi的CancellationToken失效。

TouchSocket.NamedPipe​

  •   UseNamedPipeSessionCheckClear的插件扩展方法。

TouchSocket.Rpc​

  •   ISingletonRpcServer的接口。

TouchSocket.SerialPort​

  •   UseSerialPortSessionCheckClear的插件扩展方法。

TouchSocket.WebApi​

  •   WebApi调用上下文中CancellationToken不起作用的bug。

v3.1.0(1)​

更新日期： 2025.4.29

更新描述：

此次升级可能会有部分代码不兼容项，请在升级前做好备份，并且详细阅读3.1升级指南。

此次升级所有组件在运行时完全兼容3.0，所以无论客户端还是服务端，都可以进行差异化更新。

更新详情：

All​

  •   DateTime调整为DateTimeOffset。
  •   Task.Run全部使用EasyTask.Run再次封装运行。
  •   所有组件在日志记录时，传入可触发源，可更好的进行日志记录。

TouchSocket.Core​

  •   AsyncBoundedQueue类调整为AsyncQueue。
  •   BytePool类不再使用，目前使用ArrayPool<T>代替。
  •   ByteBlock类不再提供默认参数构造函数，目前强制传入申请长度。
  •   ResultCode枚举项Fail调整为Failure。
  •   FastSerializerContext默认不再支持DataTable和DataSet。如有需要，请自行添加DataTableFastBinaryConverter和DataSetFastBinaryConverter。
  •   PeriodPackageAdapter接收性能。
  •   BlockSegment性能。
  •   WaitHandlePool性能。
  •   PeriodPackageAdapter接收不判断最大包设定的bug。
  •   若干扩展方法。

TouchSocket.Sockets​

  •   StopAsync、CloseAsync等方法，在调用时不再抛出异常，而是返回Task<Result>。
  •   IClient的接口，不再继承自IDependencyObject。如有需求请使用IDependencyClient。
  •   IServerStopedPlugin插件，改名为IServerStoppedPlugin。
  •   Tcp、Udp等组件的释放逻辑

TouchSocket.Dmtp​

  •   添加IActor的方式。

TouchSocket.Hosting​

  •   日志记录信息。

TouchSocket.Http​

  •   性能大幅提高。
  •   HttpStatusCode静态类，支持常用的状态码。
  •   WebSocket的SwitchProtocolToWebSocketAsync方法返回值由bool改为Result。
  •   InitHeaders、SetStatus等方法中设置Header的方法，由Add调整为TryAdd。
  •   默认情况下，服务在响应Header中，设置Server时，不再显示具体版本。#IC25RJ
  •   HttpClient在断开连接时，不触发OnTcpClosed的bug。

TouchSocket.WebApi.Swagger​

  •   在Swagger显示时，支持参数属性。PR68

TouchSocket.Rpc​

  •   SingletonRpcServer名称改为SingletonRpcServer。
  •   QueueRpcDispatcher性能。

TouchSocket.Mqtt​

  •   功能首发。
v3.0

v3.0.26​

更新日期： 2025.4.20

更新描述：

兼容性修复升级。

更新详情：

TouchSocket.Rpc​

  •   RpcActionFilterAttribute在RpcImplementation程序集中使用时无效bug。 #IC0IB0

TouchSocket.Http​

  •   WebSocket服务端WebSocket使用AsyncClose()主动关闭连接时引发NullReferenceException异常。 #IC1FZ8

v3.0.25​

更新日期： 2025.4.12

更新描述：

兼容性修复升级。

更新详情：

TouchSocket.SerialPort​

  •   接收数据时，如果业务出现延迟，则会导致接收失败的异常bug。 #IBZHN2

v3.0.21(3)(4)​

更新日期： 2025.4.6

更新描述：

兼容性修复升级。http组件性能优化。

更新详情：

TouchSocket.Core​

  •   ReadOnlySpan<byte>的Trim方法。
  •   Method新增支持类型的直接构造函数方法。
  •   AsyncResetEvent新增已释放判断。
  •   DynamicMethod在ref、out等参数时，无法使用源生成调用的bug。
  •   FlowOperator的在构造函数使用最大值初始化MaxSpeed。

TouchSocket.Sockets​

  •   TcpCore在特点情况下不释放资源的bug。PR
  •   ShutdownAsync调整返回值，由Task改为Task<Result>。

TouchSocket.Http​

  •   HttpContent新增TryComputeLength的抽象方法。
  •   HttpResponse的FromFileAsync扩展新增传输限速、进度功能。#IBYGC7
  •   整个Http组件性能优化。
  •   HttpHeaders由枚举改为静态类。（此操作不影响现有代码）

v3.0.20​

更新日期： 2025.3.30

更新描述：

兼容性修复升级。部分方法名大小写调整。

更新详情：

TouchSocket.Core​

  •   TouchSocketCoreUtility类中的所有静态字段大小写调整。
  •   StringExtension类中的多个方法名大小写调整（此处调用时可能是扩展方法调用的，所以需要注意）。

TouchSocket.Http​

  •   HttpClient在请求application/x-www-form-urlencoded时，内部未进行编码的bug。#IBVPAD
  •   HttpResponse新增FromHtml扩展方法，用于直接返回Html页面。

TouchSocket.Rpc​

  •   IRpcCallContextAccessor服务，可以在异步调用流中，通过服务直接获取到执行Rpc的CallContext。

TouchSocket.WebApi.Swagger​

  •   Swagger页面版本为v5.20.2，以支持一键复制url等功能。 #IBX933

TouchSocket.Modbus​

  •   Modbus rtu在响应数据时的严谨性，基本排除了站号，功能码不一致时仍然返回的错误情况。 #github-issue 54

v3.0.19​

更新日期： 2025.3.23

更新描述：

兼容性修复升级。

更新详情：

TouchSocket.Http​

  •   Http静态内容插件在客户端不支持gzip时仍然会使用gzip的bug。
  •   Http静态内容插件在以文件响应时，限速为0的bug。#IBVCPJ

v3.0.18​

更新日期： 2025.3.16

更新描述：

兼容性修复升级。少量代码调整，详见 

更新详情：

TouchSocket.Sockets​

  •   TryShutdown的关闭机制没有考虑异步发送队列的情况。#IBTKMP
  •   TryShutdown方法改为ShutdownAsync。

TouchSocket.Http​

  •   HttpExtensions中GetBoundary实现存在问题。#IBT3RO
  •   静态页面插件在重新载入时prefix参数丢失问题。#IBTP38

v3.0.17​

更新日期： 2025.3.12

更新描述：

兼容性修复升级。

更新详情：

TouchSocket.Sockets​

  •   UdpSessionBase的OnUdpReceiving方法添加EndPoint参数。#IBSQVN

TouchSocket.SerialPorts​

  •   SerialPortClient在接收数据时LastReceivedTime一直不会更新。#IBSXDK

v3.0.16​

更新日期： 2025.3.9

更新描述：

兼容性修复升级。

更新详情：

TouchSocket.Core​

  •   自定义适配器在接收数据时，不验证MaxPackageSize的bug。
  •   MakeIdentifier在获取方法名称时，不显示中文等其他字符的bug#IBQQHY。

TouchSocket.Sockets​

  •   当配置NoDelay时，TcpCore发送时仍然会把数据放入发送队列，可能会产生细微延迟 #IBR1I2。
  •   IWaitingClient实现了无效的Dispose方法，目前已取消。

v3.0.15​

更新日期： 2025.3.2

更新描述：

兼容性修复升级。

更新详情：

All​

  •   代码规范和相关注释。

TouchSocket.Core​

  •   SystemExtension新增ReadAllToByteArray方法。

v3.0.14​

更新日期： 2025.2.15

更新描述：

修复升级。区间字符适配器会有不兼容部分，请参阅区间字符。

更新详情：

All​

  •   所有的Plugin接口。均新增快捷扩展方法，简化使用。
  •   使用自定义的lock锁对象。以简化使用场景。

TouchSocket.Core​

  •   ILog接口新增DateTimeFormat属性。 #IBLQBX
  •   自定义区间适配器在未找到开始字符的情况下，也会缓存数据的bug。 #IBKPXU
  •   自定义区间适配器的运行逻辑，简化使用方式。 #IBKPXU

TouchSocket.Rpc​

  •   IRpcActionFilter.ExecutedAsync在执行异常时，Exception参数一直为空的bug。#IBK579

TouchSocket.Dmtp​

  •   TokenVerifyException异常信息中新增Metadata属性。
  •   TcpDmtpService中使用e.IsPermitOperation = false;拒绝客户端无效的bug。#IBKO6A

v3.0.13​

更新日期： 2025.1.27

更新描述：

兼容性修复升级。

更新详情：

TouchSocket.Core​

  •   在net framework下，如果Span<byte>为空时，ToString会异常的bug。 #IBIYRQ

v3.0.12​

更新日期： 2025.1.19

更新描述：

兼容性修复升级。

更新详情：

TouchSocket.Core​

  •   FileLogger的路径合并方式。

v3.0.11​

更新日期： 2025.1.12

更新描述：

兼容性修复升级。

更新详情：

All​

  •   全系新增EasyTask.ContinueOnCapturedContext的设定，以解决Unity3d在webgl平台下，会卡住的问题。

TouchSocket.Core​

  •   IWaitHandlePool<T>的接口抽象。

TouchSocket.Http​

  •   HttpResponse新增SetRedirect重定向功能。#IBG1QT
  •   HttpRequest在请求时的编码效率。
  •   HttpRequest不会对中文等非Ascii编码的字符进行url encode的bug。#IBGATN
  •   在客户端，执行IWebApiRequestPlugin插件时，HttpRequest无法通过GetContent或者GetBody获取数据。#IBGARB

v3.0.10​

更新日期： 2025.1.5

更新描述：

兼容性修复升级。

更新详情：

TouchSocket.Core​

  •   AsyncBoundedQueue新增Capacity、Count等属性。
  •   CustomJsonDataHandlingAdapter自定义适配器，方便自定义继承实现。
  •   CustomCountSpliterDataHandlingAdapter固定数量分隔符适配器。#IBF0Z7
  •   IByteBlock新增ReadT和WriteT方法。

TouchSocket.Sockets​

  •   CheckClearPlugin在客户端断开后，仍然会触发断开的bug。#IBECPA

v3.0.9​

更新日期： 2024.12.22

更新描述：

兼容性修复升级。

更新详情：

TouchSocket.Core​

  •   SystemTextJsonStringToClassSerializerFormatter转换器。
  •   IPackage源生成时，默认支持Guid。#IBC1FH

TouchSocket.Sockets​

  •   TcpService在ResetId后，偶发性客户端集合丢失客户端的问题。#IBCUHW
  •   WaitingClient使用ResponsedData时第二次接受报错。#IBC8D2

TouchSocket.SerialPort​

  •   SerialPortClient串口组件ProtectedMainSerialPort属性null错误。#IBBQ4A

TouchSocket.AspNetCore​

  •   IWebSocketDmtpService接口中缺少Clients属性。#IBBQS5

TouchSocket.Modbus​

  •   ModbusRtu在crc校验失败时，会抛出ResponseMemoryVerificationError = 99的错误码。#IBC1J2

TouchSocket.WebApi​

  •   WebApi支持Put、Delete、Options请求方式。
  •   WebApi当参数解析异常时，RpcActionFilterAttribute无法捕获。#IBCI94
  •   WebApiParserPlugin使用Mapping代替GetRouteMap和PostRouteMap。

TouchSocket.JsonRpc​

  •   JsonRpc支持Aot。

v3.0.8​

更新日期： 2024.12.15

更新描述：

兼容性修复升级。

更新详情：

TouchSocket.Sockets​

  •   IPHost类，在Mono运行时会异常的bug。 #IBAG51
  •   UdpSessionBase类调整ReceivingData为OnUdpReceiving。
  •   Udp组件，新增IUdpReceivingPlugin插件。#IBB1F6

TouchSocket.AspNetCore​

  •   当使用基于WebSocket协议，搭建DmtpServer服务时 使用app.UseOutputCache()缓存中间件导致连接失败后，重连无响应。#IBAPTQ

TouchSocket.Dmtp​

  •   DmtpActor类，在连接成功时，Handshaking事件参数e.Message无法传回到请求端。

TouchSocket.SerialPorts​

  •   SerialPortClient类，在关闭或者释放时，资源无法释放的bug。 #IBB8FD

v3.0.7​

更新日期： 2024.12.8

更新描述：

兼容性修复升级。在.Net9.0中，启用Lock锁代替object锁，提高锁效率。

更新详情：

TouchSocket.Core​

  •   ValueByteBlock类，在WritePackage时数据无效的bug。
  •   开放PackageFastBinaryConverter类，以支持二进制数据序列化源生成。

TouchSocket.Dmtp​

  •   DmtpRpc新增RpcDispatcher调度器，支持多线程并发，或者单线程调度。
  •   DefaultSerializationSelector优化支持System.Text.Json源生成模式的序列化。
  •   触发OnFileTransferred事件的时机调到SendAsync前面，目的是保证调用方在收到回复时，响应方已经完成事件处理。此操作理论上不会对现有运行逻辑造成影响。
  •   DmtpRpc在发送Rpc请求时，如果请求模式使用OnlySend、或者WaitSend，则会抛出异常的bug。#IB9F8P

TouchSocket.Modbus​

  •   在IModbusResponse返回响应时，会同时携带返回响应的当前请求IModbusRequest。

TouchSocket.WebApi​

  •   WebApiSerializerConverter类，以支持更好的System.Text.Json源生成模式的序列化。

TouchSocket.Rpc​

  •   在ReenterableAttribute特性，可以强制设置Rpc函数是否为重入模式。
  •   ConcurrencyRpcDispatcher并发调度器，支持多线程并发。
  •   ImmediateRpcDispatcher当前调度器，直接在当前线程执行。
  •   QueueRpcDispatcher队列调度器，把所有请求，放在一个队列中，等待处理。

v3.0.5(6)​

更新日期： 2024.12.1

更新描述：

兼容性修复升级。全面支持PluginManager容器化模块和Scoped区域划分。

此修改不影响现有运行逻辑。但是如果是Asp.Net Core项目，则可能会影响Scoped服务运行结果。

更新详情：

TouchSocket.Core​

  •   FlowOperator类。以实现流量速度限制。
  •   PluginManager类。新增FromIoc的设定，支持插件容器化。
  •   Result类。使用record修饰，简化使用逻辑。
  •   IResolver的Resolve行为。当服务未注册时，会返回null。不会再触发异常。
  •   SetupConfigObject在Build时，会创建一个新的Scoped生命周期的容器。这个在现有架构下，不会影响运行结果。
  •   Metadata在添加相同键值时，会异常的bug，正确操作应该是覆盖旧值。
  •   IResolver移除对IRegistered接口的实现，所以无法再使用IResolver判断某个服务是否已注册。
  •   IResolver移除对TryResolve扩展方法实现，请使用Resolve直接代替。

TouchSocket.Sockets​

  •   IPHost在.NET Framework下，设定任意端口无效的bug。 #IB7PM1，#IA8NQ2

TouchSocket.Http​

  •   HttpBase新增ReadCopyToAsync(Stream stream, HttpFlowOperator flowOperator)方法。支持传输进度、速度显示。#IB7GIC
  •   HttpFlowOperator类，支持Http上传、下载文件（流）时，可以方便的实现限速、传输进度、速度显示等。
  •   StreamHttpContent在传输流数据时，支持HttpFlowOperator相关操作。

TouchSocket.Rpc​

  •   Rpc代码生成器在生成通用泛型类型时，会失败的bug。#IB7IB2

v3.0.4​

更新日期： 2024.11.24

更新描述：

修复升级。WebSocket有少量代码差异，下面会详细介绍。

更新详情：

TouchSocket.Core​

  •   JsonPackageAdapter适配器，专门解决纯Json数据格式的粘分包。详情参见：JsonPackageAdapter。
  •   IByteBlock新增WriteNormalString方法，用于写入普通字符串。
  •   Container容器新增Scoped生命周期，但是本身容器并未实现功能，如果需使用，请使用TouchSocket.Core.DependencyInjection。
  •   Tcp、NamedPipe、SerialPort、DmtpRpc、JsonRpc、WebApi等所有组件，支持Scoped容器。（需配合TouchSocket.Core.DependencyInjection容器）。

TouchSocket.Http​

  •   HttpStaticPagePlugin新增SetContentTypeProvider(Action<IContentTypeProvider> provider)方法。
  •   WebSocket新增CloseAsync(WebSocketCloseStatus closeStatus, string statusDescription)方法。
  •   WebSocket在Close时，不符合规范的bug。#IAAF3U，#IB5IH0
  •   IWebSocketClosingPlugin的事件参数，由ClosedEventArgs调整为ClosingEventArgs。 重新实现接口解决

TouchSocket.Sockets​

  •   TcpClient在重连之后，适配器失效的bug。 #IB6KZJ

TouchSocket.Rpc​

  •   Rpc服务新增IScopedRpcServer。

TouchSocket.SerialPort​

  •   SerialPortClient在重连之后，适配器失效的bug。

TouchSocket.NamedPipe​

  •   INamedPipeSession新增DataHandlingAdapter属性。
  •   NamedPipeClient在重连之后，适配器失效的bug。

TouchSocket.Modbus​

  •   Modbus在写入时，会携带IModbusResponse的返回值。 #IATPWB

v3.0.3​

更新日期： 2024.11.17

更新描述：

兼容性修复升级。

更新详情：

  •   WaitingClient在收到ResponsedData数据时，优先建议使用ByteBlock，在高效场景中代替原Data属性。

v3.0.2​

更新日期： 2024.11.15

更新描述：

兼容性修复升级。

更新详情：

  •   串口的发送与接收无法通过插件获取到原始数据。#IB4NF4

v3.0.0(1)​

更新日期： 2024.11.13

更新描述：

大版本升级，有部分不兼容性升级。所以请在升级前做好备份，同时在升级之后，请务必阅读v3.0升级指南。

本次改动在运行时完全兼容v2.1，所以客户端和服务器可以差异版本更新。

更新详情：

SDK​

  •   新增net9.0支持。
  •   移除net7.0支持，但是不影响net7.0使用，因为最低到net6.0的支持。

TouchSocket.Core​

  •   Plugin组件默认支持AOT，不再借助委托实现。
  •   AppMessenger组件默认支持AOT。
  •   DependencyObject类使用“懒汉式”加载内部成员，减少内存使用。
  •   PluginManager支持在运行时移除插件。
  •   Method类，在方法、或类添加[DynamicMethod]特性时，默认支持AOT，为动态调用提供极大方便。

TouchSocket.Core.DependencyInjection​

  •   AspNetCoreContainer不支持KeysService的bug。

TouchSocket.Sockets​

  •   IReceiver在启用缓存模式时，如果已经完成接收，则会抛出异常的bug。 #IB44LL

TouchSocket.Http​

  •   HttpRequest在请求时，不用传参，直接使用默认构造函数即可。
  •   GetMultifileCollection相关扩展方法，使用GetFormCollectionAsync代替。

TouchSocket.Rpc​

  •   ICallContext继承IDependencyObject，支持扩展属性读写，可以更方便的开发。
  •   Rpc特性取消构造函数入参，使用属性设置。受影响的有：DmtpRpc、JsonRpc、XmlRpc、WebApi。

TouchSocket.Dmtp​

  •   DmtpRpc在Avalonia-Web工作时，连接时间超长的bug。
  •   IWebSocketDmtpClient不实现IDmtpClient的bug。
  •   DmtpHeartbeatPlugin在长时间运行时，可能会失效的bug。
  •   [DmtpRpc]特性不再允许继承，所有设置也是通过属性设置。

TouchSocket.JsonRpc​

  •   [JsonRpc]特性不再允许继承，所有设置也是通过属性设置。

TouchSocket.WebApi​

  •   [FromBody]特性，支持指定参数来源自Http的请求Body。
  •   [FromForm]特性，支持指定参数来源自Http的请求Form表单。
  •   [FromHeader]特性，支持指定参数来源自Http的请求Header。
  •   [FromQuery]特性，支持指定参数来源自Http的请求Query。
  •   [WebApi]特性不再允许继承，所有设置也是通过属性设置。
  •   WebApi的请求方式，目前全部使用WebApiRequest类来表示全部入参，一般如果使用代理，或者源生成的话，只需要重新生成即可。
  •   HttpMethodType.GET枚举，使用HttpMethodType.Get代替。
  •   HttpMethodType.POST枚举，使用HttpMethodType.Post代替。

TouchSocket.XmlRpc​

  •   [XmlRpc]特性不再允许继承，所有设置也是通过属性设置。
v2.1

v2.1.10​

更新日期： 2024.10.25

更新描述：

兼容性修复升级。

更新详情：

  •   CheckClearPlugin插件频繁输出poll日志的不合理设计。

v2.1.9​

更新日期： 2024.10.14

更新描述：

兼容性修复升级。

更新详情：

  •   CheckClearPlugin长时间工作时可能失效的bug。

v2.1.8​

更新日期： 2024.10.11

更新描述：

兼容性修复升级。

更新详情：

  •   TcpService在Stop的时候，有个内部异常打了log。 #IAWD4N

v2.1.7​

更新日期： 2024.10.5

更新描述：

兼容性修复升级。

更新详情：

  •   TcpService在启动时如果异常，则无法再重新启动的bug。

v2.1.6​

更新日期： 2024.10.1

更新描述：

兼容性修复升级。

更新详情：

  •   HttpContent机制，能上传超大数据。
  •   StreamHttpContent，能上传流数据，例如：文件流。
  •   Task内部异常时没有及时try，导致全局捕获时有无用捕获。
  •   TcpServiceBase在调用StopAsync时，IServerStopedPlugin插件无法触发的bug。
  •   TriggerQueue无用类。
  •   HttpRequest，使其能上传超大数据。

v2.1.4(5)​

更新日期： 2024.9.23

更新描述：

兼容性修复升级。

更新详情：

  •   DmtpRpc恢复性新增Xml序列化。
  •   使用源生成（IPackage）打包时报错。#IASTWJ
  •   Result泛型类中隐式转换错写成显示转换的bug。
  •   DmtpRpc序列化选择器没有预留Json序列化配置的bug。

v2.1.3​

更新日期： 2024.9.22

更新描述：

兼容性修复升级。

更新详情：

  •   部分类，方法注释。
  •   多数英文字符串资源。
  •   Tcp、NamedPipe、SerialPort等组件在主动调用Close时，ClosedEventArgs参数属性Manual为false的bug，导致重连插件偶发性再次连接。#IASH1A
  •   ByteBlock类部分bug。
  •   DecimalConver类，该类功能已完全由TouchSocketBitConverter代替，属于无用类。
  •   受保护方法ProtectedResetId方法，名称更改为ProtectedResetIdAsync。

v2.1.2​

更新日期： 2024.9.19

更新描述：

兼容性修复升级。

更新详情：

  •   部分类，方法注释。
  •   TcpClient在释放时，重连插件会无限连接的bug，该bug会导致CPU占用过高。#IAS9NG

v2.1.1​

更新日期： 2024.9.18

更新描述：

兼容性修复升级。

更新详情：

  •   在MemoryCache中实现新的TryGetValue方法。
  •   密封CacheEntry类并优化缓存管理逻辑。
  •   扩展PackageExtensions类，增加泛型方法以提高可读性和可重用性。
  •   优化HttpStaticPagePlugin构造函数和StaticPageOptions类以简化静态页面配置。
  •   在FastBinaryFormatter中改进序列化逻辑，特别是对于多维数组的处理。 #IARKE1
  •   在IPackage中改进打包、解包逻辑，特别是对于多维数组的处理。

v2.1.0​

更新日期： 2024.9.15

更新描述：

大版本升级，有部分不兼容性升级。所以请在升级前做好备份，同时在升级之后，请务必阅读v2.1升级指南。

更新亮点：

本次更新，主要有以下亮点：

  1. 全系支持Span、ValueTask、Memory、Unsafe等依赖。大幅提升并发性能与低GC能力。
  2. 全系组件，尽量多的提供了异步Api，大幅度提升并发能力。
  3. 重构fast序列化，Package包模式、Http、WebSocket等组件，使之更加易用。
  4. 资源国际化。本次更新会在内部使用中英双语信息提示，这在日志记录，堆栈跟踪等场景更加符合区域化。
  5. 增加完整注释。基本上能达到95%的代码注释率。

更新详情：

TouchSokcet.Core​

  •   TouchSocketBitConverter新增To、UnsafeTo、WriteBytes、UnsafeWriteBytes等可以直接操作Span。
  •   Crc类新增Span相关转换。
  •   CustomDataHandlingAdapter新增bool TryParseRequest(ref TByteBlock byteBlock, out TRequest request)方法，可以同步完成适配器数据解析。
  •   SingleStreamDataAdapterTester泛型测试器，可以对TryParseRequest进行完整性测试。
  •   IPackage源生成器新增自定义PackageMember特性，用来定义打包的顺序和自定义转换器。
  •   SetupConfigObject的SetupAsync。
  •   CustomDataHandlingAdapter支持结构体作为泛型类型。
  •   Fast序列化支持自定义FastSerializerContext，这可以极大的利用源生成来决定序列化和反序列化。
  •   分离MemoryCache的同步和异步接口。
  •   ByteBlock取消Stream的继承，如果需要使用Stream，可以使用ByteBlock.AsStream()。
  •   Gzip类调整ByteBlock参数为Stream。
  •   CustomDataHandlingAdapter解析的数据，均会以ReadonlySpan的形式投递。
  •   IPackage接口，使之既可以在ByteBlock工作，也可以在ValueByteBlock工作。
  •   PluginManager使用接口作为唯一键，规定一个接口中有且仅有一个方法。
  •   ByteBlock、ValueByteBlock均继承IByteBlock接口规范。
  •   ByteBlock、ValueByteBlock移除Buffer属性，如果想获取有效数据，可以通过Memory、Span等获取，如果想获取容量可以使用TotalMemory属性。

TouchSokcet.Sockets​

  •   Tcp、Udp组件，默认情况下适配器将为null，并且可以正常工作。
  •   SocketClient、ISocketClient等服务器辅助类，改名为TcpSessionClient和ITcpSessionClient。
v2.0

v2.0.18​

更新日期： 2024.9.10

更新描述：

兼容性修复升级。

更新详情：

  •   当Cancel延迟到Reset之后时，新获取的waitData会出现Status为Cancel异常bug #IAQ2AI。

v2.0.17​

更新日期： 2024.8.30

更新描述：

兼容性修复升级。

更新详情：

  •   使用AspNetCore容器时，默认没有注册ILog的bug。

v2.0.16​

更新日期： 2024.8.19

更新描述：

兼容性修复升级。

更新详情：

  •   tcp在winform中会使用主线程接收的bug，导致各种同步接收异常。

v2.0.15​

更新日期： 2024.8.9

更新描述：

兼容性修复升级。

更新详情：

  •   当客户端断开连接时，http响应会出现object is null的bug提示。

v2.0.13（14）​

更新日期： 2024.7.24

更新描述：

兼容性修复升级。

更新详情：

  •   重连插件在长时间运行时，会失效的bug。
  •   ssl加密下，连接响应时间过长bug#IAET6V 。

v2.0.12​

更新日期： 2024.7.17

更新描述：

兼容性修复升级。

更新详情：

  •   socket在接收连接时，异常无法拦截的bug#IADIGX。
  •   日志记录在执行时，先判断日志组件的可用性。

v2.0.11​

更新日期： 2024.7.12

更新描述：

兼容性修复升级。

更新详情：

  •   Metadata在Add时不会覆盖原key的bug。

v2.0.10​

更新日期： 2024.5.31

更新描述：

兼容性修复升级。

更新详情：

  •   WebSocket快捷命令行bug。 #I9TG3V。

v2.0.9​

更新日期： 2024.5.29

更新描述：

兼容性修复升级。

更新详情：

  •   UdpPackage适配器在工作时调时导致的bug。 #I9SYTR。
  •   Http在GetBoundary时bug。 #I9PXWT。

v2.0.(7)8​

更新日期： 2024.5.17

更新描述：

兼容性修复升级。

更新详情：

  •   udp首次建立连接无法接收数据的bug。 #I9PV7C。

v2.0.6​

更新日期： 2024.5.12

更新描述：

兼容性修复升级。

更新详情：

  •   FlowGate的waitTime小于0时bug。

v2.0.5​

更新日期： 2024.5.2

更新描述：

兼容性修复升级。

更新详情：

  •   wsclient Received事件与插件触发bug。#I9L9WI。
  •   ws命令行执行bug。

v2.0.4​

更新日期： 2024.4.30

更新描述：

兼容性修复升级。

更新详情：

  •   linux平台下，Socket吞吐量大幅降低。#I9KURV。
  •   WebSocket在进行连接时，Host的Header写法错误，没有包含端口。#I9KUVI。

v2.0.3​

更新日期： 2024.4.14

更新描述：

兼容性修复升级。

更新详情：

  •   Tcp在接收时，内存池释放存在延迟，可能导致内存池快速扩张，浪费内存。#I9FVAA。
  •   在使用Host模型时，注入瞬态的TcpClient，在第一次获取实例是正常的，第二次就失败。#I9G3SV。
  •   WebSocketClient连接其他服务器时显示 “操作已被取消”。#I9GG05。
  •   ConcurrentList新增实现IReadOnlyList接口。

v2.0.2​

更新日期： 2024.4.1

更新描述：

兼容性修复升级。

更新详情：

  •   TouchSocketBitConverter中的ToBooleans方法存在Bug#I9C1UY。
  •   SystemExtensions中的GetBit和SetBit方法#I9C1WM。
  •   HttpService多次响应下载文件时，不会响应的bug。

v2.0.1​

更新日期： 2024.3.16

更新描述：

兼容性修复升级。

更新详情：

  •   HttpClient，无法通过HttpResponse.GetBody()获取响应内容#I989SI。
  •   SetNoDelay 异常#I979B0。
  •   调用Dmtp服务的大数据传输时，如果循环调用会出现收到的数据和发送的数据不一致。实际上该问题是由ByteBlock写入扩容bug而导致的#I96FNF。

v2.0.0​

更新日期： 2024.3.9

更新描述：

此版本是大版本更新。可能会产生很多不兼容部分，所以升级之前请做好备份，并且请详细阅读下列更新内容。

升级指南：

  • 升级时请先升级至2.0.0-beta.190，再升级至2.0.0-rc.2版本，因为正式版对于[Obsolete]特性的成员直接删除了，所以为友好升级，请先升级至此版本。
  • 由2.0.0-beta.200至2.0.0-beta.220 #I8DE1D
  • 由2.0.0-beta.220至2.0.0-beta.230 #I8LAX4

更新详情：

TouchSokcet.Core​

  •   FileLogger支持指定不同目录。
  •   所有自定义插件必须在自身内，主动调用e.InvokeNext()时，才会调用下一个插件。不然会中断插件传递。同时e.Handled功能依然有效。
  •   Log项。LogType调整为LogLevel，并且不需要位运算。直接按日志等级输出。
  •   修改IPluginsManager名称为IPluginsManager。
  •   DependencyProperty中，移除对类型的定义。
  •   所有组件的基础插件，强制用户插件必须继承PluginBase，然后实现需要的接口。
  •   BytePool在创建ByteBlock时，移除EqualSize的设定，因为这会影响内存池的效率。
  •   修改所有委托为异步Task。
  •   修改所有Setup返回值为void。
  •   Metadata在0个成员长度时，会被反序列化成null的bug。
  •   PluginsManager在注册具有继承的插件时，会无法识别的bug。

TouchSokcet.Sokcets​

  •   IPHost支持从int、string直接隐式转换。
  •   TouchSocket所有“ID”属性，改名为“Id”。
  •   TouchSocket所有插件的执行顺序，移动至内部重写方法之后。
  •   TouchSocket所有ResetID改名为ResetId。
  •   UseCheckClear项，SetDuration调整名称为SetTick。
  •   UseCheckClear项，不仅可以适用服务器，客户端也适用。
  •   Config配置中，SetDataHandlingAdapter调整为SetTcpDataHandlingAdapter。
  •   适配器项，CustomDataHandlingAdapter中的Filter方法中，byteBlock参数使用in修饰。
  •   适配器项，DataHandlingAdapter改名为TcpDataHandlingAdapter。
  •   适配器项，DataAdapterTester改名为TcpDataAdapterTester。
  •   Config项，所有适配器的相关配置，使用SetAdapterOption配置。
  •   UsePlugin的显式配置，当调用ConfigurePlugins时，会自动启用。

TouchSokcet.Http​

  •   WSCommandLinePlugin改名为WebSocketCommandLinePlugin。
  •   WebSocket添加同步非阻塞Read。
  •   WebSocket的WSDataFrame新增IsPing、IsPong、IsText、IsBinary、IsClose等属性。
  •   静态网页插件新增NavigateAction与ResponseAction等委托，可以在静态页面请求之前重定向，或者请求返回时设置header等。

TouchSokcet.Rpc​

  •   整体功能迁移至TouchSokcet(Pro).Dmtp。
  •   RpcActionFilter执行策略和顺序
  •   修改ConfigureRpcStore为AddRpcStore。
  •   RealityProxy透明代理方式。
  •   DispatchProxy添加OnBefore和OnAfter的AOP调用。

TouchSokcet(Pro).Dmtp​

  •   原TouchRpc全系改名为Dmtp。例如：原TcpTouchRpcClient改名为TcpDmtpClient。
  •   原TouchRpc中InvokeOption，改名为DmtpInvokeOption。InvokeOption依然有效，但是在调用DmtpRpc时，则无法指定序列化方式。所以可能需要使用DmtpInvokeOption。
  •   原TouchRpc中Invoke直接调用的方式，改为InvokeT。
  •   Dmtp相关配置，使用SetDmtpOption配置。
  •   暂时移除EventBus功能，后续可能考虑添加。
  •   ws协议的TouchRpc服务端，增加HttpContext上下文获取。
  •   文件传输项，开放增加SetMaxSpeed功能。
  •   DmtpRpc。
  •   DmtpRpc组件在调用时，可以通过DmtpInvokeOption传入Metadata元数据。
  •   DmtpRpc在调用无ref，out的函数时，参数会为null的bug。

TouchSokcet.JsonRpc​

  •   JsonRpc使用内联数组调用#I79OFZ。
  •   Rpc服务使用调用上下文时不需要再添加IncludeCallContext。

TouchSokcet.WebApi​

  •   WebApi新增Swagger页面。
  •   Rpc服务使用调用上下文时不需要再添加IncludeCallContext。

TouchSokcet.XmlRpc​

  •   Rpc服务使用调用上下文时不需要再添加IncludeCallContext。

TouchSokcet(Pro).Hosting​

  •   新发布Hosting的包，用于构建更加强壮的运行程序。

TouchSokcet.SerialPorts​

  •   新发布串口的包。

TouchSokcet(Pro).Modbus​

  •   新发布Modbus的包，支持Tcp、Udp、Rtu、RtuOverTcp、RtuOverUdp协议的主站（Poll）和从站（Slave）。
v1.3

v1.3​

更新日期：2023.3.1

更新描述：兼容性更新。

  •   整体增加异步方法。
  •   Rpc源代码生成策略，支持接口实例并存。
  •   TcpClient在UseReconnect插件时，Disconnect事件不触发bug。
  •   ws协议的TouchRpc服务端，增加HttpContext上下文获取。
v1.2

v1.2​

更新日期：2023.2.15

更新描述：兼容性更新。

  •   TouchRpc支持命名元组。
  •   Rpc源代码生成策略。
  •   TouchRpc在Websocket协议下，启动，连接异常bug。
  •   TouchRpc在调用WaitSend下失败的bug。
  •   TouchRpc在Handshaked时，调用Rpc超时bug。
  •   序列化、反射在unity中使用il2cpp编译的bug。
  •   反序列化在初次加载时会失败的bug。
  •   BytePool没有公共构造函数的bug。
  •   ws协议的TouchRpc服务端，增加HttpContext上下文获取。
  •   ByteBlock对于int，long等数据，写入和读取的时候支持大小端指定。
  •   IServicePlugin插件，用于显示通知服务器的启动状态。
  •   Rpc支持接口特性标记。
  •   将BytePool由静态调整为实例，且由其Default实例作为默认。
v1.1

v1.1​

更新日期：2023.1.13

更新描述：小版本升级，可能会有不兼容。请按下列提示修改。

  •   TouchRpc系文件传输时，文件夹不存在的提示。
  •   WaitingClient，当客户端断开连接时，可选是否抛出异常。
  •   Fast序列化时。可选序列化只读属性。
  •   多个不稳定Bug。
  •   Tcp客户端新增Disconnecting事件。在主动Close时生效。
  •   多个事件类名称修改，请按照提示修改即可。
  •   多个无用方法参数。
v1.0

v1.0.0​

更新日期：2023.1.1

更新描述：大版本升级，请详细阅读下列更新日志。

  •   将最高版本升级为NET7。
  •   Tcp系异步发送效率。
  •   TouchRpc系Channel的稳健性。
  •   多个不稳定Bug。
  •   ValueByteBlock，在简单代码块里面能有效减少创建的类。
  •   MemoryCache类，其功能类似微软官方。但是支持全部泛型。
  •   IPackage系。该系列能以超高效率的进行二进制序列化。
  •   SingleTimer类，不可重入的Timer。
  •   Jsonrpc支持自定义适配器解析（EE）
  •   严重TouchRpc系OnRouting通知，所有的客户端之间的通信，都必须经过OnRouting的筛查。
  •   TouchRpc系小文件传输，在文件小于1Mb时，其传输效率是常规传输的10倍以上。
  •   TouchRpc系超大文件多链路传输，支持多个客户端协同传输同一个文件，这在互联网环境中，效率比常规传输提高类3-5倍。
  •   TouchRpc系Redis组件，能实现双端共同存储。
  •   严重精简所有命名空间，删除所有三级命名空间。例如：TouchSocket.Core.ByteManager精简为TouchSocket.Core。
  •   严重删除Newtonsoft.Json的源代码嵌入。全局的Json会根据环境动态调整，详情见Json工具
  •   严重框架默认日志由ConsoleLogger，替换为EmptyLogger（不输出任何东西）。
  •   严重Tcp全系，在连接时，ID的初始值使用long类型从0递增。
  •   严重Tcp服务器，将定时清理无数据交互的选项替换为UseCheckClear插件。并且默认没有启用，需要手动加入。
  •   Tcp系适配器，取消部分参数。
  •   DataLock改名为DataSecurity。
  •   EasyAction改名EasyTask。
  •   IMessage改名IMessageObject。
  •   TokenInstance改名MessageInstance。
  •   TouchRpc系，精简常规文件传输操作。
  •   严重TouchRpc系，所有插件通知参数，默认都设为不允许操作，需要手动设置e.IsPermitOperation=true。
  •   Newtonsoft.Json的源代码嵌入。全局的Json会根据环境动态调整，详情见Json工具。

*** 更新示例指南 ***

（1）适配器参数报错：直接删除isAsync参数，以及isAsync为True的所有逻辑。 image.png （2）依赖属性的声明报错：增加泛型约束即可，详情查看依赖属性 image.png （3）服务端定时清理警告：在配置插件中使用UseCheckClear，并且进行相关配置。 image.png image.png

v0

版本号: 0.7.0​

更新日期：2022.9.21 更新描述：兼容性更新，增强型更新。RPC内容需要客户端与服务器同步更新。 更新详情：

优化

  1. Fast二进制序列化，支持自定义序列化。
  2. TouchRpc全系，在文件传输等大型IO时，由于心跳失败而断开连接。
  3. 优化AspNetCore的IContainer。
  4. TcpCommandLinePlugin与WSCommandLinePlugin支持获取客户端参数。

新增

  1. 插件实例会以单例注入容器。
  2. 所有适配器支持缓存超时设定。
  3. 修改所有事件为委托。
  4. 开放AspnetCore创建Tcp，Http等服务器的配置。
  5. IClient增加发送、接收的最后时间记录。
  6. Http支持多文件上传（目前仅支持小文件，具体大小以实际运行内存为准，实测100Mb没问题）。
  7. Websocket插件默认会处理Close报文。且插件支持Close。
  8. Rpc支持模板代码重写。
  9. TouchRpc支持元组。
  10. JsonRpc支持Websocket协议。

修改

  1. IScopedContainer修改为IContainerProvider

修复

  1. BytePool回收内存时不判断大小的bug。

删除

  1. 无。

版本号: 0.6.0​

更新日期：2022.9.10 更新描述：兼容性更新，增强型更新。专为Unity 3D适配。 更新详情：

优化

  1. Gzip的压缩效率。
  2. 发送效率。

新增

  1. IDataCompressor数据传输压缩接口。
  2. RemoteStream支持数据读写压缩。
  3. WaitResultPackageBase类，专属非序列化的数据格式化。
  4. DelaySender延迟缓存发送。

修改

  1. 无

修复

  1. Rpc注册服务为单例时，实际上是瞬时服务的bug。

删除

  1. 独立线程发送。

版本号: 0.5.0​

更新日期：2022.9.1 更新描述：兼容性更新，增强型更新。 更新详情：

优化

  1. 全局资源的获取逻辑。

新增

  1. Container增加卸载注册功能。
  2. FilePool新增FileStorageStream的获取。
  3. http客户端（及websocket）支持代理和验证代理。
  4. TouchRpc全系新增远程文件操作
  5. TouchRpc（除udp）新增远程流访问

修改

  1. 无

修复

  1. 修复Http客户端请求重复Header时的bug。

删除

  1. TouchRpc全系的事件操作，推荐直接插件的方式，或者使用TouchRpcActionPlugin然后添加委托。

更新示例 TouchRpc的相关事件均已使用插件代替。所以请使用插件实现操作。如果需要事件等功能的话，可以用TouchRpcActionPlugin的插件实现。例如：

.UsePlugin()
.ConfigurePlugins(a=> 
{
    a.Add<TouchRpcActionPlugin<TcpTouchRpcClient>>()//此处的逻辑可用插件替代完成。
    .SetFileTransfering((client, e) =>
    {
        //有可能是上传，也有可能是下载
        client.Logger.Info($"服务器请求传输文件，ID={client.ID}，请求类型={e.TransferType}，文件名={e.FileInfo.FileName}");
    })
    .SetFileTransfered((client, e) =>
    {
        //传输结束，但是不一定成功，需要从e.Result判断状态。
        client.Logger.Info($"服务器传输文件结束，ID={client.ID}，请求类型={e.TransferType}，文件名={e.FileInfo.FileName}，请求状态={e.Result}");
    });
})

版本号: 0.4.5​

更新日期：2022.8.25 更新描述：兼容性更新，增强型更新。 更新详情：

优化

  1. FileLogger的写入逻辑，大大地提升了写入效率。

新增

  1. Pipeline适配器
  2. TLV适配器
  3. WaitingClient支持按条件等待返回。
  4. 日志系统可以筛选日志的输出类型
  5. Rpc系统，可以使用单例、瞬时生命周期的服务。
  6. Rpc系统，可定义持久化模型。
  7. Rpc在使用瞬时生命周期的服务时，可以直接获取调用上下文。
  8. XmlRpc增加调用上下文。

修改

  1. 日志系统。
  2. Rpc的调用上下文均采用接口，例如：JsonRpc改为IJsonRpcCallContext，WebApi为IWebApiCallContext。
  3. IRpcActionFilter的参数列表。

修复

  1. UdpSession资源不释放的Bug。

删除

  1. 冗余元素。

版本号: 0.3.5​

更新日期：2022.8.12 更新描述：兼容性更新，增强型更新。 更新详情：

优化

  1. 各类客户端发送逻辑。
  2. Method类的调用逻辑。

新增

  1. 适配器可以设定发送IRequestInfo对象。
  2. 插件新增UseWebSocket的快捷方式。
  3. ReconnectionPlugin插件可以获得重连次数的重载设置。
  4. ProTcpService的服务注入。
  5. ProHttpService的服务注入。
  6. ProIOC容器的共享使用。

修改

  1. 各类发送逻辑，以最小化发送方法为基础，其余方法改为扩展方法。
  2. 相关接口的实现。
  3. 由网友修改GetInfo

修复

  1. Container获取泛型失败bug。
  2. BetweenAnd适配器适配器部分bug。
  3. Router标签无法路由的bug。
  4. 修复TouchRpc推送文件状态不正确bug
  5. 修复独立线程在断线重连后发送bug。

删除

  1. 冗余的发送方法，不影响上版本任何使用。

版本号: 0.2.4​

更新日期：2022.7.28 更新描述：兼容性更新。 更新详情：

优化

  1. 优化IOC容器。
  2. 优化Metadata的写入方式。
  3. FileLogger，当日志文件达到1Mb时，会再新增文件序号。

新增

  1. Mapper类，支持简单类型映射
  2. Tcp服务器、客户端、udp等增加端口复用配置。
  3. Pro轮询式断线重连。
  4. ProNATService转发客户端重连。

修改

  1. RRQM二进制序列化，改名为Fast。
  2. TouchRpcClient连接时的Metadata，改为由Config配置注入。
  3. FilePool，取消延迟释放机制。

修复

  1. 修复WebSocket连接问题

删除

  1. 客户端直接调用的短线重连方式。仅保留在Config注入的功能。

版本号: 0.1.0​

更新日期：2022.7.16 更新描述：初始化版本发布。由RRQMSocket迁移而来。

迁移指南：

1.所有类的命名空间修改，此处如果类型名未修改的话，可由vs智能提示解决。​

2.类型名称修改​

原类型名称新类型名称
RRQMBitConverterTouchSocketBitConverter
RRQMConfigTouchSocketConfig
RRQMConverterTouchSocketConverter
RRQMDependencyObjectDependencyObject
MsgEventArgsMsgEventArgs
RRQMEventAgrsTouchSocketEventArgs
IServerProviderIRpcServer
ServerProviderSingletonRpcServer
RRQMOverlengthExceptionOverlengthException

3.使用逻辑修改​

1）原RRQMConfig设置Logger的方法，改为容器注入： image.png 断线重连逻辑 image.png RpcStore使用变更 如果是仅有一个Rpc解析器，那么可以直接删除RpcStore的声明，从而使用对应的解析器实例，直接注册服务。然后可以通过其属性RpcStore，获取到具体的RpcStore实例。

如果是有多个解析器，那么，首先可以使用任意一个解析器的RpcStore属性实例，作为主RpcStore，然后添加其他解析器。当然也可以直接new RpcStore，然后统一管理解析器。其中构造函数中的Container容器，可以直接new Container()，但是更建议使用和解析器相同的容器，这样注入的服务会变得全局可用。

编辑此页
最后由 若汝棋茗 于 更新