XPath 3.1 中在 Java Map 上执行表达式的正确实践

saxon 不原生支持类似 jxpath 的“java 对象 xml 视图”式 xpath 求值；应将 java map 显式转换为 xpath 3.1 原生类型（如 map{}），再通过 s9api 安全、高效地执行表达式。

XPath 3.1 的设计哲学强调数据模型对齐：Java 的 Map 应映射为 XPath 的 map(*)，而非伪装成 XML 节点树。Saxon-HE（尤其是 12.x+）提供了完整的 XDM（XQuery Data Model）支持，可通过 XdmMap 和 XdmValue 将 Java 结构无缝导入 XPath 上下文。

以下是一个可直接替代原 getXpathValueFromContentMap 方法的现代实现：

import net.sf.saxon.s9api.*;
import java.util.*;

public static Object getXpathValueFromContentMap(String xpathExpr, Map content, boolean asList) {
    try {
        Processor processor = new Processor(false);
        XPathCompiler compiler = processor.newXPathCompiler();
        XPathExecutable exec = compiler.compile(xpathExpr);

        // 将 Java Map → XPath map{}
        XdmMap xdmMap = XdmMap.fromMap(content, processor.getUnderlyingConfiguration());

        // 构建上下文：根项为该 map
        XPathSelector selector = exec.load();
        selector.setContextItem(xdmMap);

        if (asList) {
            // 返回所有匹配项（XPath 3.1 序列）
            return selector.evaluate().asList().stream()
                    .map(XdmItem::getUnderlyingValue)
                    .collect(Collectors.toList());
        } else {
            // 返回单个结果（自动解包序列首项或 null）
            XdmValue result = selector.evaluate();
            return result.size() == 0 ? null : result.itemAt(0).getUnderlyingValue();
        }
    } catch (SaxonApiException e) {
        // 日志建议：记录具体 XPath 编译/执行错误，便于调试
        return null;
    }
}

✅ 关键说明：

• XdmMap.fromMap() 自动递归转换嵌套 Map / List → XPath map{} / array{}，支持任意深度；
• XPath 表达式需适配 3.1 语法：例如原 JXPath 的 "user/name" 应改为 ?user?name（? 是 map 访问操作符）；
• 若需兼容旧表达式，可封装一层轻量转换器（如将 /user/name 重写为 ?user?name），但不推荐长期依赖语法桥接——应借升级契机重构为语义清晰的 XPath 3.1 风格；
• 注意 XdmValue.getUnderlyingValue() 返回原始 Java 对象（String, Integer, List, Map 等），与 JXPath 返回类型一致，可平滑迁移业务逻辑。

⚠️ 注意事项：

速创猫AI简历

一键生成高质量简历

下载

立即学习“Java免费学习笔记（深入）”；

• Saxon-HE 免费版完全支持 XPath 3.1 + map{}/array{}，无需企业版；
• 避免重复创建 Processor（应单例复用），否则影响性能；
• JXPathNotFoundException 的静默忽略逻辑已由 result.size() == 0 替代，更符合函数式语义。

总结：放弃“XML 化 Java 对象”的旧范式，拥抱 XPath 3.1 原生数据类型，是升级中最关键也最可持续的设计跃迁。