Introduced MapImplicitAreaControllerRoute()

The `MapImplicitAreaControllerRoute()` extension method is similar to the `MapDefaultAreaControllerRoute()` recently introduced (35cdd74), except that it supports a short-hand convention for scenarios where the controller name is the same as the area name. This allows e.g., a `[Area("Forms")] public FormsController: Controller` to be routed via `/Forms`, instead of the redundant `/Forms/Forms`.

This convention is most commonly used for scenarios where there is a single controller for an area.

Author: JeremyCaney

OnTopic.AspNetCore.Mvc/ServiceCollectionExtensions.cs

@@ -143,6 +143,32 @@ public static void MapDefaultAreaControllerRoute(this IEndpointRouteBuilder rout
         pattern: "{area:exists}/{controller}/{action=Index}/{id?}"
       );
 
+    /*==========================================================================================================================
+    | EXTENSION: MAP IMPLICIT AREA CONTROLLER ROUTES (IENDPOINTROUTEBUILDER)
+    \-------------------------------------------------------------------------------------------------------------------------*/
+    /// <summary>
+    ///   Adds the <c>{areaName}/{action=Index}</c> endpoint route for a specific area where the controller has the same name as
+    ///   the area.
+    /// </summary>
+    /// <remarks>
+    ///   <para>
+    ///     This extension method implicitly assigns the controller name based on the area name. This is advantageous when an
+    ///     area has a single controller which is named after the area—e.g., <c>[Area("Forms")]</c> and <c>FormsController</c>—
+    ///     as this allows the redundant <c>Controller</c> to be ommited from the route (e.g., <c>/Forms/Forms/{action}</c>.
+    ///   </para>
+    ///   <para>
+    ///     If there are multiple routes that fit this description, you can instead opt to use the <see cref=
+    ///     "MapImplicitAreaControllerRoute(IEndpointRouteBuilder)"/> overload, which will register all areas.
+    ///   </para>
+    /// </remarks>
+    public static void MapImplicitAreaControllerRoute(this IEndpointRouteBuilder routes, string areaName) =>
+      routes.MapAreaControllerRoute(
+        name: $"{areaName}TopicArea",
+        areaName: areaName,
+        pattern: $"{areaName}/{{action}}",
+        defaults: new { controller = areaName }
+      );
+
     /*==========================================================================================================================
     | EXTENSION: MAP TOPIC REDIRECT (IENDPOINTROUTEBUILDER)
     \-------------------------------------------------------------------------------------------------------------------------*/