feat(SocketLogging): add SocketLogging function

src/extensions/BootstrapBlazor.Socket/BootstrapBlazor.Socket.csproj

@@ -1,18 +1,42 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
-    <Version>9.0.4</Version>
+    <Version>9.0.5</Version>
   </PropertyGroup>
 
   <PropertyGroup>
     <PackageTags>BootstrapBlazor Socket</PackageTags>
     <Description>BootstrapBlazor extensions of Socket</Description>
   </PropertyGroup>
 
+  <PropertyGroup>
+    <NET8Version>8.0.*</NET8Version>
+    <NET9Version>9.0.*</NET9Version>
+  </PropertyGroup>
+
+  <ItemGroup Condition="'$(TargetFramework)' == 'net6.0'">
+    <PackageReference Include="Microsoft.Extensions.Logging.Abstractions" Version="$(NET8Version)" />
+  </ItemGroup>
+
+  <ItemGroup Condition="'$(TargetFramework)' == 'net7.0'">
+    <PackageReference Include="Microsoft.Extensions.Logging.Abstractions" Version="$(NET8Version)" />
+  </ItemGroup>
+
+  <ItemGroup Condition="'$(TargetFramework)' == 'net8.0'">
+    <PackageReference Include="Microsoft.Extensions.Logging.Abstractions" Version="$(NET9Version)" />
+  </ItemGroup>
+
+  <ItemGroup Condition="'$(TargetFramework)' == 'net9.0'">
+    <PackageReference Include="Microsoft.Extensions.Logging.Abstractions" Version="$(NET9Version)" />
+  </ItemGroup>
+
+  <ItemGroup>
+  </ItemGroup>
+
   <ItemGroup>
-    <Using Include="BootstrapBlazor.DataAdapters" />
-    <Using Include="BootstrapBlazor.DataHandlers" />
-    <Using Include="BootstrapBlazor.DataConverters" />
+    <Using Include="BootstrapBlazor.Socket.DataAdapters" />
+    <Using Include="BootstrapBlazor.Socket.DataHandlers" />
+    <Using Include="BootstrapBlazor.Socket.DataConverters" />
   </ItemGroup>
 
 </Project>

src/extensions/BootstrapBlazor.Socket/DataAdapter/DataPackageAdapter.cs

@@ -2,7 +2,7 @@
 // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
 // Website: https://www.blazor.zone or https://argozhang.github.io/
 
-namespace BootstrapBlazor.DataAdapters;
+namespace BootstrapBlazor.Socket.DataAdapters;
 
 /// <summary>
 /// Provides a base implementation for adapting data packages between different systems or formats.

src/extensions/BootstrapBlazor.Socket/DataAdapter/IDataPackageAdapter.cs

@@ -2,7 +2,7 @@
 // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
 // Website: https://www.blazor.zone or https://argozhang.github.io/
 
-namespace BootstrapBlazor.DataAdapters;
+namespace BootstrapBlazor.Socket.DataAdapters;
 
 /// <summary>
 /// Defines an adapter for handling and transmitting data packages to a target destination.

src/extensions/BootstrapBlazor.Socket/DataConverter/BinConverter.cs

@@ -4,7 +4,7 @@
 
 using System.Text;
 
-namespace BootstrapBlazor.Components.DataConverter;
+namespace BootstrapBlazorSocket.DataConverter;
 
 /// <summary>
 /// 二进制 与 Byte 数组转换方法

src/extensions/BootstrapBlazor.Socket/DataConverter/DataConverter.cs

@@ -2,9 +2,10 @@
 // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
 // Website: https://www.blazor.zone or https://argozhang.github.io/
 
+using BootstrapBlazor.Socket.Logging;
 using System.Reflection;
 
-namespace BootstrapBlazor.DataConverters;
+namespace BootstrapBlazor.Socket.DataConverters;
 
 /// <summary>
 /// Provides a base class for converting socket data into a specified entity type.
@@ -38,7 +39,10 @@ public virtual bool TryConvertTo(ReadOnlyMemory<byte> data, [NotNullWhen(true)]
                 ret = true;
             }
         }
-        catch { }
+        catch (Exception ex)
+        {
+            SocketLogging.LogError(ex, "DataConverter TryConvertTo failed");
+        }
 
         return ret;
     }

