feat(ITcpSocketClient): add SendAsync extensions method (#6269)

* doc: 更新粘包分包文档

* feat: 增加 SendAsync 扩展方法

* test: 增加单元测试

Author: ArgoZhang

src/BootstrapBlazor.Server/Components/Samples/SocketFactories.razor

@@ -32,8 +32,8 @@ private ITcpSocketFactory? TcpSocketFactory { get; set; }</Pre>
 <p>数据处理器设计初衷就是为了契合通讯协议大大简化我们开发逻辑，我们已通讯协议每次通讯电文均为 <b>4</b> 位定长举例说明，在实际的通讯过程中，我们接收到的通讯数据存在粘包或者分包的现象</p>
 
 <ul class="ul-demo">
-    <li><b>粘包</b>：比如我们期望收到 <b>1234</b> 四个字符，实际上我们接收到的是 <b>123412</b> 多出来的 <b>12</b> 其实是下一个通讯电文的内容，相邻两个通讯数据包的粘连称为<b>粘包</b></li>
-    <li><b>分包</b>：比如我们期望收到 <b>1234</b> 四个字符，实际上我们接收到的是 <b>12</b> 和 <b>34</b> 两个数据包，这种情况称为<b>分包</b></li>
+    <li><b>粘包</b>：比如我们期望收到 <b>1234</b> 四个字符，实际上我们接收到的是 <b>123412</b> 多出来的 <b>12</b> 其实是下一个数据包的内容，我们需要截取前 4 位数据作为一个数据包才能正确处理数据，这种相邻两个通讯数据包的粘连称为<b>粘包</b></li>
+    <li><b>分包</b>：比如我们期望收到 <b>1234</b> 四个字符，实际上我们可能分两次接收到，分别是 <b>12</b> 和 <b>34</b>，我们需要将两个数据包拼接成一个才能正确的处理数据。这种情况称为<b>分包</b></li>
 </ul>
 
 <p>我们内置了一些常用的数据处理类 <code>IDataPackageHandler</code> 接口为数据包处理接口，虚类 <code>DataPackageHandlerBase</code> 作为数据处理器基类已经内置了 <b>粘包</b> <b>分包</b> 的逻辑，继承此类后专注自己处理的业务即可</p>

src/BootstrapBlazor/Extensions/ITcpSocketClientExtensions.cs

@@ -0,0 +1,33 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the Apache 2.0 License
+// See the LICENSE file in the project root for more information.
+// Maintainer: Argo Zhang([email protected]) Website: https://www.blazor.zone
+
+using System.Text;
+
+namespace BootstrapBlazor.Components;
+
+/// <summary>
+/// <see cref="ITcpSocketClient"/> 扩展方法类
+/// </summary>
+public static class ITcpSocketClientExtensions
+{
+    /// <summary>
+    /// Sends the specified string content to the connected TCP socket client asynchronously.
+    /// </summary>
+    /// <remarks>This method converts the provided string content into a byte array using the specified
+    /// encoding  (or UTF-8 by default) and sends it to the connected TCP socket client. Ensure the client is connected 
+    /// before calling this method.</remarks>
+    /// <param name="client">The TCP socket client to which the content will be sent. Cannot be <see langword="null"/>.</param>
+    /// <param name="content">The string content to send. Cannot be <see langword="null"/> or empty.</param>
+    /// <param name="encoding">The character encoding to use for converting the string content to bytes.  If <see langword="null"/>, UTF-8
+    /// encoding is used by default.</param>
+    /// <param name="token">A <see cref="CancellationToken"/> to observe while waiting for the operation to complete.</param>
+    /// <returns>A <see cref="ValueTask{TResult}"/> that represents the asynchronous operation.  The result is <see
+    /// langword="true"/> if the content was sent successfully; otherwise, <see langword="false"/>.</returns>
+    public static ValueTask<bool> SendAsync(this ITcpSocketClient client, string content, Encoding? encoding = null, CancellationToken token = default)
+    {
+        var buffer = encoding?.GetBytes(content) ?? Encoding.UTF8.GetBytes(content);
+        return client.SendAsync(buffer, token);
+    }
+}

test/UnitTest/Services/TcpSocketFactoryTest.cs

@@ -6,6 +6,7 @@
 using Microsoft.Extensions.Logging;
 using System.Net;
 using System.Net.Sockets;
+using System.Text;
 
 namespace UnitTest.Services;
 
@@ -94,8 +95,7 @@ public async Task SendAsync_Cancel()
         var cst = new CancellationTokenSource();
         cst.Cancel();
 
-        var data = new ReadOnlyMemory<byte>([1, 2, 3, 4, 5]);
-        var result = await client.SendAsync(data, cst.Token);
+        var result = await client.SendAsync("test", null, cst.Token);
         Assert.False(result);
 
         // 设置延时发送适配器
@@ -110,7 +110,7 @@ public async Task SendAsync_Cancel()
         // 测试发送失败逻辑
         _ = Task.Run(async () =>
         {
-            sendResult = await client.SendAsync(data);
+            sendResult = await client.SendAsync("test", Encoding.UTF8);
             tcs.SetResult();
         });