MarkLogic中从主模块调用库模块并实现参数单独传递的方法

我来帮你解决这个问题——把主模块里硬编码的参数改成可外部传递的方式，有几种实用的方案，结合你的代码给你详细说明，顺便还会指出原代码里的一个小bug哦：

先修正原代码的关键问题 #

首先注意：你的主模块里有个错误——两次执行map:put($map, "Date", ...)，这会导致第二次的EndDate覆盖第一次的StartDate，而库模块里实际要取的是StartDate和EndDate两个键，所以必须改成map:put($map, "StartDate", $StartDate)和map:put($map, "EndDate", $EndDate)，否则日期范围查询会失效。

方案1：使用XQuery外部变量（适合本地/Query Console执行） #

把主模块里的硬编码变量改成外部变量，这样你可以在执行时动态传入参数，不用修改代码。

修改后的主模块代码：

import module namespace test = "http://try.marklogic.com/test" at "/lib1.xqy";

// 声明外部变量，指定类型增强安全性
declare variable $College as xs:string external;
declare variable $Year as xs:string external;
declare variable $StartDate as xs:date external;
declare variable $EndDate as xs:date external;
declare variable $Dep as xs:string external;
declare variable $Grade as xs:string external;

let $map := map:map()
let $put := (
 map:put($map, "College", $College),
 map:put($map, "Year", $Year),
 map:put($map, "StartDate", $StartDate),
 map:put($map, "EndDate", $EndDate),
 map:put($map, "Dep", $Dep),
 map:put($map, "Grade", $Grade)
)
return test:median($map)

如何传递参数： #

• 在Query Console中：打开"External Variables"面板，逐个添加变量名和对应的值，点击执行即可。
• 命令行执行：用xquery工具通过-v参数传递：

xquery -v College=UCLA -v Year=2000 -v StartDate=2017-01-06 -v EndDate=2018-01-06 -v Dep=CSE -v Grade=A -f /path/to/your/main.xqy

方案2：将主模块改造为可调用的函数（适合内部XQuery调用） #

把主模块的逻辑封装成一个接受参数的函数，这样其他XQuery代码可以直接调用它并传入动态参数。

修改后的主模块代码：

import module namespace test = "http://try.marklogic.com/test" at "/lib1.xqy";

// 封装成可调用的函数，明确参数类型
declare function local:run-median-query(
  $College as xs:string,
  $Year as xs:string,
  $StartDate as xs:date,
  $EndDate as xs:date,
  $Dep as xs:string,
  $Grade as xs:string
) as node()* {
  let $map := map:map()
  let $put := (
    map:put($map, "College", $College),
    map:put($map, "Year", $Year),
    map:put($map, "StartDate", $StartDate),
    map:put($map, "EndDate", $EndDate),
    map:put($map, "Dep", $Dep),
    map:put($map, "Grade", $Grade)
  )
  return test:median($map)
};

// 可选：如果需要默认执行，可以添加一行调用（注释掉或者保留都可以）
// local:run-median-query("UCLA", "2000", xs:date("2017-01-06"), xs:date("2018-01-06"), "CSE", "A")

使用方式： #

在其他XQuery代码里直接调用这个函数：

import module namespace local = "http://your-namespace" at "/path/to/main.xqy";

local:run-median-query("Stanford", "2023", xs:date("2023-01-01"), xs:date("2024-01-01"), "EE", "B")

方案3：封装为REST API扩展（适合HTTP请求调用） #

如果需要通过外部应用（比如前端、后端服务）调用这个查询，可以把它封装成MarkLogic的REST API扩展，这样就能通过HTTP请求传递参数了。

步骤1：创建REST扩展代码（比如命名为get-median） #

xquery version "1.0-ml";
import module namespace test = "http://try.marklogic.com/test" at "/lib1.xqy";
import module namespace ext = "http://marklogic.com/rest-api/resource/get-median" at "/ext/resources/get-median.xqy";

// 处理GET请求的函数，从请求参数中获取值
declare function ext:get(
  $context as map:map,
  $params as map:map
) as node()* {
  // 从URL参数中提取值，做类型转换
  let $College := map:get($params, "College")
  let $Year := map:get($params, "Year")
  let $StartDate := xs:date(map:get($params, "StartDate"))
  let $EndDate := xs:date(map:get($params, "EndDate"))
  let $Dep := map:get($params, "Dep")
  let $Grade := map:get($params, "Grade")
  
  let $map := map:map()
  let $put := (
    map:put($map, "College", $College),
    map:put($map, "Year", $Year),
    map:put($map, "StartDate", $StartDate),
    map:put($map, "EndDate", $EndDate),
    map:put($map, "Dep", $Dep),
    map:put($map, "Grade", $Grade)
  )
  return test:median($map)
};

步骤2：部署扩展 #

用MarkLogic的REST API部署这个扩展（或者用Dashboard操作），之后就可以通过HTTP GET请求调用：

GET /v1/resources/get-median?College=UCLA&Year=2000&StartDate=2017-01-06&EndDate=2018-01-06&Dep=CSE&Grade=A

额外注意事项 #

• 参数验证：如果是外部传入的参数，建议添加验证逻辑（比如检查日期格式是否合法、参数是否为空），避免无效请求导致错误。
• 安全性：如果是公开的REST端点，记得配置MarkLogic的权限控制，只允许授权用户访问。

内容的提问来源于stack exchange，提问作者Private