Basic layout persistence implementation.

Author: fhubi

src/layout-persistence/dotnet/LayoutPersistence.sln

@@ -0,0 +1,39 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 17
+VisualStudioVersion = 17.9.34723.18
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "MorganStanley.ComposeUI.LayoutPersistence", "src\MorganStanley.ComposeUI.LayoutPersistence\MorganStanley.ComposeUI.LayoutPersistence.csproj", "{BC4F5C92-F894-45A7-BBEA-A956F89C617B}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "src", "src", "{15375C6D-AEF5-42DA-B809-36C55A5133B0}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "tests", "tests", "{387B5C73-2D89-45B1-92E0-71CDBB825F46}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "MorganStanley.ComposeUI.LayoutPersistence.Tests", "tests\MorganStanley.ComposeUI.LayoutPersistence.Tests\MorganStanley.ComposeUI.LayoutPersistence.Tests.csproj", "{9727D812-2697-4BB5-8C65-80774842FE99}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Release|Any CPU = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{BC4F5C92-F894-45A7-BBEA-A956F89C617B}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{BC4F5C92-F894-45A7-BBEA-A956F89C617B}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{BC4F5C92-F894-45A7-BBEA-A956F89C617B}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{BC4F5C92-F894-45A7-BBEA-A956F89C617B}.Release|Any CPU.Build.0 = Release|Any CPU
+		{9727D812-2697-4BB5-8C65-80774842FE99}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{9727D812-2697-4BB5-8C65-80774842FE99}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{9727D812-2697-4BB5-8C65-80774842FE99}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{9727D812-2697-4BB5-8C65-80774842FE99}.Release|Any CPU.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(NestedProjects) = preSolution
+		{BC4F5C92-F894-45A7-BBEA-A956F89C617B} = {15375C6D-AEF5-42DA-B809-36C55A5133B0}
+		{9727D812-2697-4BB5-8C65-80774842FE99} = {387B5C73-2D89-45B1-92E0-71CDBB825F46}
+	EndGlobalSection
+	GlobalSection(ExtensibilityGlobals) = postSolution
+		SolutionGuid = {5AC4D360-3DCE-47E1-8128-C76C86113476}
+	EndGlobalSection
+EndGlobal

src/layout-persistence/dotnet/src/MorganStanley.ComposeUI.LayoutPersistence/Abstractions/ILayoutPersistence.cs

@@ -0,0 +1,21 @@
+/*
+ * Morgan Stanley makes this available to you under the Apache License,
+ * Version 2.0 (the "License"). You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0.
+ *
+ * See the NOTICE file distributed with this work for additional information
+ * regarding copyright ownership. Unless required by applicable law or agreed
+ * to in writing, software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions
+ * and limitations under the License.
+ */
+
+namespace MorganStanley.ComposeUI.LayoutPersistence.Abstractions;
+
+public interface ILayoutPersistence
+{
+    Task SaveLayoutAsync(string layoutData, string layoutName, CancellationToken cancellationToken = default);
+    Task<string> LoadLayoutAsync(string layoutName, CancellationToken cancellationToken = default);
+}

src/layout-persistence/dotnet/src/MorganStanley.ComposeUI.LayoutPersistence/Abstractions/ILayoutSerializer.cs

@@ -0,0 +1,21 @@
+/*
+ * Morgan Stanley makes this available to you under the Apache License,
+ * Version 2.0 (the "License"). You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0.
+ *
+ * See the NOTICE file distributed with this work for additional information
+ * regarding copyright ownership. Unless required by applicable law or agreed
+ * to in writing, software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions
+ * and limitations under the License.
+ */
+
+namespace MorganStanley.ComposeUI.LayoutPersistence.Abstractions;
+
+public interface ILayoutSerializer
+{
+    Task<string> SerializeAsync<T>(T layoutObject, CancellationToken cancellationToken = default);
+    Task<T?> DeserializeAsync<T>(string layoutData, CancellationToken cancellationToken = default);
+}

src/layout-persistence/dotnet/src/MorganStanley.ComposeUI.LayoutPersistence/FileLayoutPersistence.cs

