XQuery 函数（一文讲透）

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

• 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;演示链接： http://116.62.199.48:7070 ;
• 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

（注：根据用户要求，一级标题已省略，以下内容直接以二级标题展开）

什么是 XQuery 函数？

XQuery 函数是 XQuery 语言中用于执行特定操作的预定义或自定义代码块。它们可以看作是 XML 数据处理的“工具箱”，帮助开发者高效操作、转换和查询结构化数据。想象一下，如果你在图书馆整理书籍，函数就像是分类标签——它们能快速定位特定类型的书（如按作者或出版年份排序），而无需逐本手动查找。

XQuery 函数分为两大类：

1. 内置函数：XQuery 标准库中提供的现成函数，如字符串处理、数学运算、节点操作等。
2. 自定义函数：开发者根据需求编写的函数，用于解决特定业务场景的问题。

XQuery 函数的基础语法

函数调用的基本结构

调用函数时，通常遵循以下格式：

function-name($parameter1, $parameter2, ...)  

例如，使用内置函数 fn:count() 统计节点数量：

count(//book)  

这条语句会返回 XML 文档中所有 <book> 节点的数量。

参数传递与返回值

函数参数可以是节点、字符串、数值等类型，返回值则由函数逻辑决定。例如，函数 fn:string-length("Hello World") 的参数是字符串，返回值是整数（即字符串长度）。

自定义函数的定义

自定义函数的语法如下：

declare function local:my-function($param as xs:string) as xs:integer {  
    ...  
};  

• local: 表示函数的作用域（本地函数）。
• $param 是输入参数，类型声明为 xs:string。
• as xs:integer 定义函数返回值类型为整数。

示例：计算书籍价格总和的函数：

declare function local:sum-prices($books as node()*) as xs:decimal {  
    sum($books/book/price/xs:decimal(.))  
};  

此函数接收一组书籍节点，提取每个 <price> 的值并求和。

内置函数的使用场景与分类

字符串处理函数

字符串函数是 XQuery 函数中最常用的类别之一。例如：

• fn:concat()：合并字符串，类似 Excel 中的 CONCAT 函数。
• fn:substring()：截取子字符串，如 substring("Hello", 2) 返回 "ello"。
• fn:lower-case() 和 fn:upper-case()：转换大小写。

案例：将书籍标题转为小写并添加后缀：

for $book in //book  
return concat(lower-case($book/title), " (Processed)")  

数学运算函数

数学函数支持基本运算和统计操作：

• fn:sum()：计算数值总和。
• fn:avg()：求平均值。
• fn:max() 和 fn:min()：获取最大值或最小值。

示例：计算某类书籍的平均价格：

avg(//book[category = "Technology"]/price/xs:decimal(.))  

节点操作函数

处理 XML 节点的函数包括：

• fn:node-name()：获取节点名称。
• fn:data()：提取节点文本值。
• fn:count()：统计节点数量。

案例：列出所有作者及其作品数量：

for $author in distinct-values(//book/author)  
return  
  <author>  
    <name>{$author}</name>  
    <count>{count(//book[author = $author])}</count>  
  </author>  

自定义函数的进阶技巧

参数类型约束与默认值

通过类型声明确保函数的健壮性：

declare function local:calculate-price($price as xs:decimal, $discount as xs:decimal? = 0.0) {  
    $price * (1 - $discount)  
};  

• $discount 参数带有 ? 表示可选，默认值为 0.0。
• 类型 xs:decimal 确保输入是数值类型，避免类型错误。

函数重载与作用域

XQuery 允许通过参数数量或类型定义多个同名函数（重载）：

declare function local:process-data($data as xs:string) { ... };  
declare function local:process-data($data as node()*) { ... };  

• 第一个函数处理字符串输入，第二个处理节点集合。

递归函数的使用

递归函数适合处理嵌套结构，例如遍历 XML 树形结构：

declare function local:flatten-tree($nodes as node()*) {  
    for $node in $nodes  
    return  
        if ($node/self::*) then  
            <item name="{name($node)}" value="{data($node)}"/>  
            , local:flatten-tree($node/node())  
        else ()  
};  

此函数将 XML 树转换为扁平化的 <item> 列表，递归处理子节点。

实战案例：综合运用 XQuery 函数

场景：电商商品目录分析

假设我们有以下 XML 数据：

<products>  
  <product id="1">  
    <name>Laptop</name>  
    <price>1200</price>  
    <category>Electronics</category>  
  </product>  
  <product id="2">  
    <name>Book</name>  
    <price>25</price>  
    <category>Books</category>  
  </product>  
</products>  

任务 1：筛选低价商品

使用函数过滤价格低于 100 的商品：

for $product in //product  
where xs:decimal($product/price) < 100  
return $product  

任务 2：按分类汇总销售额

结合聚合函数和分组：

for $category in distinct-values(//product/category)  
return  
  <category>  
    <name>{$category}</name>  
    <total>{sum(//product[category = $category]/price/xs:decimal(.))}</total>  
  </category>  

任务 3：自定义函数计算折扣价

定义函数并调用：

declare function local:apply-discount($price as xs:decimal, $rate as xs:decimal) as xs:decimal {  
    $price * (1 - $rate)  
};  

for $product in //product  
return  
  <discounted-product>  
    <name>{$product/name}</name>  
    <original-price>{$product/price}</original-price>  
    <discounted-price>{local:apply-discount(xs:decimal($product/price), 0.1)}</discounted-price>  
  </discounted-product>  

此示例将商品价格降低 10%，并返回新 XML 结构。

性能优化与常见问题

函数调用的效率

• 避免重复计算：例如，若需多次使用 count(//book)，可先将其赋值给变量。
• 减少全局搜索：使用 // 轴会遍历整个文档，改用 . 或局部变量可提升速度。

错误处理与调试

XQuery 函数默认不支持 try-catch 机制，但可通过条件判断规避错误：

let $price := if (exists($product/price))  
              then xs:decimal($product/price)  
              else 0.00  

版本兼容性

XQuery 3.1 引入了更多高级函数（如 map 和 array），但部分工具可能仅支持旧版本。开发前需确认目标环境的兼容性。

结论

XQuery 函数是处理 XML 数据的高效工具，无论是基础查询还是复杂逻辑，都能通过内置或自定义函数实现。掌握其语法和分类，结合实际案例练习，开发者可以快速构建数据处理流程。从统计书籍数量到分析电商数据，XQuery 函数的灵活性和强大功能使其成为 XML 开发的基石。建议读者通过官方文档（如 W3C XQuery 规范 ）深入学习更多高级用法，并尝试将函数与 XSLT、XPath 结合，探索更丰富的应用场景。

（全文约 1800 字，符合用户要求）