通常,当我在XSLT中工作时,会创建一个主要由导入组成的主文件。我将每个导入文件都保持较小,以便于维护。
我正在尝试在XQuery(在MarkLogic中)中做同样的事情,但是我无法使其按我希望的那样工作。
这是我想要做的:
main.xqy:
xquery version "1.0-ml";
module namespace summit = "http://example.com/summit";
import module "http://example.com/summit" at "/ext/variables.xqy";
import module "http://example.com/summit" at "/ext/utils.xqy";
variables.xqy:
xquery version "1.0-ml";
module namespace summit = "http://example.com/summit";
declare variable $BASEURL as xs:string := "https://example.com/v1";
utils.xqy:
xquery version "1.0-ml";
module namespace summit = "http://example.com/summit";
declare function summit:baseUrl() {
let $url := $BASEURL
return $url
};
然后使用以下代码在查询控制台中调用它:
xquery version "1.0-ml";
import module namespace summit = "http://example.com/summit" at "/ext/main.xqy";
summit:baseUrl()
我收到以下错误:
[1.0-ml] XDMP-UNDVAR: (err:XPST0008) Undefined variable $BASEURL
Stack Trace
In /ext/utils.xqy on line 4
In xdmp:eval("xquery version "1.0-ml"; import module namespace s...", (), <options xmlns="xdmp:eval"><database>8148014817830251656</database>...</options>)
对于以相同方式定义的函数(在一个xquery文件中定义,在导入到main.xqy的另一个文件中使用)定义的函数,我也会遇到类似的错误。
我可以通过将variables.xqy导入utils.xqy来解决此问题,但是我想避免这种情况,因为它增加了管理开销,而不是减少了管理开销。
我确定这里确实有我做错的事情,但是我不确定是什么。
您如何组织大型xquery项目?
最佳答案
与XSLT不同,XQuery的设计宗旨是使模块可以独立编译,这意味着模块不能依赖于(通过传递)自己的模块导入无法访问的变量或函数。
尽管有时这可能会带来不便,但它确实具有使库模块更可重用的好处,因为它们没有隐藏的依赖关系,这意味着它们可以导入一个主模块中,而不能导入到另一个主模块中。
注意这里有些微妙之处。首先,规范指出,如果两次导入相同的模块,则只会得到一个变量的副本:
如果查询通过多个路径导入同一模块,则仅导入该模块的一个实例。因为仅导入模块的一个实例,所以模块序言中声明的每个变量只有一个实例。
但它也指出“相同模块”的概念在边缘是模糊的:
当在同一“导入模块”声明中或同一查询中不同的“导入模块”声明中多次使用相同的绝对位置URI时,将加载包含该模块的资源的单个副本。当使用不同的绝对位置URI时,除非实现能够确定不同的URI是对同一资源的引用,否则每个都会导致加载单个模块。只要相同位置的绝对位置URI相同,多次导入同一模块就不会由于重复的变量或函数名称而引起错误。