@@ -0,0 +1,101 @@
+/*
+ * Morgan Stanley makes this available to you under the Apache License,
+ * Version 2.0 (the "License"). You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0.
+ *
+ * See the NOTICE file distributed with this work for additional information
+ * regarding copyright ownership. Unless required by applicable law or agreed
+ * to in writing, software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions
+ * and limitations under the License.
+ */
+
+using MorganStanley.ComposeUI.LayoutPersistence.Abstractions;
+
+namespace MorganStanley.ComposeUI.LayoutPersistence;
+
+public class FileLayoutPersistence : ILayoutPersistence
+{
+    private readonly string _basePath;
+    private readonly SemaphoreSlim _semaphore = new(1,1);
+
+    public FileLayoutPersistence(string basePath)
+    {
+        _basePath = NormalizeFilePath(basePath);
+
+        try
+        {
+            if (!Directory.Exists(_basePath))
+            {
+                Directory.CreateDirectory(_basePath);
+            }
+        }
+        catch (Exception ex)
+        {
+            throw new IOException($"Failed to create or access the directory: {_basePath}.", ex);
+        }
+    }
+
+    public async Task SaveLayoutAsync(string layoutData, string layoutName, CancellationToken cancellationToken = default)
+    {
+        var filePath = GetFilePath(layoutName);
+
+        await _semaphore.WaitAsync(cancellationToken);
+
+        try
+        {
+            await File.WriteAllTextAsync(filePath, layoutData, cancellationToken);
+        }
+        catch (Exception ex)
+        {
+            throw new IOException($"Failed to save layout to file: {filePath}.", ex);
+        }
+        finally 
+        {
+            _semaphore.Release();
+        }
+    }
+
+    public async Task<string> LoadLayoutAsync(string layoutName, CancellationToken cancellationToken = default)
+    {
+        var filePath = GetFilePath(layoutName);
+
+        await _semaphore.WaitAsync(cancellationToken);
+
+        if (!File.Exists(filePath))
+        {
+            throw new FileNotFoundException($"Layout file not found: {filePath}");
+        }
+
+        try
+        {
+            return await File.ReadAllTextAsync(filePath, cancellationToken);
+        }
+        catch (Exception ex)
+        {
+            throw new IOException($"Failed to load layout from file: {filePath}.", ex);
+        }
+        finally
+        { 
+            _semaphore.Release(); 
+        }
+    }
+
+    private string GetFilePath(string layoutName)
+    {
+        return Path.Combine(_basePath, $"{layoutName}.layout");
+    }
+
+    private static string NormalizeFilePath(string path)
+    {
+        if (path.StartsWith("file://", StringComparison.OrdinalIgnoreCase))
+        {
+            var normalizedPath = Uri.UnescapeDataString(path[7..]);
+            return Path.GetFullPath(normalizedPath);
+        }
+
+        return Path.GetFullPath(path);
+    }
+}

src/layout-persistence/dotnet/src/MorganStanley.ComposeUI.LayoutPersistence/LayoutManager.cs

@@ -0,0 +1,41 @@
+/*
+ * Morgan Stanley makes this available to you under the Apache License,
+ * Version 2.0 (the "License"). You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0.
+ *
+ * See the NOTICE file distributed with this work for additional information
+ * regarding copyright ownership. Unless required by applicable law or agreed
+ * to in writing, software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions
+ * and limitations under the License.
+ */
+
+using MorganStanley.ComposeUI.LayoutPersistence.Abstractions;
+
+namespace MorganStanley.ComposeUI.LayoutPersistence;
+
+public class LayoutManager
+{
+    private readonly ILayoutPersistence _layoutPersistence;
+    private readonly ILayoutSerializer _serializer;
+
+    public LayoutManager(ILayoutPersistence layoutPersistence, ILayoutSerializer serializer)
+    {
+        _layoutPersistence = layoutPersistence;
+        _serializer = serializer;
+    }
+
+    public async Task SaveLayoutAsync<T>(T layoutObject, string layoutName)
+    {
+        var serializedData = await _serializer.SerializeAsync(layoutObject);
+        await _layoutPersistence.SaveLayoutAsync(serializedData, layoutName);
+    }
+
+    public async Task<T?> LoadLayoutAsync<T>(string layoutName)
+    {
+        var serializedData = await _layoutPersistence.LoadLayoutAsync(layoutName);
+        return await _serializer.DeserializeAsync<T>(serializedData);
+    }
+}

src/layout-persistence/dotnet/src/MorganStanley.ComposeUI.LayoutPersistence/MorganStanley.ComposeUI.LayoutPersistence.csproj

@@ -0,0 +1,9 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net6.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+  </PropertyGroup>
+
+</Project>

