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