BROKERS: Implement Sheet

xChanger.Api/Brokers/Sheets/ISheetBroker.ExternalPersonPetInput.cs

@@ -0,0 +1,12 @@
+//- - - - - - - - - - - - - - - - - - - - - - - - - -
+// Copyright (c) Coalition of Good-Hearted Engineers
+// Free to Use for Precise File Conversion
+//- - - - - - - - - - - - - - - - - - - - - - - - - -
+
+namespace xChanger.Api.Brokers.Sheets
+{
+    public partial interface ISheetBroker
+    {
+        ValueTask UploadExternalPersonPetsFileAsync(IFormFile file);
+    }
+}

xChanger.Api/Brokers/Sheets/ISheetBroker.ExternalPersonPets.cs

@@ -0,0 +1,14 @@
+//- - - - - - - - - - - - - - - - - - - - - - - - - -
+// Copyright (c) Coalition of Good-Hearted Engineers
+// Free to Use for Precise File Conversion
+//- - - - - - - - - - - - - - - - - - - - - - - - - -
+
+using xChanger.Api.Models.Foundations.ExternalPersons;
+
+namespace xChanger.Api.Brokers.Sheets
+{
+    public partial interface ISheetBroker
+    {
+        ValueTask<List<ExternalPerson>> ReadAllExternalPersonPetsAsync();
+    }
+}

xChanger.Api/Brokers/Sheets/ISheetBroker.PersonXML.cs

@@ -0,0 +1,18 @@
+//- - - - - - - - - - - - - - - - - - - - - - - - - -
+// Copyright (c) Coalition of Good-Hearted Engineers
+// Free to Use for Precise File Conversion
+//- - - - - - - - - - - - - - - - - - - - - - - - - -
+
+using xChanger.Api.Models.Foundations.Persons;
+
+namespace xChanger.Api.Brokers.Sheets
+{
+    public partial interface ISheetBroker
+    {
+        ValueTask SavePeopleWithPetsToXmlFile(
+            IEnumerable<Person> peopleWithPets,
+            string filePath);
+
+        ValueTask<MemoryStream> RetrievePeopleWithPetsXmlFile(string filePath);
+    }
+}

xChanger.Api/Brokers/Sheets/ISheetBroker.cs

@@ -0,0 +1,10 @@
+//- - - - - - - - - - - - - - - - - - - - - - - - - -
+// Copyright (c) Coalition of Good-Hearted Engineers
+// Free to Use for Precise File Conversion
+//- - - - - - - - - - - - - - - - - - - - - - - - - -
+
+namespace xChanger.Api.Brokers.Sheets
+{
+    public partial interface ISheetBroker
+    { }
+}

xChanger.Api/Brokers/Sheets/SheetBroker.ExternalPersonPetInput.cs

@@ -0,0 +1,20 @@
+//- - - - - - - - - - - - - - - - - - - - - - - - - -
+// Copyright (c) Coalition of Good-Hearted Engineers
+// Free to Use for Precise File Conversion
+//- - - - - - - - - - - - - - - - - - - - - - - - - -
+
+namespace xChanger.Api.Brokers.Sheets
+{
+    public partial class SheetBroker
+    {
+        public async ValueTask UploadExternalPersonPetsFileAsync(IFormFile file)
+        {
+            string filePath = GetSheetLocationWithName();
+
+            using (var fileStream = new FileStream(filePath, FileMode.Create))
+            {
+                await file.CopyToAsync(fileStream);
+            }
+        }
+    }
+}

xChanger.Api/Brokers/Sheets/SheetBroker.ExternalPersonPets.cs

