dom4j使用方法个人总结

1、网址：http://dom4j.sourceforge.net/
dom4j中的各个类的含义：
Attribute 定义了 XML 的属性。
Branch 指能够包含子节点的节点。如XML元素(Element)和文档(Docuemnts)定义了一个公共的行为
CDATA 定义了 XML CDATA 区域
CharacterData 是一个标识接口，标识基于字符的节点。如CDATA，Comment, Text.
Comment 定义了 XML 注释的行为
Document 定义了XML 文档
DocumentType 定义 XML DOCTYPE 声明
Element 定义XML 元素
ElementHandler 定义了Element 对象的处理器
ElementPath 被 ElementHandler 使用，用于取得当前正在处理的路径层次信息
Entity 定义 XML entity
Node 为dom4j中所有的XML节点定义了多态行为
NodeFilter 定义了在dom4j 节点中产生的一个滤镜或谓词的行为（predicate）
ProcessingInstruction 定义 XML 处理指令
Text 定义 XML 文本节点
Visitor 用于实现 Visitor模式
XPath 在分析一个字符串后会提供一个 XPath 表达式

2、解析文件：
打开文件：
SAXReader reader = new SAXReader();
Document document = reader.read(getAssets().open("weather.xml"));
在open函数中需要输入InputStream类型参数
获取根节点
Element root = document.getRootElement();
获取所有子节点
a) 使用list方法来保存所有的子节点 List<Element> childs = root.elements(); 然后使用for循环
List<Element> childs = root.elements();
for(Element child : childs){
List<Attribute> attributes = child.attributes();//所有的属性
List<Element> subChilds = child.elements();//所有的子节点
for(Attribute attribute : attributes){
builder.append(" ");
String name = attribute.getName();
builder.append(" ").append(name);
String value = attribute.getValue();
builder.append(" ").append(value);
Namespace nameSpace = attribute.getNamespace();
}
for(Element subChild : subChilds){
String name = subChild.getName();
builder.append(" ").append(name);
String value = subChild.getText();
builder.append(" ").append(value);
}
}
b) 使用迭代器的方法：
for (Iterator i = root.elementIterator(); i.hasNext();) {
Element child = (Element)i.next();
String value = child.attributeValue("data");
builder.append(" ").append(value);
}
通过迭代或者循环的方法就可以便利整个xml文件了
获取子节点：使用element()方法来获取。
Element child = root.element("aa");//获取节点名称为aa的子节点
获取内容
String value = child.getText();
获取节点名称，命名空间
String name= child.getName(); NameSpace nameSpace = child.getNameSpace();
获取属性
所有属性：List<Attribute> attributes = child.attributes();然后for循环或者Iterator iterator = child.attributeIterator();然后迭代 单个属性：Attribute attribute = child.attribute("aa");//名称为aa的属性 Attribute attribute = child.attribute(0);//第一个属性
属性值：
String value = attribute.getValue();
String name = attribute.getName();
String value = child.attributeValue("aaa");//属性名为aaa的值
3、xpath
dom4j使用xpath需要添加jaxen-1.1-beta-7.rar 库，否则会提示类无法找到异常。
有如下一个xml文档
<?xml version="1.0" encoding="ISO-8859-1"?>
<bookstore>
<book>
<title lang="eng">Harry Potter</title>
<price>29.99</price>
</book>
<book>
<title lang="eng">Learning XML</title>
<price>39.95</price>
</book>
</bookstore>
下面的xpath路径介绍使用此文档
xpath介绍：
选取节点
XPath 使用路径表达式在 XML 文档中选取节点。节点是通过沿着路径或者 step 来选取的。
下面列出了最有用的路径表达式：
表达式 描述
nodename 选取此节点的所有子节点。
/ 从根节点选取。
// 从匹配选择的当前节点选择文档中的节点，而不考虑它们的位置。
. 选取当前节点。
.. 选取当前节点的父节点。
@ 选取属性。

实例
在下面的表格中，我们已列出了一些路径表达式以及表达式的结果：
路径表达式 结果
bookstore 选取 bookstore 元素的所有子节点。
/bookstore 选取根元素 bookstore。注释：假如路径起始于正斜杠( / )，则此路径始终代表到某元素的绝对路径！
bookstore/book 选取属于 bookstore 的子元素的所有 book 元素。
//book 选取所有 book 子元素，而不管它们在文档中的位置。
bookstore//book 选择属于 bookstore 元素的后代的所有 book 元素，而不管它们位于 bookstore 之下的什么位置。
//@lang 选取名为 lang 的所有属性。

