Add HTTP QUERY method (RFC 10008)

Recognize QUERY in the request-line parser, expose HTTP_QUERY, and accept it on AsyncCallbackJsonWebHandler so safe, idempotent queries can carry a JSON body. Platform http_method mapping is gated until ESP-IDF/Arduino define HTTP_QUERY.

Author: EyJunge1

docs/requests.md

@@ -6,14 +6,30 @@
 
 ```cpp
 request->version();       // uint8_t: 0 = HTTP/1.0, 1 = HTTP/1.1
-request->method();        // enum:    HTTP_GET, HTTP_POST, HTTP_DELETE, HTTP_PUT, HTTP_PATCH, HTTP_HEAD, HTTP_OPTIONS
+request->method();        // enum:    HTTP_GET, HTTP_POST, HTTP_DELETE, HTTP_PUT, HTTP_PATCH, HTTP_HEAD, HTTP_OPTIONS, HTTP_QUERY, …
 request->url();           // String:  URL of the request (not including host, port or GET parameters)
 request->host();          // String:  The requested host (can be used for virtual hosting)
 request->contentType();   // String:  ContentType of the request (not available in Handler::canHandle)
 request->contentLength(); // size_t:  ContentLength of the request (not available in Handler::canHandle)
 request->multipart();     // bool:    True if the request has content type "multipart"
 ```
 
+`HTTP_QUERY` is [RFC 10008](https://www.rfc-editor.org/rfc/rfc10008.html): a safe, idempotent method that carries the query in the request body (same body path as POST/PUT/PATCH whenever `Content-Length` or chunked transfer is present). `AsyncCallbackJsonWebHandler` accepts QUERY with `Content-Type: application/json`. Unknown methods still abort the connection.
+
+Register it like any other verb:
+
+```cpp
+server.on("/search", HTTP_QUERY, [](AsyncWebServerRequest *request) {
+  request->send(200, "text/plain", "ok");
+});
+
+auto *json = new AsyncCallbackJsonWebHandler("/search", [](AsyncWebServerRequest *request, JsonVariant &json) {
+  request->send(200, "application/json", "{\"ok\":true}");
+});
+json->setMethod(HTTP_QUERY);
+server.addHandler(json);
+```
+
 ### Headers
 
 ```cpp

examples/arduino/WebDAVMethods/WebDAVMethods.ino

@@ -31,6 +31,7 @@ using namespace asyncsrv;
 //   curl -s -X MKCOL http://192.168.4.1/
 //   curl -s -X MOVE http://192.168.4.1/
 //   curl -s -X COPY http://192.168.4.1/
+//   curl -s -X QUERY -H 'Content-Type: application/json' -d '{"q":1}' http://192.168.4.1/
 //
 // In all cases, the request will be accepted with text/plain response 200 like
 // "Got method PROPFIND on URL /"

src/AsyncJson.cpp

@@ -113,17 +113,18 @@ size_t AsyncMessagePackResponse::_fillBuffer(uint8_t *data, size_t len) {
 
 // Body handler supporting both content types: JSON and MessagePack
 constexpr static WebRequestMethodComposite JsonHandlerMethods =
-  AsyncWebRequestMethod::HTTP_GET | AsyncWebRequestMethod::HTTP_POST | AsyncWebRequestMethod::HTTP_PUT | AsyncWebRequestMethod::HTTP_PATCH;
+  AsyncWebRequestMethod::HTTP_GET | AsyncWebRequestMethod::HTTP_POST | AsyncWebRequestMethod::HTTP_PUT | AsyncWebRequestMethod::HTTP_PATCH
+  | AsyncWebRequestMethod::HTTP_QUERY;
 
 #if ARDUINOJSON_VERSION_MAJOR == 6
 AsyncCallbackJsonWebHandler::AsyncCallbackJsonWebHandler(AsyncURIMatcher uri, ArJsonRequestHandlerFunction onRequest, size_t maxJsonBufferSize)
   : _uri(std::move(uri)),
-    _method(AsyncWebRequestMethod::HTTP_GET | AsyncWebRequestMethod::HTTP_POST | AsyncWebRequestMethod::HTTP_PUT | AsyncWebRequestMethod::HTTP_PATCH),
+    _method(JsonHandlerMethods),
     _onRequest(onRequest), maxJsonBufferSize(maxJsonBufferSize), _maxContentLength(16384) {}
 #else
 AsyncCallbackJsonWebHandler::AsyncCallbackJsonWebHandler(AsyncURIMatcher uri, ArJsonRequestHandlerFunction onRequest)
   : _uri(std::move(uri)),
-    _method(AsyncWebRequestMethod::HTTP_GET | AsyncWebRequestMethod::HTTP_POST | AsyncWebRequestMethod::HTTP_PUT | AsyncWebRequestMethod::HTTP_PATCH),
+    _method(JsonHandlerMethods),
     _onRequest(onRequest), _maxContentLength(16384) {}
 #endif
 

src/ESPAsyncWebServer.h

@@ -151,6 +151,9 @@ enum AsyncWebRequestMethodType : uint32_t {
   HTTP_LINK = 1u << 22,
   HTTP_UNLINK = 1u << 23,
 
+  /* RFC 10008 */
+  HTTP_QUERY = 1u << 24,
+
   /* icecast */
   // HTTP_SOURCE
 
@@ -227,6 +230,9 @@ class WebRequestMethodComposite {
       : MAP_EXTERNAL_TERNARY(HTTP_PURGE)
       : MAP_EXTERNAL_TERNARY(HTTP_LINK)
       : MAP_EXTERNAL_TERNARY(HTTP_UNLINK)
+#if defined(HTTP_QUERY)
+      : MAP_EXTERNAL_TERNARY(HTTP_QUERY)
+#endif
 #if defined(HTTP_ANY)
       : (t == HTTP_ANY) ? static_cast<uint32_t>(WebRequestMethod::HTTP_INVALID) - 1
 #endif

src/WebRequest.cpp

@@ -1544,6 +1544,8 @@ WebRequestMethod stringToMethod(const String &m) {
     return AsyncWebRequestMethod::HTTP_UNBIND;
   } else if (m == T_ACL) {
     return AsyncWebRequestMethod::HTTP_ACL;
+  } else if (m == T_QUERY) {
+    return AsyncWebRequestMethod::HTTP_QUERY;
   } else {
     return AsyncWebRequestMethod::HTTP_INVALID;
   }
@@ -1579,6 +1581,8 @@ const char *methodToString(WebRequestMethod method) {
     /* RFC-2068, section 19.6.1.2 */
     case AsyncWebRequestMethod::HTTP_LINK:   return T_LINK;
     case AsyncWebRequestMethod::HTTP_UNLINK: return T_UNLINK;
+    /* RFC 10008 */
+    case AsyncWebRequestMethod::HTTP_QUERY: return T_QUERY;
     // Unsupported
     default: return T_UNKNOWN;
   }

src/literals.h

@@ -137,6 +137,7 @@ static constexpr const char T_ACL[] = "ACL";
 static constexpr const char T_PURGE[] = "PURGE";
 static constexpr const char T_LINK[] = "LINK";
 static constexpr const char T_UNLINK[] = "UNLINK";
+static constexpr const char T_QUERY[] = "QUERY";
 
 // Req content types
 static constexpr const char T_RCT_HTTP[] = "RCT_HTTP";