一:构建dom4j树(表示为Document 元素)
常用方法:
方式一:直接创建所有元素:dom4j为我们准备了工具类DocumentHelper ,该类的所有的方法都是静态方法,用来创建xml文档的各个组成部分。

1.1.1创建Document 和Element对象:
Document doc=DocumentHelper.createDocument();
Element eltRoot=DocumentHelper.createElement(“student”);
doc.setEltRootElement(eltRoot);

1.1.2或者先准备好根元素,使用有参数的构造方法创建Document对象。
Element eltRoot=DocumentHelper.createElement(“student”);
Document doc=DocumentHelper.createDocument(eltRoot);

1.2:添加节点和设置节点内容:
方法:Branch 接口中定义的方法;
public Element addElemen(String name) //以指定的name 为当前节点创建一个子节点,并返回新节点的引用
public void setText(String text) //将content设置为节点的内容

示例如下:
Element eltName=eltRoot.addElement(“name”);
Element eltAge=eltRoot.addElement(“age”);
eltName.setText(“张三”);
eltAge.setText(“18”);

1.3:添加属性
方法:public Element addAttribute(String name,String value)

示例如下:
eltRoot.addAttribute(“sn”,”01”);

方式二:
2.1:org.dom4j.io提供了两个类:SAXReader和DOMReader,前者从一个现有的w3c DOM树构建dom4j树,而SAXReader则使用SAX解析器,从不同的输入源构建dom4j树。

2.1.1: 使用 SAXReader 构建dom4j文档对象:示例如下:

SAXReader saxReader=new SAXReader();
File file=new File(“student.xml”);
Document doc=saxReader.read(file);

2.2.1:使用DOMReader 构建dom4j 文档对象.

DocumentBuilderFactory dbf=new DocumentBuilderFactory.newInstance();
DocumentBuilder db=dbf.newDocumentBuilder();
File file=new File(“student.xml”);
org.w3c.dom.Document document=db.parse(file);
DOMReader domReader=new DOMReader();
org.dom4j.Document doc=domReader.read(document);

访问根节点:
Element root=doc.getRootElement();
访问节点:
访问所有节点:
java.util.List childrenList=elt.elements();

访问指定名称的所有节点
java.util.Liat childrenList=elt.elements(“student”);

访问指定名称第一个节点
Element eltChild=elt.element(“student”);

要迭代某个元素的所有子元素:
for(java.util.Iterator it=root.elementIterator();it.hasNext()){
Element element =it.hasNext();
……
}

Dom4j 中集成了对XPath的支持。在选择节点时,可以直接使用XPath 表达式,例如:
要选择例子文件 students.xml中的所有的元素,代码如下:
java.util.List l=root.selectNodes(“//name”);

要选择属性sn的值等于01的元素,代码如下:
java.util.List l=root.selectNodes(“//student[@sn=’01’]”);

注意:为了能够编译执行上述使用XPath表达式的代码,需要配置dom4j 安装包中自带的jaxen包,你也可以从http://sourceforge.net/products/jaxen/上下载jaxen。jaxen是一个用java开发的XPath引擎,用于配合各种基于XML的对象模型,如DOM,dom4j和JDOM。在dom4-1.6.1 目录下,有一个lib 子目录,其中有个jaxen-1.1-beta-6.jar文件,需要在classpath环境变量中配置该文件的全路径名。

访问属性:
要得到某个元素的所有属性,,如下:
java.util.List attrList=elt.attributes();
要得到指定的属性,如下:
Attribute attr=elt.attribute(“sn”);
要得到某个属性的值;如下:
String attrValue=elt.attributeValue(“sn”);

删除节点和节点的属性:
要删除某个元素::可以用Branch接口中定义的remove()方法,如下:
Element eltStu=root.element(“student”);
root.remove(eltStu);

要删除某个属性;如下:
elt.remove(elt.attribute(“sn”));

输出文档:
对象:XMLWriter 实例方法:write(Document doc)
常用的几种构造方法总结:
1:无参数:
2:字节流参数
3:字符流参数。
4:文档输出格式类参数。
示例代码1:
输出文档内容到控制台
XMLWriter xw=new XMLWriter();
xw.write(doc);
示例代码2:
输出文档内容到文件。构造XMLWriter 对象的时候,可以传递字节流参数。其底层代码设置了自动刷新机制。
XMLWriter xw=new XMLWriter(new java.io.FileOutputStream(“student.xml”));
xw.write(doc);

示例代码3:
构造XMLWriter 对象的时候,可以传递java.io.Writer对象。
XMLWriter xw=new XMLWriter(new java.io.FileWriter(“student.xml”));
xw.write(doc);
xw.close();
注意:使用java.io.Writer对象构建的XMLWriter对象,则没有设置自动刷新机制,所以在调用write()方法之后,还要调用xw.close()或者xw.flush()方法。并且XMLWriter 继承自org.xml.sax.helpers.XMLFilterImpl类。它所提供的close()和flush()方法只是其内部java.io.Writer 对象的flush()和close()方法的封装方法。

示例代码4:
构造XMLWriter 对象的时候,可以传递文档输出格式类org.dom4j.io.OutputFormat,利用这个类,可以设置输出文档的字符编码,设置行分割符以及控制使用的缩进字符串等。

下面的代码输出格式使用4个空格作为缩进字符串,元素之间添加新行。

OutputFormat outFmt=new OutputFormat(“ ”,true);
XMLWriter xw=new XMLWriter(outFmt);
xw.write(doc);

下面的代码采用美化的格式输出文档,设置字符串编码为GB2312,并且用4个空格作为缩进。
OutputFormat outFmt=OutputFormat.createPrettyPrint();
outFmt.setEncoding(“GB2312”);
outFmt.setIndent(“ ”);
XMLWriter xw=new XMLWriter(outFmt);
xw.write(doc);

dom4j的名称空间 信息api
常用的方法有8个。

dom4j在Element和Attribute 接口中定义了获取名称空间信息的方法,这些方法和JDOM中的方法相同。如下所示:
public java.lang.String getNamespacePrefix()
该方法返回元素(属性)的名称空间前缀
public java.lang.String getNamespaceURI()
该方法返回元素(属性)的名称空间URI
public java.lang.String getName()
该方法返回元素(属性)的本地名
public java.lang.String getQualifiedName()
该方法返回元素(属性)的限定名
public Namespace getNamespace()
该方法返回元素本身的名称空间
public java.util.List additionalNamespaces()
返回某元素上附加的名称空间声明列表,列表中的每一个对象都是Namespace类型。这个类的方法提供了两个方法分别获得名称空间前缀和本地名。如下:

public java.lang.String getPrefix()
该方法返回名称空间前缀。
public java.lang.String getURI()
该方法返回名称空间的URI。