Put QUERY on its own Json route and document the IDF enum clash

The 8-byte edge-case handler made the QUERY curl a 413, and WebDAV is
the wrong home. Use AsyncWebRequestMethod::HTTP_QUERY when http_parser.h
is included so platform enumerator 33 is not treated as a bit mask.

Author: EyJunge1

docs/requests.md

@@ -23,19 +23,21 @@ Platform `http_method` mapping is compiled in only when the platform parser defi
 Register it like any other verb:
 
 ```cpp
-server.on("/search", HTTP_QUERY, [](AsyncWebServerRequest *request) {
+server.on("/search", AsyncWebRequestMethod::HTTP_QUERY, [](AsyncWebServerRequest *request) {
   AsyncWebServerResponse *res = request->beginResponse(200, "text/plain", "ok");
-  res->addHeader("Accept-Query", "application/json");
+  res->addHeader(asyncsrv::T_Accept_Query, "application/json");
   request->send(res);
 });
 
 auto *json = new AsyncCallbackJsonWebHandler("/search", [](AsyncWebServerRequest *request, JsonVariant &json) {
   request->send(200, "application/json", "{\"ok\":true}");
 });
-json->setMethod(HTTP_QUERY);
+json->setMethod(AsyncWebRequestMethod::HTTP_QUERY);
 server.addHandler(json);
 ```
 
+Use `AsyncWebRequestMethod::HTTP_QUERY` when `http_parser.h` is included: the platform enumerator `HTTP_QUERY` is `33`, not the library bit flag.
+
 ### Headers
 
 ```cpp

examples/arduino/HTTPMethodsWithESPIDF/HTTPMethodsWithESPIDF.ino

@@ -119,6 +119,12 @@ void setup() {
   assert(composite3 == composite4);
   assert(composite1 != composite3);
   assert(composite5 == AsyncWebRequestMethod::HTTP_GET);
+
+#if defined(HTTP_PARSER_HAS_QUERY)
+  // http_parser.h is included above, so HTTP_QUERY is the platform enumerator
+  // (33), not the Async bit. The integration ctor must map it.
+  static_assert(WebRequestMethodComposite(HTTP_QUERY).matches(AsyncWebRequestMethod::HTTP_QUERY), "platform HTTP_QUERY must map onto AsyncWebRequestMethod::HTTP_QUERY");
+#endif
 }
 
 // not needed

examples/arduino/Json/Json.ino

@@ -63,7 +63,6 @@ void setup() {
 
   // curl -v -X POST -H 'Content-Type: application/json' -d '{"name":"You"}' http://192.168.4.1/json2
   // curl -v -X PUT -H 'Content-Type: application/json' -d '{"name":"You"}' http://192.168.4.1/json2
-  // curl -v -X QUERY -H 'Content-Type: application/json' -d '{"q":"You"}' http://192.168.4.1/json2
   //
   // edge cases:
   //
@@ -75,7 +74,7 @@ void setup() {
   // curl -v -X POST -H "Content-Type: application/json" -d "123456789" -H "Content-Length: 8" http://192.168.4.1/json2 => 12345678
   // curl -v -X POST -H "Content-Type: application/json" -d "123456789" -H "Content-Length: 9" http://192.168.4.1/json2 => 413: Content length exceeds maximum allowed
   handler->setMaxContentLength(8);
-  handler->setMethod(HTTP_POST | HTTP_PUT | HTTP_QUERY);
+  handler->setMethod(HTTP_POST | HTTP_PUT);
   handler->onRequest([](AsyncWebServerRequest *request, JsonVariant &json) {
     serializeJson(json, Serial);
     Serial.println();
@@ -88,6 +87,22 @@ void setup() {
 
   server.addHandler(handler);
 
+  // RFC 10008 QUERY: same JSON body path as POST/PUT. Not enabled on
+  // AsyncCallbackJsonWebHandler by default; call setMethod(HTTP_QUERY).
+  // curl -v -X QUERY -H 'Content-Type: application/json' -d '{"q":1}' http://192.168.4.1/json-query
+  AsyncCallbackJsonWebHandler *queryHandler = new AsyncCallbackJsonWebHandler("/json-query");
+  queryHandler->setMethod(HTTP_QUERY);
+  queryHandler->onRequest([](AsyncWebServerRequest *request, JsonVariant &json) {
+    serializeJson(json, Serial);
+    Serial.println();
+    AsyncJsonResponse *response = new AsyncJsonResponse();
+    JsonObject root = response->getRoot().to<JsonObject>();
+    root["hello"] = json.as<JsonObject>()["q"];
+    response->setLength();
+    request->send(response);
+  });
+  server.addHandler(queryHandler);
+
   // New Json API since 3.8.2, which works for both Json and MessagePack bodies
   // curl -v -X POST -H 'Content-Type: application/json' -d '{"name":"You"}' http://192.168.4.1/json3
 

examples/arduino/WebDAVMethods/WebDAVMethods.ino

@@ -31,7 +31,6 @@ 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 /"