Merge pull request #13 from The-Standard-Organization/users/cjdutoit/…

…exposers-abstraction-providers EXPOSERS: Interface changes to support type restrictions for STRING, BYTE[], STREAM
The-Standard-Organization · Mar 23, 2024 · bce8d3e · bce8d3e
2 parents 4253fef + 7e359f9
commit bce8d3e
Show file tree

Hide file tree

Showing 11 changed files with 70 additions and 208 deletions.
diff --git a/STX.Serialization.Providers.Abstractions.sln b/STX.Serialization.Providers.Abstractions.sln
@@ -3,14 +3,10 @@ Microsoft Visual Studio Solution File, Format Version 12.00
 # Visual Studio Version 17
 VisualStudioVersion = 17.8.34511.84
 MinimumVisualStudioVersion = 10.0.40219.1
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "STX.Serialization.Providers.Abstractions", "STX.Serialization.Providers.Abstractions\STX.Serialization.Providers.Abstractions.csproj", "{38A8052D-3C6E-44DC-ACEB-AA28881C5CD5}"
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "STX.Serialization.Providers.Abstractions", "STX.Serialization.Providers.Abstractions\STX.Serialization.Providers.Abstractions.csproj", "{38A8052D-3C6E-44DC-ACEB-AA28881C5CD5}"
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "STX.Serialization.Providers.Abstractions.Infrastructure.Build", "STX.Serialization.Providers.Abstractions.Infrastructure.Build\STX.Serialization.Providers.Abstractions.Infrastructure.Build.csproj", "{D47D1D45-BD43-4735-BFB5-83296B2941A5}"
 EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "STX.Serialization.Providers.Abstractions.Tests.Acceptance", "STX.Serialization.Providers.Abstractions.Tests.Acceptance\STX.Serialization.Providers.Abstractions.Tests.Acceptance.csproj", "{A3E3CBE6-74E2-4196-94E1-F4238C36639E}"
-EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "STX.Serialization.Providers.Abstractions.Tests.Unit", "STX.Serialization.Providers.Abstractions.Tests.Unit\STX.Serialization.Providers.Abstractions.Tests.Unit.csproj", "{270ECD52-7950-448E-BA0B-55C6A30117FD}"
-EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -25,14 +21,6 @@ Global
 		{D47D1D45-BD43-4735-BFB5-83296B2941A5}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{D47D1D45-BD43-4735-BFB5-83296B2941A5}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{D47D1D45-BD43-4735-BFB5-83296B2941A5}.Release|Any CPU.Build.0 = Release|Any CPU
-		{A3E3CBE6-74E2-4196-94E1-F4238C36639E}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{A3E3CBE6-74E2-4196-94E1-F4238C36639E}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{A3E3CBE6-74E2-4196-94E1-F4238C36639E}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{A3E3CBE6-74E2-4196-94E1-F4238C36639E}.Release|Any CPU.Build.0 = Release|Any CPU
-		{270ECD52-7950-448E-BA0B-55C6A30117FD}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{270ECD52-7950-448E-BA0B-55C6A30117FD}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{270ECD52-7950-448E-BA0B-55C6A30117FD}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{270ECD52-7950-448E-BA0B-55C6A30117FD}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE

diff --git a/STX.Serialization.Providers.Abstractions/ISerializationAbstractionProvider.cs b/STX.Serialization.Providers.Abstractions/ISerializationAbstractionProvider.cs
@@ -2,13 +2,8 @@
 // Copyright (c) The Standard Organization: A coalition of the Good-Hearted Engineers
 // ----------------------------------------------------------------------------------
 
-using System.Threading.Tasks;
-
 namespace STX.Serialization.Providers.Abstractions
 {
-    public interface ISerializationAbstractionProvider
-    {
-        ValueTask<string> Serialize<T>(T @object);
-        ValueTask<T> Deserialize<T>(string json);
-    }
+    public interface ISerializationAbstractionProvider : ISerializationOperations
+    { }
 }
