[feature] Native EXQuery Request Module for eXist-db

Implements the full 28-function EXQuery Request Module API
(http://exquery.org/ns/request), compatible with BaseX:

- General: method(), context-path()
- URI: scheme(), hostname(), port(), path(), query(), uri()
- Connection: address(), remote-hostname(), remote-address(), remote-port()
- Parameters: parameter(), parameter-names(), parameter-map()
- Headers: header(), header-names(), header-map()
- Cookies: cookie(), cookie-names(), cookie-map()
- Attributes: attribute(), attribute-names(), attribute-map(), set-attribute()

Default prefix is `exrequest` to coexist with eXist's built-in
`request` module (http://exist-db.org/xquery/request). Both modules
can be imported simultaneously without prefix conflicts.

Uses eXist's native XQueryContext.getHttpContext() — zero external
dependencies. 62 tests using ExistEmbeddedServer with MockRequestWrapper.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: joewiz

pom.xml

@@ -13,7 +13,7 @@
 
     <groupId>org.exist-db</groupId>
     <artifactId>exist-request</artifactId>
-    <version>1.0.0</version>
+    <version>0.9.0-SNAPSHOT</version>
 
     <name>EXQuery Request Module</name>
     <description>Native EXQuery Request Module for eXist-db, compatible with BaseX's 28-function API</description>
@@ -46,7 +46,7 @@
 
         <!-- used in the EXPath Package Descriptor -->
         <package-name>http://exist-db.org/apps/request</package-name>
-        <package-abbrev>request</package-abbrev>
+        <package-abbrev>exist-request</package-abbrev>
 
         <request.module.namespace>http://exquery.org/ns/request</request.module.namespace>
         <request.module.java.classname>org.exist.xquery.modules.request.RequestModule</request.module.java.classname>
@@ -65,6 +65,13 @@
         <profile>
             <id>integration-tests</id>
             <dependencies>
+                <!-- exist-core as test scope so it's on the runtime classpath for tests -->
+                <dependency>
+                    <groupId>org.exist-db</groupId>
+                    <artifactId>exist-core</artifactId>
+                    <version>${exist.version}</version>
+                    <scope>test</scope>
+                </dependency>
                 <dependency>
                     <groupId>org.exist-db</groupId>
                     <artifactId>exist-core</artifactId>

src/main/java/org/exist/xquery/modules/request/AttributeFunctions.java

@@ -23,6 +23,7 @@
 
 import org.exist.http.servlets.RequestWrapper;
 import org.exist.xquery.*;
+import org.exist.xquery.functions.map.MapType;
 import org.exist.xquery.value.*;
 
 import javax.annotation.Nonnull;
@@ -63,7 +64,7 @@ public class AttributeFunctions extends AbstractRequestFunction {
     public static final FunctionSignature FS_ATTRIBUTE_MAP = functionSignature(
             RequestModule.qname(FS_ATTRIBUTE_MAP_NAME),
             "Returns all request attributes as a map.",
-            returns(Type.MAP, "a map of attribute names to values")
+            returns(Type.MAP_ITEM, "a map of attribute names to values")
     );
 
     private static final String FS_SET_ATTRIBUTE_NAME = "set-attribute";

src/main/java/org/exist/xquery/modules/request/CookieFunctions.java

@@ -26,6 +26,7 @@
 import org.exist.xquery.FunctionSignature;
 import org.exist.xquery.XPathException;
 import org.exist.xquery.XQueryContext;
+import org.exist.xquery.functions.map.MapType;
 import org.exist.xquery.value.*;
 
 import javax.annotation.Nonnull;
@@ -64,7 +65,7 @@ public class CookieFunctions extends AbstractRequestFunction {
     public static final FunctionSignature FS_COOKIE_MAP = functionSignature(
             RequestModule.qname(FS_COOKIE_MAP_NAME),
             "Returns all cookies as a map. Each key is a cookie name, each value is the cookie value.",
-            returns(Type.MAP, "a map of cookie names to values")
+            returns(Type.MAP_ITEM, "a map of cookie names to values")
     );
 
     public CookieFunctions(final XQueryContext context, final FunctionSignature signature) {

src/main/java/org/exist/xquery/modules/request/HeaderFunctions.java

@@ -25,6 +25,7 @@
 import org.exist.xquery.FunctionSignature;
 import org.exist.xquery.XPathException;
 import org.exist.xquery.XQueryContext;
+import org.exist.xquery.functions.map.MapType;
 import org.exist.xquery.value.*;
 
 import javax.annotation.Nonnull;
@@ -65,7 +66,7 @@ public class HeaderFunctions extends AbstractRequestFunction {
             RequestModule.qname(FS_HEADER_MAP_NAME),
             "Returns all HTTP headers as a map. Each key is a header name, " +
             "each value is the header value string.",
-            returns(Type.MAP, "a map of header names to values")
+            returns(Type.MAP_ITEM, "a map of header names to values")
     );
 
     public HeaderFunctions(final XQueryContext context, final FunctionSignature signature) {

src/main/java/org/exist/xquery/modules/request/ParameterFunctions.java

@@ -25,6 +25,7 @@
 import org.exist.xquery.FunctionSignature;
 import org.exist.xquery.XPathException;
 import org.exist.xquery.XQueryContext;
+import org.exist.xquery.functions.map.MapType;
 import org.exist.xquery.value.*;
 
 import javax.annotation.Nonnull;
@@ -65,7 +66,7 @@ public class ParameterFunctions extends AbstractRequestFunction {
             RequestModule.qname(FS_PARAMETER_MAP_NAME),
             "Returns all query and form parameters as a map. Each key is a parameter name, " +
             "each value is one or more parameter values.",
-            returns(Type.MAP, "a map of parameter names to values")
+            returns(Type.MAP_ITEM, "a map of parameter names to values")
     );
 
     public ParameterFunctions(final XQueryContext context, final FunctionSignature signature) {

src/main/java/org/exist/xquery/modules/request/RequestModule.java

@@ -46,7 +46,7 @@ public class RequestModule extends AbstractInternalModule {
 
     public static final String NAMESPACE_URI = "http://exquery.org/ns/request";
 
-    public static final String PREFIX = "request";
+    public static final String PREFIX = "exrequest";
 
     public static final String RELEASE = "1.0.0";
 
@@ -71,27 +71,35 @@ public class RequestModule extends AbstractInternalModule {
                     ConnectionFunctions.FS_REMOTE_HOSTNAME,
                     ConnectionFunctions.FS_REMOTE_ADDRESS,
                     ConnectionFunctions.FS_REMOTE_PORT),
+            // ParameterFunctions — split because FS_PARAMETER is FunctionSignature[]
             functionDefs(ParameterFunctions.class,
                     ParameterFunctions.FS_PARAMETER_NAMES,
-                    ParameterFunctions.FS_PARAMETER,
                     ParameterFunctions.FS_PARAMETER_MAP),
+            functionDefs(ParameterFunctions.class,
+                    ParameterFunctions.FS_PARAMETER),
+            // HeaderFunctions — split because FS_HEADER is FunctionSignature[]
             functionDefs(HeaderFunctions.class,
                     HeaderFunctions.FS_HEADER_NAMES,
-                    HeaderFunctions.FS_HEADER,
                     HeaderFunctions.FS_HEADER_MAP),
+            functionDefs(HeaderFunctions.class,
+                    HeaderFunctions.FS_HEADER),
+            // CookieFunctions — split because FS_COOKIE is FunctionSignature[]
             functionDefs(CookieFunctions.class,
-                    CookieFunctions.FS_COOKIE,
                     CookieFunctions.FS_COOKIE_NAMES,
                     CookieFunctions.FS_COOKIE_MAP),
+            functionDefs(CookieFunctions.class,
+                    CookieFunctions.FS_COOKIE),
+            // AttributeFunctions — split because FS_ATTRIBUTE is FunctionSignature[]
             functionDefs(AttributeFunctions.class,
-                    AttributeFunctions.FS_ATTRIBUTE,
                     AttributeFunctions.FS_ATTRIBUTE_NAMES,
                     AttributeFunctions.FS_ATTRIBUTE_MAP,
-                    AttributeFunctions.FS_SET_ATTRIBUTE)
+                    AttributeFunctions.FS_SET_ATTRIBUTE),
+            functionDefs(AttributeFunctions.class,
+                    AttributeFunctions.FS_ATTRIBUTE)
     );
 
     public RequestModule(final Map<String, List<?>> parameters) {
-        super(functions, parameters, true);
+        super(functions, parameters, false);
     }
 
     @Override