Add request body content to API operations (#227)

Added requestBody to Swashbuckle generated specification.

Author: richard-einfinity

src/CommunityToolkit.Datasync.Server.Swashbuckle/DatasyncDocumentFilter.cs

@@ -112,6 +112,7 @@ internal void ProcessController(Type entityType, string routePath, OpenApiDocume
                 case OpType.Create:
                     // Request Edits
                     operation.Value.AddConditionalHeader(true);
+                    operation.Value.AddRequestWithContent(context.SchemaRepository.Schemas[entityType.Name]);
 
                     // Response Edits
                     operation.Value.AddResponseWithContent("201", "Created", context.SchemaRepository.Schemas[entityType.Name]);
@@ -152,6 +153,7 @@ internal void ProcessController(Type entityType, string routePath, OpenApiDocume
                 case OpType.Replace:
                     // Request Edits
                     operation.Value.AddConditionalHeader();
+                    operation.Value.AddRequestWithContent(context.SchemaRepository.Schemas[entityType.Name]);
 
                     // Response Edits
                     operation.Value.AddResponseWithContent("200", "OK", context.SchemaRepository.Schemas[entityType.Name]);

src/CommunityToolkit.Datasync.Server.Swashbuckle/DatasyncOperationExtensions.cs

@@ -95,6 +95,24 @@ internal static void AddResponseWithContent(this OpenApiOperation operation, str
         });
         operation.Responses[statusCode] = response;
     }
+    /// <summary>
+    /// Adds the content type and schema to the request body.
+    /// </summary>
+    /// <param name="operation">The <see cref="OpenApiOperation"/> to modify.</param>
+    /// <param name="schema">The schema of the entity in the request.</param>
+    internal static void AddRequestWithContent(this OpenApiOperation operation, OpenApiSchema schema)
+    {
+        operation.RequestBody = new OpenApiRequestBody
+        {
+            Content = new Dictionary<string, OpenApiMediaType>
+            {
+                [JsonMediaType] = new OpenApiMediaType()
+                {
+                    Schema = schema
+                }
+            }
+        };
+    }
 
     /// <summary>
     /// Adds or replaces the 409/412 Conflict/Precondition Failed response.

tests/CommunityToolkit.Datasync.Server.Swashbuckle.Test/swagger.json

@@ -159,6 +159,15 @@
             }
           }
         ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/KitchenSink"
+              }
+            }
+          }
+        },
         "responses": {
           "201": {
             "description": "Created",
@@ -448,6 +457,15 @@
             }
           }
         ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/KitchenSink"
+              }
+            }
+          }
+        },
         "responses": {
           "200": {
             "description": "OK",
@@ -530,6 +548,15 @@
             }
           }
         ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/TodoItem"
+              }
+            }
+          }
+        },
         "responses": {
           "201": {
             "description": "Created",
@@ -819,6 +846,15 @@
             }
           }
         ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/TodoItem"
+              }
+            }
+          }
+        },
         "responses": {
           "200": {
             "description": "OK",