[add] add HTTP QUERY method support with QueryAttribute and HttpMethod.Query

Author: i4004

src/Simplify.Web.Tests/Controllers/Resolution/Stages/RouteMatchingStageTests.cs

@@ -51,6 +51,7 @@ public void Execute_NoRespectiveMethod_ExecutionStoppedAndNoParametersSet()
 	[TestCase(HttpMethod.Patch)]
 	[TestCase(HttpMethod.Delete)]
 	[TestCase(HttpMethod.Options)]
+	[TestCase(HttpMethod.Query)]
 	public void Execute_MatchedMethodButNotMatchedRoute_ExecutionStoppedAndIsMatchedSetAndNoRouteParametersSet(HttpMethod httpMethod)
 	{
 		// Arrange
@@ -96,6 +97,7 @@ public void Execute_MatchedMethodButNotMatchedRoute_ExecutionStoppedAndIsMatched
 	[TestCase(HttpMethod.Patch)]
 	[TestCase(HttpMethod.Delete)]
 	[TestCase(HttpMethod.Options)]
+	[TestCase(HttpMethod.Query)]
 	public void Execute_MatchedMethodAndMatchedRoute_IsMatchedAndRouteParametersAreSet(HttpMethod httpMethod)
 	{
 		// Arrange

src/Simplify.Web.Tests/Controllers/V1/Metadata/MetadataFactoryTests/Controller1MetadataFactoryTests.cs

@@ -42,7 +42,7 @@ private static void AssertExecParameters(IControllerMetadata metaData)
 		Assert.That(metaData.ExecParameters, Is.Not.Null);
 		Assert.That(metaData.ExecParameters!.RunPriority, Is.EqualTo(1));
 
-		Assert.That(metaData.ExecParameters.Routes.Count, Is.EqualTo(6));
+		Assert.That(metaData.ExecParameters.Routes.Count, Is.EqualTo(7));
 
 		var firstControllerRoute = metaData.ExecParameters.Routes.First(x => x.Key == HttpMethod.Get);
 
@@ -60,5 +60,6 @@ private static void AssertExecParametersRoutes(ControllerExecParameters execPara
 		Assert.That(execParameters.Routes[HttpMethod.Patch].Path, Is.EqualTo("/test-action3"));
 		Assert.That(execParameters.Routes[HttpMethod.Delete].Path, Is.EqualTo("/test-action4"));
 		Assert.That(execParameters.Routes[HttpMethod.Options].Path, Is.EqualTo("/test-action5"));
+		Assert.That(execParameters.Routes[HttpMethod.Query].Path, Is.EqualTo("/test-action6"));
 	}
 }

src/Simplify.Web.Tests/Controllers/V1/Metadata/MetadataFactoryTests/TestTypes/AllAttributesController.cs

@@ -9,6 +9,7 @@ namespace Simplify.Web.Tests.Controllers.V1.Metadata.MetadataFactoryTests.TestTy
 [Patch("/test-action3")]
 [Delete("/test-action4")]
 [Options("/test-action5")]
+[Query("/test-action6")]
 [Http403]
 [Http404]
 [Priority(1)]

src/Simplify.Web.Tests/Controllers/V2/Metadata/MetadataFactoryTests/Controller2MetadataFactoryTests.cs

@@ -65,7 +65,7 @@ private static void AssertExecParameters(IControllerMetadata metaData)
 		Assert.That(metaData.ExecParameters, Is.Not.Null);
 		Assert.That(metaData.ExecParameters!.RunPriority, Is.EqualTo(1));
 
-		Assert.That(metaData.ExecParameters.Routes.Count, Is.EqualTo(6));
+		Assert.That(metaData.ExecParameters.Routes.Count, Is.EqualTo(7));
 
 		var firstControllerRoute = metaData.ExecParameters.Routes.First(x => x.Key == HttpMethod.Get);
 
@@ -83,5 +83,6 @@ private static void AssertExecParametersRoutes(ControllerExecParameters execPara
 		Assert.That(execParameters.Routes[HttpMethod.Patch].Path, Is.EqualTo("/test-action3"));
 		Assert.That(execParameters.Routes[HttpMethod.Delete].Path, Is.EqualTo("/test-action4"));
 		Assert.That(execParameters.Routes[HttpMethod.Options].Path, Is.EqualTo("/test-action5"));
+		Assert.That(execParameters.Routes[HttpMethod.Query].Path, Is.EqualTo("/test-action6"));
 	}
 }

src/Simplify.Web.Tests/Controllers/V2/Metadata/MetadataFactoryTests/TestTypes/AllAttributesControllerV2.cs

@@ -9,6 +9,7 @@ namespace Simplify.Web.Tests.Controllers.V2.Metadata.MetadataFactoryTests.TestTy
 [Patch("/test-action3")]
 [Delete("/test-action4")]
 [Options("/test-action5")]
+[Query("/test-action6")]
 [Http403]
 [Http404]
 [Priority(1)]

src/Simplify.Web.Tests/Model/Binding/Parsers/TestTypes/TestController1.cs

@@ -9,6 +9,7 @@ namespace Simplify.Web.Tests.Model.Binding.Parsers.TestTypes;
 [Patch("/testaction3")]
 [Delete("/testaction4")]
 [Options("/testaction5")]
+[Query("/testaction6")]
 [Http403]
 [Http404]
 [Priority(1)]

src/Simplify.Web/Attributes/QueryAttribute.cs

@@ -0,0 +1,14 @@
+using System;
+
+namespace Simplify.Web.Attributes;
+
+/// <summary>
+/// Sets the controller HTTP QUERY request route path.
+/// </summary>
+/// <seealso cref="ControllerRouteAttribute" />
+/// <remarks>
+/// Initializes a new instance of the <see cref="QueryAttribute" /> class.
+/// </remarks>
+/// <param name="route">The route.</param>
+[AttributeUsage(AttributeTargets.Class)]
+public class QueryAttribute(string route) : ControllerRouteAttribute(route);

src/Simplify.Web/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## [5.3.1] - Unreleased
 
+### Added
+
+- HTTP QUERY method support via HttpMethod.Query and the [Query] controller route attribute.
+
 ### Security
 
 - Redirector: reject relative redirect URLs containing control characters (e.g. tab) in

src/Simplify.Web/Http/HttpMethod.cs

@@ -38,5 +38,10 @@ public enum HttpMethod
 	/// <summary>
 	/// The OPTIONS HTTP method.
 	/// </summary>
-	Options
+	Options,
+
+	/// <summary>
+	/// The QUERY HTTP method.
+	/// </summary>
+	Query
 }

src/Simplify.Web/Http/Relations.cs

@@ -19,7 +19,8 @@ public static class Relations
 		{ HttpMethod.Put, typeof(PutAttribute) },
 		{ HttpMethod.Patch, typeof(PatchAttribute) },
 		{ HttpMethod.Delete, typeof(DeleteAttribute) },
-		{ HttpMethod.Options, typeof(OptionsAttribute) }
+		{ HttpMethod.Options, typeof(OptionsAttribute) },
+		{ HttpMethod.Query, typeof(QueryAttribute) }
 	};
 
 	/// <summary>
@@ -32,6 +33,7 @@ public static class Relations
 		{ HttpMethod.Put, "PUT" },
 		{ HttpMethod.Patch, "PATCH" },
 		{ HttpMethod.Delete, "DELETE" },
-		{ HttpMethod.Options, "OPTIONS" }
+		{ HttpMethod.Options, "OPTIONS" },
+		{ HttpMethod.Query, "QUERY" }
 	};
 }