diff --git a/STX.Serialization.Providers.Abstractions/ISerializationOperations.cs b/STX.Serialization.Providers.Abstractions/ISerializationOperations.cs
@@ -0,0 +1,19 @@
+// ----------------------------------------------------------------------------------
+// Copyright (c) The Standard Organization: A coalition of the Good-Hearted Engineers
+// ----------------------------------------------------------------------------------
+
+using System.IO;
+using System.Threading.Tasks;
+using STX.Serialization.Providers.Abstractions.Models;
+
+namespace STX.Serialization.Providers.Abstractions
+{
+    public interface ISerializationOperations
+    {
+        ValueTask<TOutput> Serialize<TInput, TOutput>(TInput @object)
+            where TOutput : IDataRepresentation<string>, IDataRepresentation<byte[]>, IDataRepresentation<Stream>;
+
+        ValueTask<TOutput> Deserialize<TInput, TOutput>(TInput json)
+            where TInput : IDataRepresentation<string>, IDataRepresentation<byte[]>, IDataRepresentation<Stream>;
+    }
+}
diff --git a/STX.Serialization.Providers.Abstractions/ISerializationProvider.cs b/STX.Serialization.Providers.Abstractions/ISerializationProvider.cs
@@ -6,9 +6,6 @@
 
 namespace STX.Serialization.Providers.Abstractions
 {
-    public interface ISerializationProvider
-    {
-        ValueTask<string> Serialize<T>(T @object);
-        ValueTask<T> Deserialize<T>(string json);
-    }
+    public interface ISerializationProvider : ISerializationOperations
+    { }
 }
diff --git a/STX.Serialization.Providers.Abstractions/Models/ByteArrayData.cs b/STX.Serialization.Providers.Abstractions/Models/ByteArrayData.cs
@@ -0,0 +1,11 @@
+// ----------------------------------------------------------------------------------
+// Copyright (c) The Standard Organization: A coalition of the Good-Hearted Engineers
+// ----------------------------------------------------------------------------------
+
+namespace STX.Serialization.Providers.Abstractions.Models
+{
+    public class ByteArrayData : IDataRepresentation<byte[]>
+    {
+        public byte[] Value { get; set; }
+    }
+}
diff --git a/STX.Serialization.Providers.Abstractions/Models/IDataRepresentation.cs b/STX.Serialization.Providers.Abstractions/Models/IDataRepresentation.cs
@@ -0,0 +1,11 @@
+// ----------------------------------------------------------------------------------
+// Copyright (c) The Standard Organization: A coalition of the Good-Hearted Engineers
+// ----------------------------------------------------------------------------------
+
+namespace STX.Serialization.Providers.Abstractions.Models
+{
+    public interface IDataRepresentation<T>
+    {
+        T Value { get; set; }
+    }
+}
diff --git a/STX.Serialization.Providers.Abstractions/Models/StreamData.cs b/STX.Serialization.Providers.Abstractions/Models/StreamData.cs
@@ -0,0 +1,13 @@
+// ----------------------------------------------------------------------------------
+// Copyright (c) The Standard Organization: A coalition of the Good-Hearted Engineers
+// ----------------------------------------------------------------------------------
+
+using System.IO;
+
+namespace STX.Serialization.Providers.Abstractions.Models
+{
+    public class StreamData : IDataRepresentation<Stream>
+    {
+        public Stream Value { get; set; }
+    }
+}
diff --git a/STX.Serialization.Providers.Abstractions/Models/StringData.cs b/STX.Serialization.Providers.Abstractions/Models/StringData.cs
@@ -0,0 +1,11 @@
+// ----------------------------------------------------------------------------------
+// Copyright (c) The Standard Organization: A coalition of the Good-Hearted Engineers
+// ----------------------------------------------------------------------------------
+
+namespace STX.Serialization.Providers.Abstractions.Models
+{
+    public class StringData : IDataRepresentation<string>
+    {
+        public string Value { get; set; }
+    }
+}
diff --git a/STX.Serialization.Providers.Abstractions/SerializationAbstractionProvider.Exceptions.cs b/STX.Serialization.Providers.Abstractions/SerializationAbstractionProvider.Exceptions.cs
diff --git a/STX.Serialization.Providers.Abstractions/SerializationAbstractionProvider.Validations.cs b/STX.Serialization.Providers.Abstractions/SerializationAbstractionProvider.Validations.cs
diff --git a/STX.Serialization.Providers.Abstractions/SerializationAbstractionProvider.cs b/STX.Serialization.Providers.Abstractions/SerializationAbstractionProvider.cs