[add] authorization, body, accept-language

Author: fpgasar

src/Simplify.Web.Swagger/ControllerAction.cs

@@ -17,6 +17,11 @@ public class ControllerAction
 		/// Operation type
 		/// </summary>
 		public OperationType Type { get; set; }
+		
+		/// <summary>
+		/// Request body
+		/// </summary>
+		public OpenApiRequestBody RequestBody = new OpenApiRequestBody();
 
 		/// <summary>
 		/// Controller responses

src/Simplify.Web.Swagger/ControllerActionsFactory.cs

@@ -4,6 +4,7 @@
 using System.Text.RegularExpressions;
 using Microsoft.OpenApi.Models;
 using Simplify.Web.Meta;
+using Swashbuckle.AspNetCore.SwaggerGen;
 
 namespace Simplify.Web.Swagger
 {
@@ -25,23 +26,24 @@ public class ControllerActionsFactory
 		/// Creates controller actions from Simplify.Web controller meta data
 		/// </summary>
 		/// <returns></returns>
-		public static IEnumerable<ControllerAction> CreateControllerActionsFromControllersMetaData() =>
+		public static IEnumerable<ControllerAction> CreateControllerActionsFromControllersMetaData(DocumentFilterContext context) =>
 			ControllersMetaStore.Current.ControllersMetaData
 				.Where(x => x.ExecParameters != null)
-				.SelectMany(CreateControllerActions);
+				.SelectMany(item => CreateControllerActions(item, context));
 
-		private static IEnumerable<ControllerAction> CreateControllerActions(IControllerMetaData item) =>
+		private static IEnumerable<ControllerAction> CreateControllerActions(IControllerMetaData item, DocumentFilterContext context) =>
 			item.ExecParameters!
 				.Routes
-				.Select(x => CreateControllerAction(x.Key, x.Value, item));
+				.Select(x => CreateControllerAction(x.Key, x.Value, item, context));
 
-		private static ControllerAction CreateControllerAction(HttpMethod method, string route, IControllerMetaData item) =>
+		private static ControllerAction CreateControllerAction(HttpMethod method, string route, IControllerMetaData item, DocumentFilterContext context) =>
 			new ControllerAction
 			{
 				Type = HttpMethodToOperationType(method),
 				Path = route.StartsWith("/") ? route : "/" + route,
 				Names = CreateNames(item.ControllerType),
 				Responses = CreateResponses(item.ControllerType),
+				RequestBody = CreateRequestBody(item.ControllerType, context),
 				IsAuthorizationRequired = item.Security != null && item.Security.IsAuthorizationRequired
 			};
 
@@ -92,6 +94,24 @@ private static OperationType HttpMethodToOperationType(HttpMethod method) =>
 				_ => OperationType.Get
 			};
 