src/extensions/BootstrapBlazor.Socket/DataConverter/DataConverterCollections.cs

@@ -6,7 +6,7 @@
 using System.Linq.Expressions;
 using System.Reflection;
 
-namespace BootstrapBlazor.DataConverters;
+namespace BootstrapBlazor.Socket.DataConverters;
 
 /// <summary>
 /// 数据转换器集合类

src/extensions/BootstrapBlazor.Socket/DataConverter/DataPropertyConverterAttribute.cs

@@ -2,7 +2,7 @@
 // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
 // Website: https://www.blazor.zone or https://argozhang.github.io/
 
-namespace BootstrapBlazor.DataConverters;
+namespace BootstrapBlazor.Socket.DataConverters;
 
 /// <summary>
 /// Represents an attribute used to mark a field as a socket data field.

src/extensions/BootstrapBlazor.Socket/DataConverter/DataTypeConverterAttribute.cs

@@ -2,7 +2,7 @@
 // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
 // Website: https://www.blazor.zone or https://argozhang.github.io/
 
-namespace BootstrapBlazor.DataConverters;
+namespace BootstrapBlazor.Socket.DataConverters;
 
 /// <summary>
 /// 

src/extensions/BootstrapBlazor.Socket/DataConverter/HexConverter.cs

@@ -2,7 +2,7 @@
 // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
 // Website: https://www.blazor.zone or https://argozhang.github.io/
 
-namespace BootstrapBlazor.Components.DataConverter;
+namespace BootstrapBlazor.Socket.DataConverter;
 
 /// <summary>
 /// 十六进制 与 Byte 数组转换方法

src/extensions/BootstrapBlazor.Socket/DataConverter/IDataConverter.cs

@@ -2,7 +2,7 @@
 // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
 // Website: https://www.blazor.zone or https://argozhang.github.io/
 
-namespace BootstrapBlazor.DataConverters;
+namespace BootstrapBlazor.Socket.DataConverters;
 
 /// <summary>
 /// Socket 数据转换器接口

src/extensions/BootstrapBlazor.Socket/DataHandler/DataPackageHandlerBase.cs

@@ -2,7 +2,7 @@
 // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
 // Website: https://www.blazor.zone or https://argozhang.github.io/
 
-namespace BootstrapBlazor.DataHandlers;
+namespace BootstrapBlazor.Socket.DataHandlers;
 
 /// <summary>
 /// Provides a base implementation for handling data packages in a communication system.

src/extensions/BootstrapBlazor.Socket/DataHandler/DelimiterDataPackageHandler.cs

@@ -5,7 +5,7 @@
 using System.Buffers;
 using System.Text;
 
-namespace BootstrapBlazor.DataHandlers;
+namespace BootstrapBlazor.Socket.DataHandlers;
 
 /// <summary>
 /// Handles data packages that are delimited by a specific sequence of bytes or characters.

src/extensions/BootstrapBlazor.Socket/DataHandler/FixLengthDataPackageHandler.cs

@@ -2,7 +2,7 @@
 // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
 // Website: https://www.blazor.zone or https://argozhang.github.io/
 
-namespace BootstrapBlazor.DataHandlers;
+namespace BootstrapBlazor.Socket.DataHandlers;
 
 /// <summary>
 /// Handles fixed-length data packages by processing incoming data of a specified length.

src/extensions/BootstrapBlazor.Socket/DataHandler/IDataPackageHandler.cs

@@ -2,7 +2,7 @@
 // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
 // Website: https://www.blazor.zone or https://argozhang.github.io/
 
-namespace BootstrapBlazor.DataHandlers;
+namespace BootstrapBlazor.Socket.DataHandlers;
 
 /// <summary>
 /// Defines an interface for adapting data packages to and from a TCP socket connection.

src/extensions/BootstrapBlazor.Socket/Extensions/DataPropertyExtensions.cs

@@ -2,7 +2,7 @@
 // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
 // Website: https://www.blazor.zone or https://argozhang.github.io/
 
