saxon 不原生支持类似 jxpath 的“java 对象 xml 视图”式 xpath 求值；应将 java map 显式转换为 xpath 3.1 原生类型（如 map{}），再通过 s9api 安全、高效地执行表达式。
XPath 3.1 的设计哲学强调数据模型对齐：Java 的 Map
以下是一个可直接替代原 getXpathValueFromContentMap 方法的现代实现：
import net.sf.saxon.s9api.*;
import java.util.*;
public static Object getXpathValueFromContentMap(String xpathExpr, Map<String, Object> 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 返回类型一致，可平滑迁移业务逻辑。
⚠️ 注意事项：
立即学习“Java免费学习笔记（深入）”；
- Saxon-HE 免费版完全支持 XPath 3.1 + map{}/array{}，无需企业版；
- 避免重复创建 Processor（应单例复用），否则影响性能；
- JXPathNotFoundException 的静默忽略逻辑已由 result.size() == 0 替代，更符合函数式语义。
总结：放弃“XML 化 Java 对象”的旧范式，拥抱 XPath 3.1 原生数据类型，是升级中最关键也最可持续的设计跃迁。
