feat: 新增 序列化器接口定义

Author: jianxuanbing

Bing.All.sln

@@ -170,6 +170,7 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "props", "props", "{D77F42E0
 		asset\props\misc.props = asset\props\misc.props
 		asset\props\package.props = asset\props\package.props
 		asset\props\sourcelink.env.props = asset\props\sourcelink.env.props
+		asset\props\target.feature.props = asset\props\target.feature.props
 	EndProjectSection
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Bing.Admin.Data.FreeSQL", "modules\admin\src\Bing.Admin.Data.FreeSQL\Bing.Admin.Data.FreeSQL.csproj", "{05DFA67F-C861-48F9-BBD9-7777972A918F}"

asset/props/target.feature.props

@@ -0,0 +1,22 @@
+<Project>
+  <PropertyGroup Condition=" '$(TargetFramework)' == 'net6.0' ">
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>disable</Nullable>
+  </PropertyGroup>
+
+  <PropertyGroup Condition=" '$(TargetFramework)' == 'net5.0' ">
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>disable</Nullable>
+  </PropertyGroup>
+
+  <PropertyGroup Condition=" '$(TargetFramework)' == 'netcoreapp3.1' ">
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>disable</Nullable>
+  </PropertyGroup>
+
+  <PropertyGroup Condition=" '$(TargetFramework)' == 'netstandard2.0' ">
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>disable</Nullable>
+  </PropertyGroup>
+
+</Project>

common.props

@@ -22,6 +22,8 @@
     <DocumentationFile>$(AssemblyName).xml</DocumentationFile>
   </PropertyGroup>
 
+  <Import Project="asset/props/target.feature.props"/>
+
   <Import Project="asset/props/sourcelink.env.props"/>
 
   <Import Project="asset/props/package.props"/>

framework/src/Bing.Abstractions/Bing.Abstractions.csproj

@@ -1,8 +1,16 @@
 <Project Sdk="Microsoft.NET.Sdk">
-  <Import Project="project.props" />
+  <PropertyGroup>
+    <TargetFrameworks>net6.0;net5.0;netcoreapp3.1;netstandard2.1;netstandard2.0;</TargetFrameworks>
+  </PropertyGroup>
 
-  <Import Project="project.dependency.props" />
+  <PropertyGroup>
+    <AssemblyName>Bing.Abstractions</AssemblyName>
+    <PackageId>Bing.Abstractions</PackageId>
+    <Description>Bing.Abstractions是Bing应用框架的核心抽象类库。</Description>
+  </PropertyGroup>
 
-  <Import Project="..\..\..\framework.props" />
+  <Import Project="dependency.props" />
+
+  <Import Project="..\..\..\common.props" />
 
 </Project>

framework/src/Bing.Abstractions/Bing/Mapping/IObjectMapper.cs

@@ -0,0 +1,8 @@
+namespace Bing.Serialization;
+
+/// <summary>
+/// Bssom 序列化器
+/// </summary>
+public interface IBssomSerializer : IObjectSerializer<byte[]>, IBytesSerializer, IStreamSerializerAsync
+{
+}

framework/src/Bing.Abstractions/Bing/Mapping/IObjectMapper`1.cs

@@ -0,0 +1,37 @@
+namespace Bing.Serialization;
+
+/// <summary>
+/// 字节数组对象序列化器元接口
+/// </summary>
+public interface IBytesSerializer : IStreamSerializer
+{
+    /// <summary>
+    /// 将字节数组反序列化为对象
+    /// </summary>
+    /// <typeparam name="TValue">对象类型</typeparam>
+    /// <param name="bytes">字节数组</param>
+    /// <returns>如果 bytes 为 null 或为空，将返回 TValue 的默认值</returns>
+    TValue FromBytes<TValue>(byte[] bytes);
+
+    /// <summary>
+    /// 将字节数组反序列化为对象
+    /// </summary>
+    /// <param name="type">对象类型</param>
+    /// <param name="bytes">字节数组</param>
+    /// <returns>如果 bytes 为 null 或为空，将返回 type 的默认值</returns>
+    object FromBytes(Type type, byte[] bytes);
+
+    /// <summary>
+    /// 序列化为字节数组
+    /// </summary>
+    /// <typeparam name="TValue">序列化对象类型</typeparam>
+    /// <param name="value">值</param>
+    byte[] ToBytes<TValue>(TValue value);
+
+    /// <summary>
+    /// 序列化为字节数组
+    /// </summary>
+    /// <param name="type">序列化对象类型</param>
+    /// <param name="value">值</param>
+    byte[] ToBytes(Type type, object value);
+}

framework/src/Bing.Abstractions/Bing/Serialization/IBssomSerializer.cs

@@ -1,7 +1,37 @@
-namespace Bing.Serialization
+namespace Bing.Serialization;
+
+/// <summary>
+/// Json 序列化器
+/// </summary>
+public interface IJsonSerializer : IObjectSerializer, ITextSerializer
 {
     /// <summary>
-    /// Json 序列化器
+    /// 将Json字符串反序列化为对象
     /// </summary>
-    public interface IJsonSerializer : IObjectSerializer { }
+    /// <typeparam name="TValue">对象类型</typeparam>
+    /// <param name="json">json字符串</param>
+    /// <returns>如果 json 为 null 或为空，将返回 TValue 的默认值</returns>
+    TValue FromJson<TValue>(string json);
+
+    /// <summary>
+    /// 将Json字符串反序列化为对象
+    /// </summary>
+    /// <param name="type">对象类型</param>
+    /// <param name="json">json字符串</param>
+    /// <returns>如果 json 为 null 或为空，将返回 type 的默认值</returns>
+    object FromJson(Type type, string json);
+
+    /// <summary>
+    /// 序列化为Json字符串
+    /// </summary>
+    /// <typeparam name="TValue">序列化对象类型</typeparam>
+    /// <param name="value">值</param>
+    string ToJson<TValue>(TValue value);
+
+    /// <summary>
+    /// 序列化为Json字符串
+    /// </summary>
+    /// <param name="type">序列化对象类型</param>
+    /// <param name="value">值</param>
+    string ToJson(Type type, object value);
 }

framework/src/Bing.Abstractions/Bing/Serialization/IBytesSerializer.cs

@@ -0,0 +1,19 @@
+namespace Bing.Serialization;
+
+/// <summary>
+/// Json 序列化器配置入口
+/// </summary>
+public interface IJsonSerializerConfigureEntry
+{
+    /// <summary>
+    /// 配置Json序列化器
+    /// </summary>
+    /// <param name="serializer">Json序列化器</param>
+    void ConfigureJsonSerializer(IJsonSerializer serializer);
+
+    /// <summary>
+    /// 配置Json序列化器
+    /// </summary>
+    /// <param name="serializerFactory">Json序列化器工厂</param>
+    void ConfigureJsonSerializer(Func<IJsonSerializer> serializerFactory);
+}