[bugfix] Parse multipart/form-data for all HTTP methods, not only POST

exist-core/src/main/java/org/exist/http/servlets/HttpRequestWrapper.java

@@ -135,10 +135,13 @@
         this.pathInfo = servletRequest.getPathInfo();
         this.servletPath = servletRequest.getServletPath();
 
-        // Determine if request is a multipart
-
+        // Determine if request is a multipart.
+        // Any HTTP method may carry a multipart/form-data body (e.g. PUT and PATCH,
+        // not just POST); the presence of the multipart content type is what matters.
+        // See https://github.com/eXist-db/exist/issues/6580 and
+        // https://github.com/eXist-db/exist/issues/6578
         @Nullable final String contentType = servletRequest.getContentType();
-        isMultipartContent = "POST".equalsIgnoreCase(servletRequest.getMethod()) && contentType != null && contentType.toLowerCase(Locale.ENGLISH).startsWith("multipart/");
+        isMultipartContent = contentType != null && contentType.toLowerCase(Locale.ENGLISH).startsWith("multipart/");
 
         // Get multi-part formdata parameters when it is a mpfd request
         // and when instructed to do so
@@ -929,7 +932,7 @@
     }
 
     @Override
     protected void finalize() {
         if (temporaryUploadedFilesPathCache == null) {
             return;
         }

exist-core/src/main/java/org/exist/http/urlrewrite/XQueryURLRewrite.java

@@ -934,7 +934,11 @@ private SourceInfo getSource(final DBBroker broker, final String moduleLoadPath)
     }
 
     private void declareVariables(final XQueryContext context, final SourceInfo sourceInfo, final URLRewrite staticRewrite, final String basePath, final RequestWrapper request, final HttpServletResponse response) throws XPathException {
-        final HttpRequestWrapper reqw = new HttpRequestWrapper(request, UTF_8.name(), UTF_8.name(), false);
+        // parseMultipart=true so that multipart/form-data uploads (including file parts)
+        // are exposed to controllers and RESTXQ resource functions for every HTTP method,
+        // not only POST. See https://github.com/eXist-db/exist/issues/6580 and
+        // https://github.com/eXist-db/exist/issues/6578
+        final HttpRequestWrapper reqw = new HttpRequestWrapper(request, UTF_8.name(), UTF_8.name(), true);
         final HttpResponseWrapper respw = new HttpResponseWrapper(response);
         // context.declareNamespace(RequestModule.PREFIX,
         // RequestModule.NAMESPACE_URI);

exist-core/src/test/java/org/exist/http/urlrewrite/MultipartMethodControllerTest.java

@@ -0,0 +1,117 @@
+/*
+ * eXist-db Open Source Native XML Database
+ * Copyright (C) 2001 The eXist-db Authors
+ *
+ * info@exist-db.org
+ * http://www.exist-db.org
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+ */
+package org.exist.http.urlrewrite;
+
+import org.exist.TestUtils;
+import org.exist.http.AbstractHttpTest;
+import org.exist.test.ExistWebServer;
+import org.junit.ClassRule;
+import org.junit.Test;
+
+import java.io.IOException;
+import java.net.HttpURLConnection;
+import java.net.URI;
+import java.net.http.HttpRequest;
+
+import static java.nio.charset.StandardCharsets.UTF_8;
+import static org.exist.http.urlrewrite.XQueryURLRewrite.LEGACY_XQUERY_CONTROLLER_FILENAME;
+import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertTrue;
+
+/**
+ * Reproduction for multipart/form-data parsing on methods other than POST
+ * (eXist-db/exist#6580, #6578), via a controller.xql that reports what the
+ * {@code request:} module can see of an identical multipart body — the same
+ * path third-party routers (e.g. roaster) take.
+ */
+public class MultipartMethodControllerTest extends AbstractHttpTest {
+
+    @ClassRule
+    public static final ExistWebServer existWebServer = new ExistWebServer(true, false, true, true, false);
+
+    private static final String BOUNDARY = "wdbBoundary";
+
+    private static final String MULTIPART_BODY =
+            "--" + BOUNDARY + "\r\n"
+          + "Content-Disposition: form-data; name=\"path\"\r\n"
+          + "\r\n"
+          + "edition/01/17410105.xml\r\n"
+          + "--" + BOUNDARY + "\r\n"
+          + "Content-Disposition: form-data; name=\"file\"; filename=\"17410105.xml\"\r\n"
+          + "Content-Type: application/xml\r\n"
+          + "\r\n"
+          + "<example>hello</example>\r\n"
+          + "--" + BOUNDARY + "--\r\n";
+
+    private static final String CONTROLLER =
+            """
+            xquery version "3.1";
+            <result method="{request:get-method()}"
+                    is-multipart="{request:is-multipart-content()}"
+                    param-names="{string-join(request:get-parameter-names(), ',')}"
+                    path="{request:get-parameter('path', ())}"
+                    file-param="{request:get-parameter('file', ())}"
+                    uploaded-files="{string-join(request:get-uploaded-file-name('file'), ',')}"/>
+            """;
+
+    @Test
+    public void multipartFormDataIsParsedForPostAndPut() throws IOException {
+        final String coll = "multipart-method-controller";
+        store(coll, LEGACY_XQUERY_CONTROLLER_FILENAME, "application/xquery", CONTROLLER);
+
+        // A multipart/form-data body must be parsed identically regardless of HTTP method:
+        // both the form field ("path") and the uploaded file ("file") must be visible, and
+        // request:is-multipart-content() must report true. Prior to the fix, PUT reported
+        // is-multipart-content()=false and exposed neither the file nor its part (#6580),
+        // and the controller/RESTXQ path never exposed the uploaded file at all (#6578).
+        for (final String method : new String[]{"POST", "PUT"}) {
+            final String body = send(coll, method);
+            assertTrue(method + ": is-multipart-content() should be true: " + body,
+                    body.contains("is-multipart=\"true\""));
+            assertTrue(method + ": form field 'path' should be visible: " + body,
+                    body.contains("path=\"edition/01/17410105.xml\""));
+            assertTrue(method + ": uploaded file 'file' should be visible: " + body,
+                    body.contains("uploaded-files=\"17410105.xml\""));
+        }
+    }
+
+    private void store(final String coll, final String name, final String mediaType, final String content) throws IOException {
+        final HttpRequest request = authenticatedRequest(
+                URI.create(getRestUri(existWebServer) + "/db/apps/" + coll + "/" + name),
+                TestUtils.ADMIN_DB_USER, TestUtils.ADMIN_DB_PWD)
+                .header("Content-Type", mediaType)
+                .PUT(HttpRequest.BodyPublishers.ofString(content))
+                .build();
+        final int status = withHttpClient(client -> executeForStatus(client, request));
+        assertEquals(HttpURLConnection.HTTP_CREATED, status);
+    }
+
+    private String send(final String coll, final String method) throws IOException {
+        final HttpRequest request = authenticatedRequest(
+                URI.create(getServerUri(existWebServer) + "/apps/" + coll + "/echo"),
+                TestUtils.ADMIN_DB_USER, TestUtils.ADMIN_DB_PWD)
+                .header("Content-Type", "multipart/form-data; boundary=" + BOUNDARY)
+                .method(method, HttpRequest.BodyPublishers.ofString(MULTIPART_BODY, UTF_8))
+                .build();
+        return withHttpClient(client -> executeForStatusAndBody(client, request).body());
+    }
+}