Added Swagger elements

Author: SteveCollins

src/JsonAutoService/JsonAutoService.csproj

@@ -2,13 +2,13 @@
 
  <PropertyGroup>
  <TargetFramework>netstandard2.0</TargetFramework>
- <Version>2.3.5</Version>
+ <Version>2.4.0</Version>
  <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
  <PackageId>JsonAutoService</PackageId>
  <Authors>Relatable Technologies Partners</Authors>
  <Company>Relatable Technologies</Company>
  <Product>Relatable Technologies</Product>
- <Description>The Database First (DF) API framework for .NET Core</Description>
+ <Description>FilterData Access aframework for .NET Core</Description>
  </PropertyGroup>
 
  <ItemGroup>
@@ -18,6 +18,7 @@
  <PackageReference Include="Microsoft.Extensions.Options" Version="3.1.3" />
  <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
  <PackageReference Include="System.Data.SqlClient" Version="4.8.1" />
+ <PackageReference Include="Swashbuckle.AspNetCore" Version="5.4.1" />
  </ItemGroup>
 
 </Project>

src/JsonAutoService/Swashbuckle/RelatableOperationId.cs

@@ -0,0 +1,79 @@
+using JsonAutoService.ResourceHandlers;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.AspNetCore.Mvc.ApiExplorer;
+using Newtonsoft.Json;
+using Swashbuckle.AspNetCore.SwaggerGen;
+using System;
+using System.Collections.Generic;
+using System.Reflection;
+using System.Text;
+
+namespace JsonAutoService.Swashbuckle
+{
+ class RelatableOperationId
+ {
+ [JsonProperty("resource_handler")]
+ public string ResourceHandler { get; set; }
+
+ [JsonProperty("procedure_name")]
+ public string Procedure { get; set; }
+
+ [JsonProperty("method_name")]
+ public string Method { get; set; }
+
+ [JsonProperty("http_method")]
+ public string HttpMethod { get; set; }
+
+ [JsonProperty("relative_path")]
+ public string RelativePath { get; set; }
+
+ public static Func<ApiDescription, string> Create()
+ {
+ return apiDesc =>
+ {
+ var endpointMetadata = apiDesc.ActionDescriptor.EndpointMetadata;
+
+ foreach (object eMetadata in endpointMetadata)
+ {
+ var result = Utility.TryCast<TypeFilterAttribute>(eMetadata, out TypeFilterAttribute typeFilterAttribute);
+
+ if (result)
+ {
+ if (typeFilterAttribute.ImplementationType.Name == nameof(JsonResourceResultsHandler) ||
+ typeFilterAttribute.ImplementationType.Name == nameof(JsonResourceContextHandler))
+ {
+ var relOperationId = new RelatableOperationId
+ {
+ ResourceHandler = typeFilterAttribute.ImplementationType.Name,
+ Method = apiDesc.TryGetMethodInfo(out MethodInfo methodInfo) ? methodInfo.Name : null,
+ Procedure = typeFilterAttribute.Arguments[0].ToString(),
+ HttpMethod = apiDesc.HttpMethod,
+ RelativePath = apiDesc.RelativePath
+ };
+
+ var json = JsonConvert.SerializeObject(relOperationId).ToString();
+ var base64String = Convert.ToBase64String(Encoding.UTF8.GetBytes(json));
+ return base64String;
+ }
+ }
+ }
+ return null;
+ };
+ }
+ }
+
+ internal static class Utility
+ {
+ public static bool TryCast<T>(this object obj, out T result)
+ {
+ if (obj is T)
+ {
+ result = (T)obj;
+ return true;
+ }
+
+ result = default(T);
+ return false;
+ }
+ }
+}