saxon 不原生支持类似 jxpath 的“java 对象 → xml 节点视图”映射，但可通过将 java map 显式转换为 xpath 3.1 原生数据类型（如 `map(*)`）实现等效功能，需调整表达式语法并使用 saxon 的 xdm 模型进行绑定。
在 XPath 3.1 及 Saxon-HE 环境下，不能直接对 Java Map
✅ 正确迁移路径是：*将 Java Map 显式转换为 Saxon 的 XdmMap（对应 XPath `map()` 类型），再通过变量绑定 + XPath 3.1 原生语法访问**。
以下是一个完整可运行的示例：
import net.sf.saxon.s9api.*;
import java.util.*;
public class XPathOnMap {
public static Object getXpathValueFromContentMap(String xpathExpr, Map content, boolean asList)
throws SaxonApiException {
Processor processor = new Processor(false);
XPathCompiler compiler = processor.newXPathCompiler();
// 启用 XPath 3.1 支持
compiler.setLanguageVersion("3.1");
// 将 Java Map → Saxon XdmMap（自动递归转换嵌套 Map/List）
XdmMap xdmMap = XdmMap.fromMap(content, processor);
// 编译表达式：注意——必须以 "$map" 为根变量引用（非 "/" 开头！）
XPathExecutable exec = compiler.compile(xpathExpr);
XPathSelector selector = exec.load();
selector.setVariable(QName.fromClarkName("map"), xdmMap);
if (asList) {
return selector.evaluate().toList(); // 返回 List
} else {
XdmValue result = selector.evaluate();
return result.size() == 0 ? null : result.itemAt(0).getUnderlyingValue();
}
}
// 使用示例
public static void main(String[] args) throws SaxonApiException {
Map data = new HashMap<>();
data.put("user", Map.of("name", "Alice", "age", 30));
data.put("tags", List.of("dev", "java"));
// ✅ XPath 3.1 原生语法（非 JXPath 风格！）
System.out.println(getXpathValueFromContentMap("$map?user?name", data, false)); // "Alice"
System.out.println(getXpathValueFromContentMap("$map?tags[1]", data, false)); // "dev"
System.out.println(getXpathValueFromContentMap("$map?user?age ge 25", data, false)); // true
}
} ? 关键要点与注意事项：
立即学习“Java免费学习笔记（深入）”；
- 表达式语法完全不同：JXPath 使用 /user/name 这类路径式语法；Saxon + XdmMap 必须使用 $map?key1?key2 或 $map("key1")("key2") 等 XPath 3.1 map 访问语法；
- 变量绑定是必须步骤：selector.setVariable(...) 将 XdmMap 绑定为变量（如 $map），不可省略；
- 类型安全转换：XdmMap.fromMap() 会自动将 java.util.Map → map(*)、List → array(*)、基本类型 → 对应 XDM 类型（String→xs:string，Integer→xs:integer）；
- 空值处理：若 key 不存在，$map?missing 返回空序列 ()，不会抛异常，符合 XPath 行为；
- 性能考量：每次调用都新建 Processor 不推荐用于高频场景；应复用 Processor 和 XPathCompiler 实例（线程安全）；
-
依赖声明（Maven）：
net.sf.saxon Saxon-HE 12.4
总结：迁移的本质不是“模拟 JXPath”，而是拥抱 XPath 3.1 的函数式数据模型。放弃 /path/to/value 思维，转向 $data?field?subfield 或 map:keys($data) 等原生能力，才能真正发挥 Saxon 与 XPath 3.1 的表达力与性能优势。