选取未知节点
XPath 通配符可用来选取未知的 XML 元素。
通配符 描述
* 匹配任何元素节点。
@* 匹配任何属性节点。
node() 匹配任何类型的节点。
实例
在下面的表格中，我们列出了一些路径表达式，以及这些表达式的结果：
路径表达式 结果
/bookstore/* 选取 bookstore 元素的所有子元素。
//* 选取文档中的所有元素。
//title[@*] 选取所有带有属性的 title 元素。


谓语（Predicates）
谓语用来查找某个特定的节点或者包含某个指定的值的节点。
谓语被嵌在方括号中。
实例
在下面的表格中，我们列出了带有谓语的一些路径表达式，以及表达式的结果：
路径表达式 结果
/bookstore/book[1] 选取属于 bookstore 子元素的第一个 book 元素。
/bookstore/book[last()] 选取属于 bookstore 子元素的最后一个 book 元素。
/bookstore/book[last()-1] 选取属于 bookstore 子元素的倒数第二个 book 元素。
/bookstore/book[position()<3] 选取最前面的两个属于 bookstore 元素的子元素的 book 元素。
//title[@lang] 选取所有拥有名为 lang 的属性的 title 元素。
//title[@lang='eng'] 选取所有 title 元素，且这些元素拥有值为 eng 的 lang 属性。
/bookstore/book[price>35.00] 选取 bookstore 元素的所有 book 元素，且其中的 price 元素的值须大于 35.00。
/bookstore/book[price>35.00]/title 选取 bookstore 元素中的 book 元素的所有 title 元素，且其中的 price 元素的值须大于 35.00。

选取若干路径
通过在路径表达式中使用“|”运算符，您可以选取若干个路径。
实例
在下面的表格中，我们列出了一些路径表达式，以及这些表达式的结果：
路径表达式 结果
//book/title | //book/price 选取 book 元素的所有 title 和 price 元素。
//title | //price 选取文档中的所有 title 和 price 元素。
/bookstore/book/title | //price 选取属于 bookstore 元素的 book 元素的所有 title 元素，以及文档中所有的 price 元素。

XPath 轴
轴可定义相对于当前节点的节点集。
轴名称 结果
ancestor 选取当前节点的所有先辈（父、祖父等）。
ancestor-or-self 选取当前节点的所有先辈（父、祖父等）以及当前节点本身。
attribute 选取当前节点的所有属性。
child 选取当前节点的所有子元素。
descendant 选取当前节点的所有后代元素（子、孙等）。
descendant-or-self 选取当前节点的所有后代元素（子、孙等）以及当前节点本身。
following 选取文档中当前节点的结束标签之后的所有节点。
namespace 选取当前节点的所有命名空间节点。
parent 选取当前节点的父节点。
preceding 选取文档中当前节点的开始标签之前的所有节点。
preceding-sibling 选取当前节点之前的所有同级节点。
self 选取当前节点。

位置路径表达式
位置路径可以是绝对的，也可以是相对的。
绝对路径起始于正斜杠( / )，而相对路径不会这样。在两种情况中，位置路径均包括一个或多个步，每个步均被斜杠分割：
绝对位置路径：
/step/step/...
相对位置路径：
step/step/...

每个步均根据当前节点集之中的节点来进行计算。
步（step）包括：
轴（axis）
定义所选节点与当前节点之间的树关系
节点测试（node-test）
识别某个轴内部的节点
零个或者更多谓语（predicate）
更深入地提炼所选的节点集
步的语法：
轴名称::节点测试[谓语]
实例
例子 结果
child::book 选取所有属于当前节点的子元素的 book 节点。
attribute::lang 选取当前节点的 lang 属性。
child::* 选取当前节点的所有子元素。
attribute::* 选取当前节点的所有属性。
child::text() 选取当前节点的所有文本子节点。
child::node() 选取当前节点的所有子节点。
descendant::book 选取当前节点的所有 book 后代。
ancestor::book 选择当前节点的所有 book 先辈。
ancestor-or-self::book 选取当前节点的所有 book 先辈以及当前节点（如果此节点是 book 节点）
child::*/child::price 选取当前节点的所有 price 孙节点。

使用xpath选择节点List<Attributes> attributes = document.selectNodes(/books/book/@show);//books下的book子节点的show属性
Element element = (Element)root.selectSingleNode("//forecast_information");//第一个forecast_information子节点

4、编写或修改xml
创建文档：Document document = DocumentHelper.createDocument();
创建元素: Element root = document.addElement("root");
Element testElement = root.addElement("test");//给root添加一个子节点
testElement.setText("test");//设置值
testElement.addAttribute("data", "1");//增加设置属性data值
OutputStream outPutStream = openFileOutput("test.xml", Context.MODE_PRIVATE | Context.MODE_APPEND); //创建一个输出流，android的Context类的函数用来打开一个输出流
OutputFormat format = OutputFormat.createPrettyPrint();//设置良好编码格式
format.setEncoding("UTF-8");
XMLWriter xmlWriter = new XMLWriter(outPutStream,format);//创建一个XmlWriter用于xml写
xmlWriter.write(document);//将document存入到XmlWriter中
xmlWriter.close();//关闭

上面代码生成的xml文档如下：
<?xml version="1.0" encoding="UTF-8"?>

<root>
<test data="1">test</test>
</root>


删除元素 element.remove(),参数可以为属性，元素，节点等，具体参考帮助文档。
5、其他操作
修改属性值： attribute.setValue("aaa");//将属性值修改为aaa
修改元素值：element.setText("bbb");//将元素值修改为bbb

解析XML形式的文本,得到document对象.
String text = "<members></members>";
Document document = DocumentHelper.parseText(text);

添加一个CDATA节点.
Element contentElm = infoElm.addElement("content");
contentElm.addCDATA(diary.getContent());

6、字符串与XML的转换
1、将字符串转化为XML
String text = "<members> <member>sitinspring</member> </members>";
Document document = DocumentHelper.parseText(text);
2、将文档或节点的XML转化为字符串.
SAXReader reader = new SAXReader();
Document document = reader.read(new File("input.xml"));
Element root=document.getRootElement();
String docXmlText=document.asXML();
String rootXmlText=root.asXML();
Element memberElm=root.element("member");
String memberXmlText=memberElm.asXML();
参考网站：
http://blog.csdn.net/chenweitang123/article/details/6230435
http://blog.csdn.net/chenweitang123/article/details/6252263
http://blog.csdn.net/chenweitang123/article/details/6255108#_Toc288084404
http://www.w3school.com.cn/xpath/xpath_syntax.asp