src/layout-persistence/dotnet/src/MorganStanley.ComposeUI.LayoutPersistence/Serializers/JsonLayoutSerializer.cs

@@ -0,0 +1,53 @@
+/*
+ * Morgan Stanley makes this available to you under the Apache License,
+ * Version 2.0 (the "License"). You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0.
+ *
+ * See the NOTICE file distributed with this work for additional information
+ * regarding copyright ownership. Unless required by applicable law or agreed
+ * to in writing, software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions
+ * and limitations under the License.
+ */
+
+using System.Text;
+using System.Text.Json;
+using MorganStanley.ComposeUI.LayoutPersistence.Abstractions;
+
+namespace MorganStanley.ComposeUI.LayoutPersistence.Serializers;
+
+public class JsonLayoutSerializer : ILayoutSerializer
+{
+    private readonly JsonSerializerOptions? _jsonSerializerOptions;
+
+    public JsonLayoutSerializer(JsonSerializerOptions? jsonSerializerOptions = null)
+    {
+        _jsonSerializerOptions = jsonSerializerOptions;
+    }
+
+    public async Task<string> SerializeAsync<T>(T layoutObject, CancellationToken cancellationToken = default)
+    {
+        if (layoutObject == null)
+        {
+            throw new ArgumentNullException(nameof(layoutObject), "The layout object to serialize cannot be null.");
+        }
+
+        using var stream = new MemoryStream();
+        await JsonSerializer.SerializeAsync(stream, layoutObject, _jsonSerializerOptions, cancellationToken);
+
+        return Encoding.UTF8.GetString(stream.ToArray());
+    }
+
+    public async Task<T?> DeserializeAsync<T>(string layoutData, CancellationToken cancellationToken = default)
+    {
+        if (string.IsNullOrWhiteSpace(layoutData))
+        {
+            throw new ArgumentException("The layout data cannot be null or empty.", nameof(layoutData));
+        }
+
+        using var stream = new MemoryStream(Encoding.UTF8.GetBytes(layoutData));
+        return await JsonSerializer.DeserializeAsync<T>(stream, _jsonSerializerOptions, cancellationToken);
+    }
+}

src/layout-persistence/dotnet/src/MorganStanley.ComposeUI.LayoutPersistence/Serializers/XmlLayoutSerializer.cs

@@ -0,0 +1,65 @@
+/*
+ * Morgan Stanley makes this available to you under the Apache License,
+ * Version 2.0 (the "License"). You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0.
+ *
+ * See the NOTICE file distributed with this work for additional information
+ * regarding copyright ownership. Unless required by applicable law or agreed
+ * to in writing, software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions
+ * and limitations under the License.
+ */
+
+using MorganStanley.ComposeUI.LayoutPersistence.Abstractions;
+using System.Text;
+using System.Text.Json;
+using System.Xml.Serialization;
+
+namespace MorganStanley.ComposeUI.LayoutPersistence.Serializers;
+
+public class XmlLayoutSerializer : ILayoutSerializer
+{
+    public async Task<string> SerializeAsync<T>(T layoutObject, CancellationToken cancellationToken = default)
+    {
+        if (layoutObject == null)
+        {
+            throw new ArgumentNullException(nameof(layoutObject), "The layout object to serialize cannot be null.");
+        }
+
+        using var stream = new MemoryStream();
+        var serializer = new XmlSerializer(typeof(T));
+
+        using (var writer = new StreamWriter(stream, Encoding.UTF8, leaveOpen: true))
+        {
+            serializer.Serialize(writer, layoutObject);
+            await writer.FlushAsync();  
+        }
+
+        cancellationToken.ThrowIfCancellationRequested();
+
+        return Encoding.UTF8.GetString(stream.ToArray());
+    }
+
+    public async Task<T?> DeserializeAsync<T>(string layoutData, CancellationToken cancellationToken = default)
+    {
+        if (string.IsNullOrWhiteSpace(layoutData))
+        {
+            throw new ArgumentException("The layout data cannot be null or empty.", nameof(layoutData));
+        }
+
+        byte[] dataBytes = Encoding.UTF8.GetBytes(layoutData);
+
+        using var stream = new MemoryStream(dataBytes);
+
+        cancellationToken.ThrowIfCancellationRequested();
+
+        var serializer = new XmlSerializer(typeof(T));
+
+        return await Task.Run(() =>
+        {
+            return (T?) serializer.Deserialize(stream);
+        }, cancellationToken);
+    }
+}