XSLT怎么获取基本URI base-uri()

base-uri() 返回当前上下文节点的基本 URI:文档节点返回文档URI,其他节点继承最近xml:base或祖先URI,动态节点默认为空序列;常与resolve-uri()配合解析相对路径。

base-uri() 是 XSLT 2.0 及更高版本(包括 XSLT 3.0)中用于获取当前节点**基本 URI(Base URI)** 的内置函数。它返回一个字符串,表示该节点在解析时所依据的 URI(通常是文档或片段的来源地址),对处理相对路径、解析 xlink:href、xml:base 或生成绝对链接非常有用。

base-uri() 返回什么

它返回当前上下文节点的 base URI,具体取决于节点类型:

  • 对于文档节点(/),通常返回整个 XML 文档的 URI(如 file:///path/to/doc.xmlhttps://example.com/data.xml);
  • 对于元素、属性、文本等节点,继承其最近的祖先(含自身)声明的 xml:base 属性值;
  • 如果没有显式 xml:base,就沿用父元素或文档的 base URI;
  • 对临时构造的节点(如 动态创建的),base URI 默认为 ()(空序列),除非显式用 xsl:copy + select="@*" inherit-namespaces="yes" 等方式保留。

常见用法示例

假设你有如下 XML:







对应 XSLT 片段:



+


输出可能为:

https://example.com/base/ + page.html
https://example.com/base/subdir/ + inner.xml

注意事项和兼容性

  • XSLT 1.0 不支持 base-uri() —— 它没有该函数。若必须用 1.0,只能靠外部传入 base URI(如通过 ),或依赖处理器扩展(如 Saxon 的 saxon:base-uri(),但不通用);
  • 确保使用 XSLT 2.0+ 处理器(如 Saxon-HE/PE/EE、libxslt 1.1.29+、Altova RaptorXML);
  • 调用时注意上下文节点:写成 base-uri() 默认作用于当前 context node;也可显式指定:base-uri(some-node)
  • 如果节点没有 base URI(例如内存中构造的文档),函数返回空序列 (),建议配合 string() 或判断避免报错:string(base-uri())if (base-uri()) then base-uri() else 'unknown'

结合 resolve-uri() 构建绝对地址

常与 resolve-uri(@href, base-uri()) 配合,把相对引用转为绝对 URI:

例如 @href="page.html" 在 base 为 https://example.com/base/ 下,结果就是 https://example.com/base/page.html

基本上就这些。用好 base-uri() 能让 XSLT 更可靠地处理带路径引用的 XML 场景,尤其在聚合、重发布或生成链接时很实用。