+		private static OpenApiRequestBody CreateRequestBody(Type controllerType, DocumentFilterContext context)
+		{
+			var request = new OpenApiRequestBody();
+			var attributes = controllerType.GetCustomAttributes(typeof(ProducesRequestBodyAttribute), false);
+			
+			if (attributes.Length > 0)
+			{
+				var item = (ProducesRequestBodyAttribute) attributes.First();
+
+				request.Content = new Dictionary<string, OpenApiMediaType>
+				{
+					["application/json"] = new() { Schema = context.SchemaGenerator.GenerateSchema(item.Model, context.SchemaRepository) }
+				};
+			}
+
+			return request;
+		}
+
 		private static IDictionary<int, OpenApiResponse> CreateResponses(Type controllerType)
 		{
 			var items = new Dictionary<int, OpenApiResponse>();

src/Simplify.Web.Swagger/ProducesRequestBodyAttribute.cs

@@ -0,0 +1,20 @@
+using System;
+
+namespace Simplify.Web.Swagger;
+
+/// <summary>
+/// A filter that specifies the request body received by the controller.
+/// </summary>
+public class ProducesRequestBodyAttribute : Attribute
+{
+	/// <summary>
+	/// Initializes an instance of <see cref="ProducesRequestBodyAttribute"/>.
+	/// </summary>
+	/// <param name="model">The schema model.</param>
+	public ProducesRequestBodyAttribute(Type? model) => Model = model;
+
+	/// <summary>
+	/// Request body
+	/// </summary>
+	public Type? Model { get; set; }
+}

src/Simplify.Web.Swagger/SimplifyWebDocumentFilter.cs

@@ -11,14 +11,22 @@ namespace Simplify.Web.Swagger
 	/// </summary>
 	public class SimplifyWebDocumentFilter : IDocumentFilter
 	{
+		private static SimplifyWebSwaggerArgs? _args;
+		
+		/// <summary>
+		/// Initializes an instance of <see cref="SimplifyWebDocumentFilter"/>.
+		/// </summary>
+		/// <param name="args">The registration args</param>
+		public SimplifyWebDocumentFilter(SimplifyWebSwaggerArgs? args) => _args = args;
+
 		/// <summary>
 		/// Applies current filter
 		/// </summary>
 		/// <param name="openApiDocument">The Open API document</param>
 		/// <param name="context">The context</param>
 		public void Apply(OpenApiDocument openApiDocument, DocumentFilterContext context)
 		{
-			foreach (var item in ControllerActionsFactory.CreateControllerActionsFromControllersMetaData()
+			foreach (var item in ControllerActionsFactory.CreateControllerActionsFromControllersMetaData(context)
 				.GroupBy(x => x.Path)
 				.Select(x => new KeyValuePair<string, OpenApiPathItem>(x.Key, CreatePathItem(x))))
 				openApiDocument?.Paths.Add(item.Key, item.Value);
@@ -49,28 +57,16 @@ private static OpenApiOperation CreateOperation(ControllerAction item)
 			foreach (var response in item.Responses)
 				operation.Responses.Add(response.Key.ToString(), response.Value);
 
-			if (item.IsAuthorizationRequired)
-				AddSecurity(operation);
-
 			operation.Parameters = CreateParameters(item.ParsedPath);
+			operation.RequestBody = item.RequestBody;
+
+			if (_args != null)
+				foreach (var parameter in _args.Parameters)
+					operation.Parameters.Add(parameter);
 
 			return operation;
 		}
 
-		private static void AddSecurity(OpenApiOperation operation) =>
-			operation.Security.Add(new OpenApiSecurityRequirement
-			{
-				{
-					new OpenApiSecurityScheme
-					{
-						Reference = new OpenApiReference {
-							Type = ReferenceType.SecurityScheme,
-							Id = "bearerAuth"
-						}
-					}, new List<string>()
-				}
-			});
-
 		private static IList<OpenApiParameter> CreateParameters(IControllerPath path) =>
 			path.Items
 				.Where(x => x is PathParameter)

src/Simplify.Web.Swagger/SimplifyWebSwaggerArgs.cs

@@ -0,0 +1,20 @@
+using System.Collections.Generic;
+using Microsoft.OpenApi.Models;
+
+namespace Simplify.Web.Swagger;
+
+/// <summary>
+/// SimplifyWebSwagger registration args.
+/// </summary>
+public class SimplifyWebSwaggerArgs
+{
+	/// <summary>
+	/// Initializes an instance of <see cref="ProducesResponseAttribute"/>.
+	/// </summary>
+	public SimplifyWebSwaggerArgs() => Parameters = new List<OpenApiParameter>();
+
+	/// <summary>
+	/// Open Api Parameters
+	/// </summary>
+	public IList<OpenApiParameter> Parameters { get; set; }
+}

src/Simplify.Web.Swagger/SimplifyWebSwaggerExtensions.cs

@@ -11,5 +11,5 @@ public static class SimplifyWebSwaggerServiceCollectionExtensions
 	/// <summary>
 	/// Add Simplify.Web controllers to Swagger documentation generation
 	/// </summary>
-	public static void AddSimplifyWebSwagger(this SwaggerGenOptions options) => options.DocumentFilter<SimplifyWebDocumentFilter>();
-}
+	public static void AddSimplifyWebSwagger(this SwaggerGenOptions options, SimplifyWebSwaggerArgs? parameter = null) => options.DocumentFilter<SimplifyWebDocumentFilter>(parameter);
+}