Simplified signature of app.UseJsonApi(), allowing for more flexibility in pipeline setup.

Author: Bart Koelman

docs/getting-started/step-by-step.md

@@ -96,14 +96,15 @@ public void ConfigureServices(IServiceCollection services)
 }
 ```
 
-Add the middleware to the Startup.Configure method. Note that under the hood,
-this will call `app.UseRouting()` and `app.UseEndpoints(...)` so there is no need to add that as well.
+Add the middleware to the Startup.Configure method.
 
 ```c#
 // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
 public void Configure(IApplicationBuilder app)
 {
+    app.UseRouting();
     app.UseJsonApi();
+    app.UseEndpoints(endpoints => endpoints.MapControllers());
 }
 ```
 
@@ -125,7 +126,9 @@ public void Configure(IApplicationBuilder app, AppDbContext context)
         context.SaveChanges();
     }
 
+    app.UseRouting();
     app.UseJsonApi();
+    app.UseEndpoints(endpoints => endpoints.MapControllers());
 }
 ```
 
@@ -135,4 +138,3 @@ public void Configure(IApplicationBuilder app, AppDbContext context)
 dotnet run
 curl http://localhost:5000/people
 ```
-

docs/usage/extensibility/middleware.md

@@ -5,9 +5,10 @@ Add the following to your Startup.ConfigureServices method. Replace AppDbContext
 services.AddJsonApi<AppDbContext>();
 ```
 
-Add the middleware to the Startup.Configure method. Note that under the hood,
-this will call `app.UseRouting()` and `app.UseEndpoints(...)` so there is no need to add that as well.
+Add the middleware to the Startup.Configure method.
 
 ```c3
+app.UseRouting();
 app.UseJsonApi();
+app.UseEndpoints(endpoints => endpoints.MapControllers());
 ```

src/Examples/GettingStarted/Startup.cs

@@ -9,7 +9,7 @@ namespace GettingStarted
 {
     public sealed class Startup
     {
-        // This method gets called by the runtime. Use this method to add services to the container.
+        // This method gets called by the runtime. Use this method to add services to the container.
         public void ConfigureServices(IServiceCollection services)
         {
             services.AddDbContext<SampleDbContext>(
@@ -19,14 +19,16 @@ public void ConfigureServices(IServiceCollection services)
                 options => options.Namespace = "api");
         }
 
-        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
+        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
         public void Configure(IApplicationBuilder app, SampleDbContext context)
         {
             context.Database.EnsureDeleted();
             context.Database.EnsureCreated();
             CreateSampleData(context);
 
+            app.UseRouting();
             app.UseJsonApi();
+            app.UseEndpoints(endpoints => endpoints.MapControllers());
         }
 
         private static void CreateSampleData(SampleDbContext context)

src/Examples/JsonApiDotNetCoreExample/Startups/Startup.cs

@@ -73,7 +73,10 @@ public void Configure(
             AppDbContext context)
         {
             context.Database.EnsureCreated();
+            
+            app.UseRouting();
             app.UseJsonApi();
+            app.UseEndpoints(endpoints => endpoints.MapControllers());
         }
     }
 }

src/Examples/NoEntityFrameworkExample/Startup.cs

@@ -43,7 +43,9 @@ public void Configure(IApplicationBuilder app, AppDbContext context)
         {
             context.Database.EnsureCreated();
 
+            app.UseRouting();
             app.UseJsonApi();
+            app.UseEndpoints(endpoints => endpoints.MapControllers());
         }
     }
 }

src/JsonApiDotNetCore/Extensions/ApplicationBuilderExtensions.cs

@@ -1,55 +1,26 @@
-using JsonApiDotNetCore.Internal;
 using JsonApiDotNetCore.Middleware;
 using Microsoft.AspNetCore.Builder;
-using Microsoft.Extensions.DependencyInjection;
 
 namespace JsonApiDotNetCore
 {
     public static class ApplicationBuilderExtensions
     {
         /// <summary>
-        /// Validates the resource graph and optionally registers the JsonApiDotNetCore middleware.
+        /// Registers the JsonApiDotNetCore middleware.
         /// </summary>
-        /// <remarks>
-        /// The <paramref name="skipRegisterMiddleware"/> can be used to skip any middleware registration, in which case the developer
-        /// is responsible for registering required middleware.
-        /// </remarks>
-        /// <param name="app"></param>
-        /// <param name="skipRegisterMiddleware">Indicates to not register any middleware. This enables callers to take full control of middleware registration order.</param>
-        /// <param name="useAuthentication">Indicates if 'app.UseAuthentication()' should be called. Ignored when <paramref name="skipRegisterMiddleware"/> is set to true.</param>
-        /// <param name="useAuthorization">Indicates if 'app.UseAuthorization()' should be called. Ignored when <paramref name="skipRegisterMiddleware"/> is set to true.</param>
+        /// <param name="builder">The <see cref="IApplicationBuilder"/> to add the middleware to.</param>
         /// <example>
-        /// The next example illustrates how to manually register middleware.
-        /// <code>
-        /// app.UseJsonApi(skipRegisterMiddleware: true);
+        /// The code below is the minimal that is required for proper activation,
+        /// which should be added to your Startup.Configure method.
+        /// <code><![CDATA[
         /// app.UseRouting();
-        /// app.UseMiddleware{JsonApiMiddleware}();
+        /// app.UseJsonApi();
         /// app.UseEndpoints(endpoints => endpoints.MapControllers());
-        /// </code>
+        /// ]]></code>
         /// </example>
-        public static void UseJsonApi(this IApplicationBuilder app, bool skipRegisterMiddleware = false, bool useAuthentication = false, bool useAuthorization = false)
+        public static void UseJsonApi(this IApplicationBuilder builder)
         {
-            if (!skipRegisterMiddleware) 
-            {
-                // An endpoint is selected and set on the HttpContext if a match is found
-                app.UseRouting();
-
-                if (useAuthentication)
-                {
-                    app.UseAuthentication();
-                }
-
-                if (useAuthorization)
-                {
-                    app.UseAuthorization();
-                }
-
-                // middleware to run after routing occurs.
-                app.UseMiddleware<JsonApiMiddleware>();
-
-                // Executes the endpoints that was selected by routing.
-                app.UseEndpoints(endpoints => endpoints.MapControllers());
-            }
+            builder.UseMiddleware<JsonApiMiddleware>();
         }
     }
 }