Java中XPath.evaluate方法返回节点列表的实现方式
在Java中处理XML文档时，XPath是常用的查询工具，很多开发者会疑惑为什么调用XPath的evaluate方法无法直接拿到节点列表。其实这和方法的返回类型参数设置有关，默认情况下evaluate方法返回的是字符串类型的结果，需要显式指定返回类型为节点集合才能拿到节点列表。
核心原理说明
XPath类的evaluate方法有多个重载版本，其中最常用的三个参数版本是evaluate(String expression, Object item, QName returnType)。第三个参数returnType决定了方法的返回类型，如果要获取节点列表，需要传入XPathConstants.NODESET，此时方法返回的是NodeList类型的对象。
完整实现步骤
1. 准备XML示例文档
我们首先准备一个简单的XML文档作为解析对象，内容如下：
<?xml version="1.0" encoding="UTF-8"?>
<users>
<user id="1">
<name>张三</name>
<age>25</age>
</user>
<user id="2">
<name>李四</name>
<age>30</age>
</user>
<user id="3">
<name>王五</name>
<age>28</age>
</user>
</users>
2. 编写Java解析代码
下面的代码演示了如何使用XPath.evaluate方法获取所有user节点组成的节点列表，并遍历输出节点的属性与子元素内容：
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import javax.xml.xpath.XPath;
import javax.xml.xpath.XPathConstants;
import javax.xml.xpath.XPathFactory;
import org.w3c.dom.Document;
import org.w3c.dom.NodeList;
import org.w3c.dom.Node;
import java.io.File;
public class XPathNodeListDemo {
public static void main(String[] args) {
try {
// 1. 解析XML文档得到Document对象
DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
DocumentBuilder builder = factory.newDocumentBuilder();
// 替换为你的XML文件路径，这里使用本地文件路径示例
Document document = builder.parse(new File("users.xml"));
// 2. 创建XPath对象
XPathFactory xPathFactory = XPathFactory.newInstance();
XPath xPath = xPathFactory.newXPath();
// 3. 编写XPath表达式，查询所有user节点
String expression = "/users/user";
// 4. 调用evaluate方法，指定返回类型为XPathConstants.NODESET
NodeList nodeList = (NodeList) xPath.evaluate(expression, document, XPathConstants.NODESET);
// 5. 遍历节点列表
System.out.println("共找到" + nodeList.getLength() + "个user节点");
for (int i = 0; i < nodeList.getLength(); i++) {
Node userNode = nodeList.item(i);
// 获取user节点的id属性
String userId = userNode.getAttributes().getNamedItem("id").getNodeValue();
// 获取name子节点的文本内容
String userName = xPath.evaluate("name", userNode);
// 获取age子节点的文本内容
String userAge = xPath.evaluate("age", userNode);
System.out.println("用户ID：" + userId + "，姓名：" + userName + "，年龄：" + userAge);
}
} catch (Exception e) {
e.printStackTrace();
}
}
}
注意事项
- 如果XPath表达式匹配不到节点，evaluate方法返回的NodeList的
getLength()会返回0，不会返回null，不需要做空指针判断。 - 除了
XPathConstants.NODESET之外，还有XPathConstants.NODE用于返回单个节点，XPathConstants.STRING返回字符串，XPathConstants.NUMBER返回数字，XPathConstants.BOOLEAN返回布尔值，需要根据实际需求选择返回类型。 - 如果XPath表达式返回的不是节点类型，却指定了
XPathConstants.NODESET作为返回类型，会抛出XPathException异常，需要确保表达式的返回结果和指定的类型匹配。
常见场景扩展
如果需要获取特定条件的节点列表，只需要修改XPath表达式即可，比如获取年龄大于25岁的user节点，表达式可以改为/users/user[age > 25]，其他代码不需要修改，就能得到符合条件的节点列表。