refactor: 增加 SocketClient 基类

Author: ArgoZhang

src/BootstrapBlazor/Services/TcpSocket/DefaultTcpSocketClient.cs

@@ -9,7 +9,7 @@
 namespace BootstrapBlazor.Components;
 
 [UnsupportedOSPlatform("browser")]
-sealed class DefaultTcpSocketClient : TcpSocketClientBase<DefaultSocketClient>
+sealed class DefaultTcpSocketClient : TcpSocketClientBase<SocketClientBase>
 {
     public DefaultTcpSocketClient(SocketClientOptions options)
     {
@@ -27,9 +27,8 @@ public DefaultTcpSocketClient(SocketClientOptions options)
     /// <param name="localEndPoint"></param>
     /// <returns></returns>
     /// <exception cref="NotImplementedException"></exception>
-    protected override DefaultSocketClient CreateSocketClient(IPEndPoint? localEndPoint)
+    protected override SocketClientBase CreateSocketClient(IPEndPoint localEndPoint)
     {
-        localEndPoint ??= new IPEndPoint(IPAddress.Loopback, 0);
-        return new DefaultSocketClient(localEndPoint);
+        return new SocketClientBase(localEndPoint);
     }
 }

src/BootstrapBlazor/Services/TcpSocket/ISocketClient.cs

@@ -28,7 +28,7 @@ public interface ISocketClient
     /// <remarks>This property provides information about the local endpoint of the socket, which is typically
     /// used to identify the local address and port being used for communication. If the socket is not  bound to a
     /// specific local endpoint, this property may return <see langword="null"/>.</remarks>
-    IPEndPoint? LocalEndPoint { get; }
+    IPEndPoint LocalEndPoint { get; }
 
     /// <summary>
     /// Establishes an asynchronous connection to the specified endpoint.

src/BootstrapBlazor/Services/TcpSocket/ITcpSocketClient.cs

@@ -53,7 +53,7 @@ public interface ITcpSocketClient : IAsyncDisposable
     /// <remarks>This property provides information about the local endpoint of the socket, which is typically
     /// used to identify the local address and port being used for communication. If the socket is not  bound to a
     /// specific local endpoint, this property may return <see langword="null"/>.</remarks>
-    IPEndPoint? LocalEndPoint { get; }
+    IPEndPoint LocalEndPoint { get; }
 
     /// <summary>
     /// Gets or sets the callback function to handle received data.

src/BootstrapBlazor/Services/TcpSocket/DefaultSocketClient.cs renamed to src/BootstrapBlazor/Services/TcpSocket/SocketClientBase.cs

@@ -13,21 +13,33 @@ namespace BootstrapBlazor.Components;
 /// TcpSocket 客户端默认实现
 /// </summary>
 [UnsupportedOSPlatform("browser")]
-class DefaultSocketClient(IPEndPoint localEndPoint) : ISocketClient
+public class SocketClientBase(IPEndPoint localEndPoint) : ISocketClient
 {
     private TcpClient? _client;
 
+    /// <summary>
+    /// <inheritdoc/>
+    /// </summary>
     public bool IsConnected => _client?.Connected ?? false;
 
-    public IPEndPoint? LocalEndPoint { get; set; }
+    /// <summary>
+    /// <inheritdoc/>
+    /// </summary>
+    public IPEndPoint LocalEndPoint { get; set; } = new IPEndPoint(IPAddress.Loopback, 0);
 
+    /// <summary>
+    /// <inheritdoc/>
+    /// </summary>
     public async ValueTask<bool> ConnectAsync(IPEndPoint endPoint, CancellationToken token = default)
     {
         _client = new TcpClient(localEndPoint);
         await _client.ConnectAsync(endPoint, token);
         return _client.Connected;
     }
 
+    /// <summary>
+    /// <inheritdoc/>
+    /// </summary>
     public async ValueTask<bool> SendAsync(ReadOnlyMemory<byte> data, CancellationToken token = default)
     {
         var ret = false;
@@ -40,6 +52,9 @@ public async ValueTask<bool> SendAsync(ReadOnlyMemory<byte> data, CancellationTo
         return ret;
     }
 
+    /// <summary>
+    /// <inheritdoc/>
+    /// </summary>
     public async ValueTask<int> ReceiveAsync(Memory<byte> buffer, CancellationToken token = default)
     {
         var len = 0;
@@ -51,6 +66,9 @@ public async ValueTask<int> ReceiveAsync(Memory<byte> buffer, CancellationToken
         return len;
     }
 
+    /// <summary>
+    /// <inheritdoc/>
+    /// </summary>
     public ValueTask CloseAsync()
     {
         if (_client != null)

src/BootstrapBlazor/Services/TcpSocket/SocketClientOptions.cs

@@ -46,8 +46,8 @@ public class SocketClientOptions
     public int ReceiveTimeout { get; set; }
 
     /// <summary>
-    /// Gets or sets the local endpoint for the socket client.
+    /// Gets or sets the local endpoint for the socket client. Default value is <see cref="IPAddress.Loopback"/>
     /// </summary>
     /// <remarks>This property specifies the local network endpoint that the socket client will bind to when establishing a connection.</remarks>
-    public IPEndPoint? LocalEndPoint { get; set; }
+    public IPEndPoint LocalEndPoint { get; set; } = new IPEndPoint(IPAddress.Loopback, 0);
 }

src/BootstrapBlazor/Services/TcpSocket/TcpSocketClientBase.cs

@@ -36,7 +36,7 @@ public abstract class TcpSocketClientBase<TSocketClient> : ITcpSocketClient wher
     /// <summary>
     /// <inheritdoc/>
     /// </summary>
-    public IPEndPoint? LocalEndPoint { get; set; }
+    public IPEndPoint LocalEndPoint { get; set; } = new IPEndPoint(IPAddress.Loopback, 0);
 
     /// <summary>
     /// <inheritdoc/>
@@ -82,7 +82,7 @@ public abstract class TcpSocketClientBase<TSocketClient> : ITcpSocketClient wher
     /// </summary>
     /// <param name="localEndPoint">The network endpoint to which the socket client will connect. Cannot be null.</param>
     /// <returns>An instance of <typeparamref name="TSocketClient"/> configured for the specified endpoint.</returns>
-    protected abstract TSocketClient CreateSocketClient(IPEndPoint? localEndPoint);
+    protected abstract TSocketClient CreateSocketClient(IPEndPoint localEndPoint);
 
     /// <summary>
     /// <inheritdoc/>