@@ -0,0 +1,51 @@
+//- - - - - - - - - - - - - - - - - - - - - - - - - -
+// Copyright (c) Coalition of Good-Hearted Engineers
+// Free to Use for Precise File Conversion
+//- - - - - - - - - - - - - - - - - - - - - - - - - -
+
+using OfficeOpenXml;
+using xChanger.Api.Models.Foundations.ExternalPersons;
+
+namespace xChanger.Api.Brokers.Sheets
+{
+    public partial class SheetBroker
+    {
+        public async ValueTask<List<ExternalPerson>> ReadAllExternalPersonPetsAsync()
+        {
+            ExcelPackage.LicenseContext = LicenseContext.NonCommercial;
+            var externalPersons = new List<ExternalPerson>();
+            using var sheetBroker = new SheetBroker(this.configuration);
+            FileInfo file = sheetBroker.GetFileInfo();
+            int row = 2, column = 1;
+
+            using var excelPackage =
+                new ExcelPackage(file);
+
+            ExcelWorksheet workSheet =
+                excelPackage.Workbook.Worksheets[PositionID: 0];
+
+            await excelPackage.LoadAsync(file);
+
+            while (!IsTrailingFinalRow(row, column, workSheet))
+            {
+                ExternalPerson externalPerson = new ExternalPerson();
+
+                externalPerson.PersonName = workSheet.Cells[row, column].Value.ToString();
+                externalPerson.Age = int.Parse(workSheet.Cells[row, column + 1].Value.ToString());
+                externalPerson.PetOne = workSheet.Cells[row, column + 2].Value.ToString();
+                externalPerson.PetOneType = workSheet.Cells[row, column + 3].Value.ToString();
+                externalPerson.PetTwo = workSheet.Cells[row, column + 4].Value.ToString();
+                externalPerson.PetTwoType = workSheet.Cells[row, column + 5].Value.ToString();
+                externalPerson.PetThree = workSheet.Cells[row, column + 6].Value.ToString();
+                externalPerson.PetThreeType = workSheet.Cells[row, column + 7].Value.ToString();
+                externalPersons.Add(externalPerson);
+                row++;
+            }
+
+            return externalPersons;
+
+            static bool IsTrailingFinalRow(int row, int column, ExcelWorksheet workSheet) =>
+                String.IsNullOrEmpty(workSheet.Cells[row, column].Value?.ToString());
+        }
+    }
+}

xChanger.Api/Brokers/Sheets/SheetBroker.PersonXML.cs

@@ -0,0 +1,28 @@
+//- - - - - - - - - - - - - - - - - - - - - - - - - -
+// Copyright (c) Coalition of Good-Hearted Engineers
+// Free to Use for Precise File Conversion
+//- - - - - - - - - - - - - - - - - - - - - - - - - -
+
+using System.Xml.Serialization;
+using xChanger.Api.Models.Foundations.Persons;
+
+namespace xChanger.Api.Brokers.Sheets
+{
+    public partial class SheetBroker
+    {
+        public async ValueTask SavePeopleWithPetsToXmlFile(
+            IEnumerable<Person> peopleWithPets,
+            string filePath)
+        {
+            XmlSerializer xmlSerializer = new XmlSerializer(typeof(List<Person>));
+            await using FileStream fileStream = new FileStream(filePath, FileMode.Create);
+            xmlSerializer.Serialize(fileStream, peopleWithPets);
+        }
+
+        public async ValueTask<MemoryStream> RetrievePeopleWithPetsXmlFile(string filePath)
+        {
+            byte[] fileBytes = await File.ReadAllBytesAsync(filePath);
+            return new MemoryStream(fileBytes);
+        }
+    }
+}

xChanger.Api/Brokers/Sheets/SheetBroker.cs

@@ -0,0 +1,23 @@
+//- - - - - - - - - - - - - - - - - - - - - - - - - -
+// Copyright (c) Coalition of Good-Hearted Engineers
+// Free to Use for Precise File Conversion
+//- - - - - - - - - - - - - - - - - - - - - - - - - -
+
+namespace xChanger.Api.Brokers.Sheets
+{
+    public partial class SheetBroker : ISheetBroker, IDisposable
+    {
+        private readonly IConfiguration configuration;
+
+        public SheetBroker(IConfiguration configuration) =>
+            this.configuration = configuration;
+
+        public void Dispose() { }
+
+        private string GetSheetLocationWithName() =>
+            this.configuration.GetConnectionString("SheetConnection");
+
+        private FileInfo GetFileInfo() =>
+            new FileInfo(fileName: GetSheetLocationWithName());
+    }
+}

xChanger.Api/xChanger.Api.csproj

@@ -8,6 +8,7 @@
 
   <ItemGroup>
     <PackageReference Include="EFxceptions" Version="0.4.5" />
+    <PackageReference Include="EPPlus" Version="8.0.8" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="8.0.18">
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>