Add optional params to control middleware (#665)

* Add optional param to add user middleware after routing

* Add missing using

* Rename to insertExtraMiddleware

* Rework

* docs: improved comments on usage UseJsonApi( ... )

Co-authored-by: Maurits Moeys <maurei@users.noreply.github.com>

Author: bjornharrtell

src/JsonApiDotNetCore/Extensions/IApplicationBuilderExtensions.cs

@@ -15,11 +15,27 @@ namespace JsonApiDotNetCore.Extensions
     public static class IApplicationBuilderExtensions
     {
         /// <summary>
-        /// Adds necessary components such as routing to your application
+        /// Runs several internal JsonApiDotNetCore services to ensure proper configuration and registers required middlewares. 
+        /// The <paramref name="skipRegisterMiddleware"/> can be used to skip any middleware registration, in which case the developer is
+        /// is responsible for registering middleware that are required for JsonApiDotNetCore.
         /// </summary>
         /// <param name="app"></param>
-        /// <returns></returns>
-        public static void UseJsonApi(this IApplicationBuilder app)
+        /// <param name="skipRegisterMiddleware">Indicates if JsonApiDotNetCore should skip middleware registration. This enabl.</param>
+        /// <param name="useAuthentication">Indicates if .NET Core authentication middleware should be registered. Ignored when <paramref name="skipRegisterMiddleware"/> is set to true.</param>
+        /// <param name="useAuthorization">Indicates if .NET Core authentication middleware should be registered. Ignored when <paramref name="skipRegisterMiddleware"/> is set to true.</param>
+        /// <example>
+        /// This example illustrate which required middlewares should be registered when using the <paramref name="skipRegisterMiddleware"/> option.
+        /// <code>
+        /// app.UseJsonApi(skipRegisterMiddleware: true);
+        /// // JADNC requires routing
+        /// app.UseRouting();
+        /// // JADNC requires CurrentRequestMiddleware 
+        /// app.UseMiddleware<CurrentRequestMiddleware>();
+        /// // JANDC requires the endpoint feature enabled as follows
+        /// app.UseEndpoints(endpoints => endpoints.MapControllers());
+        /// </code>
+        /// </example>
+        public static void UseJsonApi(this IApplicationBuilder app, bool skipRegisterMiddleware = false, bool useAuthentication = false, bool useAuthorization = false)
         {
             LogResourceGraphValidations(app);
             using (var scope = app.ApplicationServices.CreateScope())
@@ -28,14 +44,26 @@ public static void UseJsonApi(this IApplicationBuilder app)
                 inverseRelationshipResolver?.Resolve();
             }
 
-            // An endpoint is selected and set on the HttpContext if a match is found
-            app.UseRouting();
+            if (!skipRegisterMiddleware) {
+                // An endpoint is selected and set on the HttpContext if a match is found
+                app.UseRouting();
 
-            // middleware to run after routing occurs.
-            app.UseMiddleware<CurrentRequestMiddleware>();
+                if (useAuthentication)
+                {
+                    app.UseAuthentication();
+                };
 
-            // Executes the endpoints that was selected by routing.
-            app.UseEndpoints(endpoints => endpoints.MapControllers());
+                if (useAuthorization)
+                {
+                    app.UseAuthorization();
+                };
+
+                // middleware to run after routing occurs.
+                app.UseMiddleware<CurrentRequestMiddleware>();
+
+                // Executes the endpoints that was selected by routing.
+                app.UseEndpoints(endpoints => endpoints.MapControllers());
+            }
         }
 
         /// <summary>