-namespace BootstrapBlazor.DataConverters;
+namespace BootstrapBlazor.Socket.DataConverters;
 
 static class DataPropertyExtensions
 {

src/extensions/BootstrapBlazor.Socket/Logging/SocketLogging.cs

@@ -0,0 +1,44 @@
+// Copyright (c) BootstrapBlazor & Argo Zhang (argo@live.ca). All rights reserved.
+// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
+// Website: https://www.blazor.zone or https://argozhang.github.io/
+
+using Microsoft.Extensions.Logging;
+
+namespace BootstrapBlazor.Socket.Logging;
+
+/// <summary>
+/// Socket 日志记录类
+/// </summary>
+public static class SocketLogging
+{
+    private static ILogger? _logger;
+    private static bool _inited;
+
+    /// <summary>
+    /// 返回 是否已经初始化
+    /// </summary>
+    public static bool Inited => _inited;
+
+    /// <summary>
+    /// 初始化 ILogger 实例
+    /// </summary>
+    /// <param name="logger"></param>
+    public static void Init(ILogger logger)
+    {
+        _inited = true;
+        _logger = logger;
+    }
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="message"></param>
+    public static void LogError(string message) => _logger?.LogError(message);
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="ex"></param>
+    /// <param name="message"></param>
+    public static void LogError(Exception ex, string? message) => _logger?.LogError(ex, message);
+}

src/extensions/BootstrapBlazor.Socket/PropertyConverter/DataBoolConverter.cs

@@ -2,7 +2,7 @@
 // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
 // Website: https://www.blazor.zone or https://argozhang.github.io/
 
-namespace BootstrapBlazor.DataConverters;
+namespace BootstrapBlazor.Socket.DataConverters;
 
 /// <summary>
 /// Sokcet 数据转换为 bool 数据转换器

src/extensions/BootstrapBlazor.Socket/PropertyConverter/DataByteArrayConverter.cs

@@ -2,7 +2,7 @@
 // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
 // Website: https://www.blazor.zone or https://argozhang.github.io/
 
-namespace BootstrapBlazor.DataConverters;
+namespace BootstrapBlazor.Socket.DataConverters;
 
 /// <summary>
 /// Sokcet 数据转换为 byte[] 数组转换器

src/extensions/BootstrapBlazor.Socket/PropertyConverter/DataDoubleBigEndianConverter.cs

@@ -4,7 +4,7 @@
 
 using System.Buffers.Binary;
 
-namespace BootstrapBlazor.DataConverters;
+namespace BootstrapBlazor.Socket.DataConverters;
 
 /// <summary>
 /// Sokcet 数据转换为 double 数据大端转换器

src/extensions/BootstrapBlazor.Socket/PropertyConverter/DataDoubleLittleEndianConverter.cs

@@ -4,7 +4,7 @@
 
 using System.Buffers.Binary;
 
-namespace BootstrapBlazor.DataConverters;
+namespace BootstrapBlazor.Socket.DataConverters;
 
 /// <summary>
 /// Sokcet 数据转换为 double 数据小端转换器

src/extensions/BootstrapBlazor.Socket/PropertyConverter/DataEnumConverter.cs

@@ -2,7 +2,7 @@
 // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
 // Website: https://www.blazor.zone or https://argozhang.github.io/
 
-namespace BootstrapBlazor.DataConverters;
+namespace BootstrapBlazor.Socket.DataConverters;
 
 /// <summary>
 /// Sokcet 数据转换为 Enum 数据转换器

src/extensions/BootstrapBlazor.Socket/PropertyConverter/DataInt16BigEndianConverter.cs

@@ -4,7 +4,7 @@
 
 using System.Buffers.Binary;
 
-namespace BootstrapBlazor.DataConverters;
+namespace BootstrapBlazor.Socket.DataConverters;
 
 /// <summary>
 /// Sokcet 数据转换为 short 数据大端转换器

src/extensions/BootstrapBlazor.Socket/PropertyConverter/DataInt16LittleEndianConverter.cs

@@ -4,7 +4,7 @@
 
 using System.Buffers.Binary;
 
-namespace BootstrapBlazor.DataConverters;
+namespace BootstrapBlazor.Socket.DataConverters;
 
 /// <summary>
 /// Sokcet 数据转换为 short 数据小端转换器

src/extensions/BootstrapBlazor.Socket/PropertyConverter/DataInt32BigEndianConverter.cs

@@ -4,7 +4,7 @@
 
 using System.Buffers.Binary;
 
-namespace BootstrapBlazor.DataConverters;
+namespace BootstrapBlazor.Socket.DataConverters;
 
 /// <summary>
 /// Sokcet 数据转换为 int 数据大端转换器

src/extensions/BootstrapBlazor.Socket/PropertyConverter/DataInt32LittleEndianConverter.cs

@@ -4,7 +4,7 @@
 
 using System.Buffers.Binary;
 
-namespace BootstrapBlazor.DataConverters;
+namespace BootstrapBlazor.Socket.DataConverters;
 
 /// <summary>
 /// Sokcet 数据转换为 int 数据小端转换器

src/extensions/BootstrapBlazor.Socket/PropertyConverter/DataInt64BigEndianConverter.cs

@@ -4,7 +4,7 @@
 
 using System.Buffers.Binary;
 
-namespace BootstrapBlazor.DataConverters;
+namespace BootstrapBlazor.Socket.DataConverters;
 
 /// <summary>
 /// Sokcet 数据转换为 long 数据大端转换器

src/extensions/BootstrapBlazor.Socket/PropertyConverter/DataInt64LittleEndianConverter.cs

@@ -4,7 +4,7 @@
 
 using System.Buffers.Binary;
 
-namespace BootstrapBlazor.DataConverters;
+namespace BootstrapBlazor.Socket.DataConverters;
 
 /// <summary>
 /// Sokcet 数据转换为 long 数据小端转换器

src/extensions/BootstrapBlazor.Socket/PropertyConverter/DataSingleBigEndianConverter.cs

@@ -4,7 +4,7 @@
 
 using System.Buffers.Binary;
 
-namespace BootstrapBlazor.DataConverters;
+namespace BootstrapBlazor.Socket.DataConverters;
 
 /// <summary>
 /// Sokcet 数据转换为 float 数据大端转换器

src/extensions/BootstrapBlazor.Socket/PropertyConverter/DataSingleLittleEndianConverter.cs

@@ -4,7 +4,7 @@
 
 using System.Buffers.Binary;
 
-namespace BootstrapBlazor.DataConverters;
+namespace BootstrapBlazor.Socket.DataConverters;
 
 /// <summary>
 /// Sokcet 数据转换为 float 数据小端转换器

src/extensions/BootstrapBlazor.Socket/PropertyConverter/DataStringConverter.cs

@@ -4,7 +4,7 @@
 
 using System.Text;
 
-namespace BootstrapBlazor.DataConverters;
+namespace BootstrapBlazor.Socket.DataConverters;
 
 /// <summary>
 /// Sokcet 数据转换为 string 数据转换器

src/extensions/BootstrapBlazor.Socket/PropertyConverter/DataUInt16BigEndianConverter.cs

@@ -4,7 +4,7 @@
 
 using System.Buffers.Binary;
 
-namespace BootstrapBlazor.DataConverters;
+namespace BootstrapBlazor.Socket.DataConverters;
 
 /// <summary>
 /// Sokcet 数据转换为 ushort 数据大端转换器

src/extensions/BootstrapBlazor.Socket/PropertyConverter/DataUInt16LittleEndianConverter.cs

@@ -4,7 +4,7 @@
 
 using System.Buffers.Binary;
 
-namespace BootstrapBlazor.DataConverters;
+namespace BootstrapBlazor.Socket.DataConverters;
 
 /// <summary>
 /// Sokcet 数据转换为 ushort 数据小端转换器

src/extensions/BootstrapBlazor.Socket/PropertyConverter/DataUInt32BigEndianConverter.cs

@@ -4,7 +4,7 @@
 
 using System.Buffers.Binary;
 
-namespace BootstrapBlazor.DataConverters;
+namespace BootstrapBlazor.Socket.DataConverters;
 
 /// <summary>
 /// Sokcet 数据转换为 uint 数据大端转换器

src/extensions/BootstrapBlazor.Socket/PropertyConverter/DataUInt32LittleEndianConverter.cs

@@ -4,7 +4,7 @@
 
 using System.Buffers.Binary;
 
-namespace BootstrapBlazor.DataConverters;
+namespace BootstrapBlazor.Socket.DataConverters;
 
 /// <summary>
 /// Sokcet 数据转换为 uint 数据小端转换器