DMU-3198 Include models nuget package documentation in Swagger output.

Controllers/ArchiveController.cs

@@ -1,4 +1,5 @@
-using System.IO;
+using System;
+using System.IO;
 using System.Text.Json;
 using System.Xml.Serialization;
 using Microsoft.AspNetCore.Authorization;
@@ -83,18 +84,17 @@ public IActionResult Post([FromBody] ArchiveMessage archiveMessage)
                 });
 
             Directory.CreateDirectory(_settings.Value.ArchiveFolder);
-
-            System.IO.File.WriteAllBytes(Path.Combine(_settings.Value.ArchiveFolder, $"archiveDoc-{archiveMessage.JobId}.pdf"), archiveMessage.MainDocument.DocumentData);
+            var archiveId = Guid.NewGuid();
+            System.IO.File.WriteAllBytes(Path.Combine(_settings.Value.ArchiveFolder, $"archiveDoc-{archiveId}.pdf"), archiveMessage.MainDocument.DocumentData);
 
             // Don't save document data in JSON or XML
             archiveMessage.MainDocument.DocumentData = null;
             if (archiveMessage.Addendums != null) foreach (var addendum in archiveMessage.Addendums) addendum.DocumentData = null;
 
-            System.IO.File.WriteAllText(Path.Combine(_settings.Value.ArchiveFolder, $"archiveDoc-{archiveMessage.JobId}.json"), JsonSerializer.Serialize(archiveMessage));
-            using (var fs = new FileStream(Path.Combine(_settings.Value.ArchiveFolder, $"archiveDoc-{archiveMessage.JobId}.xml"), FileMode.Create))
+            System.IO.File.WriteAllText(Path.Combine(_settings.Value.ArchiveFolder, $"archiveDoc-{archiveId}.json"), JsonSerializer.Serialize(archiveMessage));
+            using (var fs = new FileStream(Path.Combine(_settings.Value.ArchiveFolder, $"archiveDoc-{archiveId}.xml"), FileMode.Create))
                 new XmlSerializer(typeof(ArchiveMessage)).Serialize(fs, archiveMessage);
-
-            return Ok();
+            return Ok($"Archive ID: {archiveId}");
         }
     }
 }

OneTooXRestArchiveTest.csproj

@@ -5,7 +5,7 @@
   </PropertyGroup>
 
   <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|AnyCPU'">
-    <DocumentationFile>OneTooXRestArchiveTest.xml</DocumentationFile>
+    <DocumentationFile>Documentation/OneTooXRestArchiveTest.xml</DocumentationFile>
   </PropertyGroup>
 
   <ItemGroup>
@@ -18,7 +18,7 @@
   <ItemGroup>
     <PackageReference Include="Microsoft.AspNetCore.Mvc.Versioning.ApiExplorer" Version="4.1.1" />
     <PackageReference Include="Microsoft.Extensions.PlatformAbstractions" Version="1.1.0" />
-    <PackageReference Include="OneTooX.RestPush.Model" Version="1.2.5" />
+    <PackageReference Include="OneTooX.RestPush.Model" Version="1.2.6" />
     <PackageReference Include="Swashbuckle.AspNetCore" Version="5.0.0" />
   </ItemGroup>
 

Startup.cs

@@ -1,5 +1,5 @@
+using System.Collections.Generic;
 using System.IO;
-using System.Reflection;
 using Microsoft.AspNetCore.Authentication;
 using Microsoft.AspNetCore.Builder;
 using Microsoft.AspNetCore.Hosting;
@@ -8,7 +8,6 @@
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Hosting;
 using Microsoft.Extensions.PlatformAbstractions;
-using Microsoft.Net.Http.Headers;
 using Microsoft.OpenApi.Models;
 using OneTooXRestArchiveTest.Security;
 using OneTooXRestArchiveTest.User;
@@ -42,7 +41,7 @@ public void ConfigureServices(IServiceCollection services)
             services.AddSwaggerGen(c =>
             {
                 c.SwaggerDoc("v1.0", new OpenApiInfo { Title = "OneTooX Archive API", Version = "v1.0" });
-                c.IncludeXmlComments(XmlCommentsFilePath);
+                foreach (var xml in XmlCommentsFilePaths) c.IncludeXmlComments(xml);
             });
         }
 
@@ -69,14 +68,7 @@ public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
             });
         }
 
-        private static string XmlCommentsFilePath
-        {
-            get
-            {
-                var basePath = PlatformServices.Default.Application.ApplicationBasePath;
-                var fileName = typeof(Startup).GetTypeInfo().Assembly.GetName().Name + ".xml";
-                return Path.Combine(basePath, fileName);
-            }
-        }
+        private static IEnumerable<string> XmlCommentsFilePaths
+            => Directory.EnumerateFiles(PlatformServices.Default.Application.ApplicationBasePath, "OneTooX*.xml", SearchOption.AllDirectories);
     }
 }