XQuery 函数命名空间如何工作？

Question

编辑

我想将相关功能分组在一起以表明它们是相关的。

如果我有 local:f1() 和 local:f2() 那么我可以将它们的名称更改为 local:menu-f1()和 local:menu-f2() 但 XQuery 语言中是否有一种机制可以对相关函数进行分组？

OP

我很高兴发现 XQuery 函数可以在 local: 以外的命名空间中声明。我在哪里可以找到有关其工作原理的信息？

总是以这种方式声明函数；

declare function local:foo() {
   3+4
};

..并以这种方式使用它们；

local:foo()

..我发现它们可以这样声明；

declare namespace baz = "fred:bloggs";
declare function baz:foo() {
   3+4
};

..并像这样使用；

baz:foo()

但我只能分别找到有关声明命名空间和声明函数的类似参考的信息，而不是有关 XQuery 函数命名空间一般如何工作的类似教程的信息。

有 XQuery 函数命名空间的新手指南吗？

我正在使用 Saxon 处理器 - XQuery 1.0。

Answer 1

您可能使用的是普通的 XQuery 命名空间 - 您可能正在寻找的是模块。您可以将一堆函数放入其自己的模块命名空间中，如下所示：

module namespace foo = "http://www.myurl.com/foo";

declare function foo:bar($args as item()*) as item()* {
  () (: do something cool :)
};

然后您可以在主查询中导入模块并调用该函数：

import module namespace foo = "http://www.myurl.com/foo";

foo:bar(<my-element/>)

问题是，它不是标准化的，处理器如何找到查询。而且我不知道 Saxon 如何实现模块解析机制（您应该查看文档和/或写入 Saxon 邮件列表）。

但大多数 XQuery 处理器都会查看由“at”子句给出的相对于查询位置的路径。因此，要拥有适用于大多数实现的东西：例如，您可以将模块存储在名为 foo.xq 的文件中，并将其放入与主查询相同的目录中，然后对于模块导入，您将编写：

import module namespace foo = "http://www.myurl.com/foo" at "foo.xq";

这给出了提示到 XQuery 引擎，它应该在其中查找模块。

您可以在 http://www.xquery.me/< 找到一些（目前不是很多）有关此内容的文档/a> - 希望这有帮助。

编辑

好的，我明白了，您只想对功能进行分组。为此，您已经了解了需要了解的所有内容。但我仍然想强调，将查询拆分为模块可能是适合您的用例的更好解决方案（它只是在某种程度上更好，因为您有更多的模块化性，并且在即将推出的 XQuery 3.0 建议中，您甚至可以将诸如私有函数和变量之类的东西）。但如果你的查询没有变大，你的解决方案当然也可以。
您可以像考虑 C++ 中的命名空间一样来考虑 XML 命名空间。在 XQuery 中，函数、元素、集合、变量、属性等可以位于自己的命名空间中（同样 - 就像在 C++ 中一样）。有一些隐式定义的命名空间，例如 xs（XML 模式命名空间，您可以在其中找到布尔值、整数等数据类型）、local（可以在其中放入函数的命名空间，这样您就不必在主查询）、fn（其中定义了“XQuery 1.0 和 XPath 2.0 函数和运算符”建议中的所有函数）。但这个函数的前缀只是一个别名——你可以使用任何你想要的。
因此，假设您的查询的序言中有以下代码：

declare namespace blubb = "http://www.w3.org/2001/XMLSchema";

blubb:integer 与 xs:integer 的类型完全相同 - 对于函数来说也是如此：

declare namespace l = "http://www.w3.org/2005/xquery-local-functions";

声明您可以使用“访问本地命名空间中的每个函数” l" 前缀（如果 local:bar() 存在，则 l:bar() ）。

如果不键入前缀，XQuery 假定该函数位于“fn”名称空间中。这就是为什么 bot

fn:concat("Hello ", "World!")

和

concat("Hello ", "World!")

bot是等价的。您可以更改此行为。您可以将此行包含到序言中：

declare default function namespace "http://www.w3.org/2005/xquery-local-functions";

这将告诉 XQuery 处理器您不想为本地函数添加前缀（因此 bar() 相当于 local:bar()）。

我不确定我是否回答了你的问题，或者至少能够澄清一些问题。我不知道这方面的教程（因为一开始它有点令人困惑，但最终您意识到没有太多可说的，因为这些机制比它们一开始看起来要简单得多）。我总是查找内容的文档是 http://www.w3.org/TR/ 上的推荐xquery/

如果这对您没有帮助，请尝试获得资格，我可以再试一次并提供解释。