编写简单的XPath程序

当前使用XPath 1.0

1,需求说明 
假设要查询一个图书列表,寻找TEST的著作. 

2,创建项目 
创建一个Java项目. 

Java 1.5推出了javax.xml.xpath包,提供一个引擎和对象模型独立的XPath库.只要Java环境>1.5,无需增加类库. 

这个包也可用于Java 1.3及以后的版本,但需要单独安装Java API for XML Processing(JAXP)1.3 

提示:Xalan 2.7 和Saxon 8 以及其他产品包含了这个库的实现. 

3,创建包含图书信息的XML文档 
编写包含图书信息的XML文档,将其命名为books.xml,并将其放至在src目录下:

Java代码 

1. <inventory>  
2.         <book year="2000">  
3.                 <title>Thinking in Java</title>  
4.                 <author>TEST</author>  
5.                 <publisher>JQGYCBS</publisher>  
6.                 <isbn>80958</isbn>  
7.                 <price>98.95</price>  
8.         </book>  
9.   
10.         <book year="2005">  
11.                 <title>ROR</title>  
12.                 <author>TEST</author>  
13.                 <publisher>DZGYCBS</publisher>  
14.                 <isbn>0743416910</isbn>  
15.                 <price>65.99</price>  
16.         </book>  
17.   
18.         <book year="1995">  
19.                 <title>H</title>  
20.                 <author>King</author>  
21.                 <publisher>Sc</publisher>  
22.                 <isbn>0553862</isbn>  
23.                 <price>77.50</price>  
24.         </book>  
25. </inventory>  

4,XPath表达式的使用介绍 
查找所有图书的 XPath 查询非常简单:

Java代码 

1. //book[author="TEST"]  
2.  book代表节点的名称,author属性的名称,后面是要查询的值  

为了找出这些图书的标题(title),只要增加一步,表达式就变成了:

Java代码 

1. //book[author="TEST"]/title  
2.  title代表要取元素的名称  

最后,真正需要的是 title 元素的文本节点内容.这就要求再增加一步,完整的表达式就是:

Java代码 

1. //book[author="TEST"]/title/text()  
2.  text()该节点的内容  

5,编写代码 
现在提供一个简单的程序,它从 Java 语言中执行以上的表达式查询,然后把找到的所有图书的标题打印出来. 

5.1,将XML文档加载到DOM Document对象中 
首先,需要将文档加载到一个 DOM Document 对象中. 

下面的简单代码片段解析文档并建立对应的 Document 对象:

Java代码 

1. //用 JAXP 解析文档  
2. DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();  
3. // never forget this!  
4. factory.setNamespaceAware(true);  
5. DocumentBuilder builder = factory.newDocumentBuilder();  
6. Document doc = builder.parse("src/books.xml");  

到目前为止,这仅仅是标准的 JAXP 和 DOM. 

5.2,创建 XPathFactory

Java代码 

1. XPathFactory pathFactory = XPathFactory.newInstance();  

XPathFactory说明: 

XPathFactory是一个抽象工厂. 

抽象工厂设计模式使得这一种 API 能够支持不同的对象模型,如 DOM、JDOM 和 XOM. 

为了选择不同的模型,需要向XPathFactory.newInstance()方法传递标识对象模型的统一资源标识符(URI). 

比如 http://xom.nu/ 可以选择 XOM.但实际上,到目前为止 
DOM 是该 API 支持的惟一对象模型. 

5.3,使用XPathFactory工厂创建 XPath 对象

Java代码 

1. XPath xpath = pathFactory.newXPath();  

5.4,使用XPath对象编译XPath表达式

Java代码 

1. XPathExpression pathExpression = xpath.compile("//book[author='TEST']/title/text()");  

5.5,计算 XPath 表达式得到结果 
表达式是针对特定的上下文节点计算的,在这个例子中是整个文档.这时还必须指定返回类型.这里要求返回一个节点集:

Java代码 

1. Object result = pathExpression.evaluate(doc, XPathConstants.NODESET);  
2. //doc是Document对象名,XPathConstants代表XPath常量,NODESET是XPath 1.0 NodeSet数据类型  
3. //XPathConstants.NODESET将XPathConstants常量返回NODESET类型  

说明: 
多数 XPath 表达式,特别是位置路径,都返回节点集. 

但是还有其他可能: 


比如,XPath 表达式:count(//book) 返回文档中的图书数量. 
XPath 表达式:count(//book[author="TEST"]) > 10 返回一个布尔值:如果文档中 TEST的著作超过 10 本则返回 true,否则返回 false. 



evaluate() 方法被声明为返回 Object,实际返回什么依赖于 XPath 表达式的结果以及要求的类型 

一般来说,XPath与Java的映射关系是: 


number 映射为 java.lang.Double 
string 映射为 java.lang.String 
boolean 映射为 java.lang.Boolean 
node-set 映射为 org.w3c.dom.NodeList 


在 Java 中计算 XPath 表达式时,第二个参数(XPathConstants常量)指定需要的返回类型.有五种可能,都在 javax.xml.xpath.XPathConstants 类中命名了常量: 

XPathConstants.NODESET 
XPathConstants.BOOLEAN 
XPathConstants.NUMBER 
XPathConstants.STRING 
XPathConstants.NODE 

XPathConstants.NODE提示: 

最后一个 XPathConstants.NODE 实际上没有匹配的 XPath 类型.只有知道 XPath 表达式只返回一个节点或者只需要一个节点时才使用它.如果 XPath 表达式返回了多个节点并且指定了 XPathConstants.NODE,则 evaluate() 按照文档顺序返回第一个节点.如果 XPath 表达式选择了一个空集并指定了 XPathConstants.NODE,则 evaluate() 返回 null. 



注意:如果不能完成要求的转换,evaluate()将抛出 XPathException. 

5.6,将结果强制转化成 DOM NodeList 
通过将结果强制转化成 DOM NodeList,然后遍历列表就能得到所有的标题:

Java代码 

1. NodeList nodes = (NodeList) result;  
2.         for (int i = 0; i < nodes.getLength(); i++) {  
3.                 System.out.println(nodes.item(i).getNodeValue());  
4.         }  

6,完整Java程序代码 

Java代码 

1. package book;  
2.   
3. import javax.xml.parsers.DocumentBuilder;  
4. import javax.xml.parsers.DocumentBuilderFactory;  
5. import javax.xml.xpath.XPath;  
6. import javax.xml.xpath.XPathConstants;  
7. import javax.xml.xpath.XPathExpression;  
8. import javax.xml.xpath.XPathFactory;  
9.   
10. import org.w3c.dom.Document;  
11. import org.w3c.dom.NodeList;  
12.   
13. public class Test {  
14.         public static void main(String[] args) throws Exception {  
15.                 DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();  
16.                 factory.setNamespaceAware(true); // never forget this!  
17.                 DocumentBuilder builder = factory.newDocumentBuilder();  
18.                 Document doc = builder.parse("src/books.xml");  
19.   
20.                 XPathFactory pathFactory = XPathFactory.newInstance();  
21.   
22.                 XPath xpath = pathFactory.newXPath();  
23.   
24.                 XPathExpression pathExpression = xpath  
25.                                 .compile("//book[author='TEST']/title/text()");  
26.   
27.                 Object result = pathExpression.evaluate(doc, XPathConstants.NODESET);  
28.   
29.                 NodeList nodes = (NodeList) result;  
30.                 for (int i = 0; i < nodes.getLength(); i++) {  
31.                         System.out.println(nodes.item(i).getNodeValue());  
32.                 }  
33.         }  
34. }