[add] missing XML comments

[r] optimization

Author: i4004

src/Simplify.Web/Controllers/ControllerMetaDataExtensions.cs

@@ -2,8 +2,15 @@
 
 namespace Simplify.Web.Controllers;
 
+/// <summary>
+/// Provides the controller metadata extensions.
+/// </summary>
 public static class ControllerMetaDataExtensions
 {
+	/// <summary>
+	/// Converts to controller metadata to matched controller.
+	/// </summary>
+	/// <param name="metaData">The meta data.</param>
 	public static IMatchedController ToMatchedController(this IControllerMetadata metaData) =>
 		new MatchedController(metaData);
 }

src/Simplify.Web/Controllers/Execution/IControllerExecutor.cs

@@ -9,13 +9,13 @@ namespace Simplify.Web.Controllers.Execution;
 public interface IControllerExecutor
 {
 	/// <summary>
-	/// Determines whether this executor can execute controller.
+	/// Determines whether this executor can execute the controller.
 	/// </summary>
 	/// <param name="controllerMetadata">The controller metadata.</param>
 	bool CanHandle(IControllerMetadata controllerMetadata);
 
 	/// <summary>
-	/// Creates the actual controller and executes it.
+	/// Creates an actual controller and executes it.
 	/// </summary>
 	/// <param name="matchedController">The matched controller.</param>
 	Task<ControllerResponse?> ExecuteAsync(IMatchedController matchedController);

src/Simplify.Web/Controllers/IMatchedController.cs

@@ -3,9 +3,24 @@
 
 namespace Simplify.Web.Controllers;
 
+/// <summary>
+/// Represents a matcher controller.
+/// </summary>
 public interface IMatchedController
 {
+	/// <summary>
+	/// Gets the controller.
+	/// </summary>
+	/// <value>
+	/// The controller.
+	/// </value>
 	public IControllerMetadata Controller { get; }
 
+	/// <summary>
+	/// Gets the route parameters.
+	/// </summary>
+	/// <value>
+	/// The route parameters.
+	/// </value>
 	public IReadOnlyDictionary<string, object>? RouteParameters { get; }
 }

src/Simplify.Web/Controllers/MatchedController.cs

@@ -3,9 +3,25 @@
 
 namespace Simplify.Web.Controllers;
 
+/// <summary>
+/// Provides the matcher controller.
+/// </summary>
+/// <seealso cref="IMatchedController" />
 public class MatchedController(IControllerMetadata metaData, IReadOnlyDictionary<string, object>? routeParameters = null) : IMatchedController
 {
+	/// <summary>
+	/// Gets the controller.
+	/// </summary>
+	/// <value>
+	/// The controller.
+	/// </value>
 	public IControllerMetadata Controller { get; } = metaData;
 
+	/// <summary>
+	/// Gets the route parameters.
+	/// </summary>
+	/// <value>
+	/// The route parameters.
+	/// </value>
 	public IReadOnlyDictionary<string, object>? RouteParameters { get; } = routeParameters;
 }

src/Simplify.Web/Controllers/MatchedControllersExtensions.cs

@@ -3,8 +3,15 @@
 
 namespace Simplify.Web.Controllers;
 
+/// <summary>
+/// Provides the matcher controllers extensions.
+/// </summary>
 public static class MatchedControllersExtensions
 {
+	/// <summary>
+	/// Sorts the matched controllers by run priority.
+	/// </summary>
+	/// <param name="items">The items.</param>
 	public static IOrderedEnumerable<IMatchedController> SortByRunPriority(this IEnumerable<IMatchedController> items) =>
 		items.OrderBy(x => x.Controller.ExecParameters?.RunPriority ?? 0);
 }

src/Simplify.Web/Controllers/Meta/ControllerExecParameters.cs

@@ -17,6 +17,9 @@ public class ControllerExecParameters(IDictionary<HttpMethod, IControllerRoute>?
 	/// <summary>
 	/// Gets the controller handling routes.
 	/// </summary>
+	/// <value>
+	/// The routes.
+	/// </value>
 	public IDictionary<HttpMethod, IControllerRoute> Routes { get; } = routes ?? new Dictionary<HttpMethod, IControllerRoute>();
 
 	/// <summary>

src/Simplify.Web/Controllers/Meta/ControllerMetadata.cs

@@ -10,6 +10,7 @@ namespace Simplify.Web.Controllers.Meta;
 /// <summary>
 /// Provides the controller base metadata information.
 /// </summary>
+/// <seealso cref="IControllerMetadata" />
 /// <remarks>
 /// Initializes a new instance of the <see cref="ControllerMetadata" /> class.
 /// </remarks>
@@ -19,25 +20,45 @@ public abstract class ControllerMetadata(Type controllerType) : IControllerMetad
 	/// <summary>
 	/// Gets the type of the controller.
 	/// </summary>
+	/// <value>
+	/// The type of the controller.
+	/// </value>
 	public Type ControllerType { get; } = controllerType;
 
 	/// <summary>
 	/// Gets the controller execute parameters.
 	/// </summary>
+	/// <value>
+	/// The execute parameters.
+	/// </value>
 	public ControllerExecParameters? ExecParameters { get; protected set; }
 
 	/// <summary>
 	/// Gets the controller role information.
 	/// </summary>
+	/// <value>
+	/// The role.
+	/// </value>
 	public ControllerRole? Role { get; } = BuildControllerRole(controllerType);
 
 	/// <summary>
 	/// Gets the controller security information.
 	/// </summary>
+	/// <value>
+	/// The security.
+	/// </value>
 	public ControllerSecurity? Security { get; } = BuildControllerSecurity(controllerType);
 
+	/// <summary>
+	/// Builds the controller route.
+	/// </summary>
+	/// <param name="path">The path.</param>
 	protected abstract IControllerRoute BuildControllerRoute(string path);
 
+	/// <summary>
+	/// Builds the controller execute parameters.
+	/// </summary>
+	/// <param name="controllerType">Type of the controller.</param>
 	protected ControllerExecParameters? BuildControllerExecParameters(ICustomAttributeProvider controllerType)
 	{
 		var priority = 0;

src/Simplify.Web/Controllers/Meta/ControllerMetadataExtensions.cs

@@ -4,19 +4,39 @@
 
 namespace Simplify.Web.Controllers.Meta;
 
+/// <summary>
+/// Provides the controller metadata route extensions.
+/// </summary>
 public static class ControllerMetadataRouteExtensions
 {
+	/// <summary>
+	/// Gets the standard controllers.
+	/// </summary>
+	/// <param name="list">The list.</param>
 	public static IEnumerable<IControllerMetadata> GetStandardControllers(this IEnumerable<IControllerMetadata> list) => list
 		.Where(x => !x.IsSpecialController());
 
+	/// <summary>
+	/// Gets the routed controllers.
+	/// </summary>
+	/// <param name="list">The list.</param>
 	public static IEnumerable<IControllerMetadata> GetRoutedControllers(this IEnumerable<IControllerMetadata> list) => list
 		.GetStandardControllers()
 		.Where(x => x.ContainsRoute());
 
+	/// <summary>
+	/// Gets the global controllers.
+	/// </summary>
+	/// <param name="list">The list.</param>
 	public static IEnumerable<IControllerMetadata> GetGlobalControllers(this IEnumerable<IControllerMetadata> list) => list
 		.GetStandardControllers()
 		.Where(x => !x.ContainsRoute());
 
+	/// <summary>
+	/// Gets the handler controller.
+	/// </summary>
+	/// <param name="list">The list.</param>
+	/// <param name="controllerType">Type of the controller.</param>
 	public static IControllerMetadata? GetHandlerController(this IEnumerable<IControllerMetadata> list, HandlerControllerType controllerType) =>
 		controllerType switch
 		{
@@ -25,11 +45,19 @@ public static IEnumerable<IControllerMetadata> GetGlobalControllers(this IEnumer
 			_ => throw new InvalidOperationException("Invalid controller type: " + controllerType)
 		};
 
+	/// <summary>
+	/// Determines whether the controller is special controller
+	/// </summary>
+	/// <param name="controller">The controller.</param>
 	public static bool IsSpecialController(this IControllerMetadata controller) =>
 		controller.Role
 			is { IsForbiddenHandler: true }
 			or { IsNotFoundHandler: true };
 
+	/// <summary>
+	/// Determines whether the controller contains route.
+	/// </summary>
+	/// <param name="controller">The controller.</param>
 	public static bool ContainsRoute(this IControllerMetadata controller) =>
 		controller.ExecParameters != null &&
 		controller.ExecParameters.Routes.Any(route => route.Value != null);

src/Simplify.Web/Controllers/Meta/Factory/ControllerMetadataFactoryResolver.cs

@@ -4,8 +4,18 @@
 
 namespace Simplify.Web.Controllers.Meta.Factory;
 
+/// <summary>
+/// Provides the controller metadata factories resolver
+/// </summary>
+/// <seealso cref="IControllerMetadataFactoryResolver" />
 public class ControllerMetadataFactoryResolver(IEnumerable<IControllerMetadataFactory> factories) : IControllerMetadataFactoryResolver
 {
+	/// <summary>
+	/// Resolves the controller metadata factory for specified type.
+	/// </summary>
+	/// <param name="controllerType">Type of the controller.</param>
+	/// <returns></returns>
+	/// <exception cref="InvalidOperationException">No matching controller metadata factory found for controller type: " + controllerType</exception>
 	public IControllerMetadataFactory Resolve(Type controllerType) =>
 		factories.FirstOrDefault(x => x.CanHandle(controllerType))
 		?? throw new InvalidOperationException("No matching controller metadata factory found for controller type: " + controllerType);

src/Simplify.Web/Controllers/Meta/Factory/IControllerMetadataFactoryResolver.cs

@@ -3,7 +3,7 @@
 namespace Simplify.Web.Controllers.Meta.Factory;
 
 /// <summary>
-/// Represents controller metadata factories resolver
+/// Represents a controller metadata factories resolver
 /// </summary>
 public interface IControllerMetadataFactoryResolver
 {