XQuery作为处理XML数据的专用查询语言,提供了declare variable语法用于声明变量,方便开发者在查询过程中存储复用数据,提升查询逻辑的灵活性和可维护性。变量声明后可以存储XML片段、数值、字符串等各类数据,在后续的查询逻辑中直接调用。

declare variable基础语法
declare variable的基础语法结构如下,需要指定变量名称和对应的取值,变量名称必须以$符号开头:
(: 基础变量声明语法 :) declare variable $变量名 := 变量值;
变量值可以是具体的数值、字符串、XML节点,也可以是表达式的计算结果。例如声明一个存储用户名称的字符串变量:
declare variable $user_name := "张三"; $user_name
上述代码执行后会返回字符串"张三"。
带默认值的变量声明
如果变量在声明时无法立即确定取值,或者需要设置默认值应对未传值的情况,可以使用external关键字声明外部变量,同时指定默认值:
(: 声明带默认值的外部变量 :) declare variable $max_count external := 10; $max_count
当外部没有传入$max_count的值时,变量会自动使用默认值10,若外部传入了对应值,则会覆盖默认值。
不同作用域的变量声明
declare variable声明的变量作用域分为全局和局部两种:
- 全局变量:在模块的最外层声明,整个模块的所有查询逻辑都可以调用该变量。
- 局部变量:在FLWOR表达式内部声明,仅在该表达式的作用域内有效。
以下是局部变量的声明示例,在for循环内部声明变量存储当前节点的子元素值:
(: 假设存在books.xml,根节点为books,包含多个book子节点,每个book有title和price子元素 :) for $book in /books/book let $book_title := $book/title/text() let $book_price := $book/price/text() where $book_price > 50 return{$book_title} {$book_price}
上述代码中$book_title和$book_price都是在for循环内部声明的局部变量,仅在当前循环的return逻辑中有效。
变量存储XML片段
declare variable也可以存储完整的XML片段,方便后续直接复用该片段:
declare variable $default_book :=; $default_book 默认书籍 未知作者 30
执行上述代码会直接返回声明的XML片段内容。
注意事项
使用declare variable时需要注意以下几点:
- 变量名称必须以$开头,且符合XQuery的命名规范,不能包含空格和特殊字符。
- 同一个作用域内不能重复声明同名的变量,否则会抛出语法错误。
- 外部变量如果需要接收外部传入的值,必须添加external关键字,否则无法获取外部传参。
XQuerydeclare_variable变量声明XML查询修改时间:2026-07-08 15:45:11