JDom 常用api 及 一般的使用

1 创建XML文件

Document doc = new Document(new Element("root"));

//或

Document doc = new Document();
Element root = new Element("root");
doc.addContent(root);

//添加子节点

Element person = new Element("person").setText("test1");
root.addContent(person);

//初始化时 一起添加

Document doc = new Document(new Element("person")
.addContent(new Element("mom"))
.addContent(new Element("dad"))

.addContent("kidOfDad")));

2

一般而言，使用org.jdom.input.SAXBuilder更快，推荐使用，

而org.jdom.input.DOMBuilder适用于已经存在DOM对象的场合。

解析XML文件

SAXBuilder b = new SAXBuilder();
Document doc = b.build(new File(xmlfilename));

//或

Document doc = b.build(new StringReader(Str));

获取根元素：

doc.getRootElement();

取得子节点：

List allChildren = element.getChildren();//

List namedChildren = element.getChildren("name");

Element kid = element.getChild("name");//返回第一个

增加/删除子节点：

allChildren.remove(3);
allChildren.removeAll(element.getChildren("jack"));

allChildren.add(new Element("jane"));

allChildren.add(1, new Element("second"));

读取/设置属性：

读取

String value =table.getAttributeValue("width");

//类型转换

try {
value =table.getAttribute("border").getIntValue();
}
catch (DataConversionException e) { }

设置

table.addAttribute("vspace", "0");

table.addAttribute(new Attribute("name", "value"));
table.removeAttribute("border");
table.getAttributes().clear();

获取元素的内容:

String content = element.getText();

element.getTextNormalize();// 移除多余的空白，字符串前后的空白，不会移除字符串内部的空白

设置元素的内容:

element.setText("description");

element.setText("<xml> content");//特殊字符可以被正确地转义

element.addContent(new CDATA("<xml> content"));//创建cdata元素

//cdata的作用

一些符号，例如∶"<"、">"、"/"、"？"等，当生成XML时，会破坏了XML结构

在CDATA内部的所有内容都会被解析器忽略。
一个 CDATA 部件以"<![CDATA[" 标记开始，以"]]>"标记结束:

3 输出XML:

XMLOutputter 类用来实现XML文件的输出，在创建的时候需要一个Format对象来格式化XML文件，

Format对象是一个工厂类，提供几个静态的工厂方法来提供一些常规的XML格式，比如getPrettyFormat()

XMLOutputter outputter = new XMLOutputter(Format.getPrettyFormat());
try {
outputter.output(doc, new FileOutputStream(new File("xmlfile/persons.xml")));
} catch (IOException e) {
e.printStackTrace();
}

//保存

Format format=Format.getCompactFormat();
//设置文档字符编码
format.setEncoding("UTF-8");
//设置缩进字符串
format.setIndent(" ");
//XMLOutputter类提供了将JDOM树输出为字节流的能力
XMLOutputter XMLOut=new XMLOutputter(format);
//输出到文件
XMLOut.output(doc,new FileOutputStream("student.xml"));



//输出到String

XMLOutputter output = new XMLOutputter();
output.setFormat(Format.getPrettyFormat().setEncoding("UTF-8"));
ByteArrayOutputStream bo = new ByteArrayOutputStream();

output.output(doc,bo);

xmlStr = bo.toString("UTF-8");

4 xml Namespace的支持:

获取名空间

Namespace xhtml = Namespace.getNamespace("xhtml", “http://www.w3.org/1999/xhtml”);

Namespace 对象可以作为Element 和Attribute的大多数方法的可选参数

List kids = element.getChildren("p", xhtml);
Element kid = element.getChild("title", xhtml);
Attribute height = element.getAttribute("height", xhtml);

//命名空间：

避免元素命名冲突（前缀）

元素中使用 xmlns

<table xmlns="http://www.w3.org/TR/html4/">

在这个元素内所有的标签都属于这个命名空间。

--------------------------------------------------------------------------------------------------------------------

一、DOM （文档对象模型）
为 XML 文档的已解析版本定义了一组接口。解析器读入整个文档，然后构建一个驻留内存的树结构，然后代码就可以使用 DOM 接口来操作这个树结构。
优点：整个文档树在内存中，便于操作；支持删除、修改、重新排列等多种功能；
缺点：将整个文档调入内存（包括无用的节点），浪费时间和空间；
使用场合：一旦解析了文档还需多次访问这些数据；
硬件资源充足（内存、CPU）
二、SAX
为解决DOM的问题，出现了SAX。
SAX ，事件驱动。当解析器发现元素开始、元素结束、文本、文档的开始或结束等时，发送事件，程序员编写响应这些事件的代码，保存数据。
优点：不用事先调入整个文档，占用资源少；
SAX解析器代码比DOM解析器代码小，适于Applet，下载
缺点：不是持久的；事件过后，若没保存数据，那么数据就丢了；
无状态性；从事件中只能得到文本，但不知该文本属于哪个元素；
使用场合：Applet;
只需XML文档的少量内容，很少回头访问；
机器内存少；
三、JDOM
为减少DOM、SAX的编码量，出现了JDOM；
优点：20-80原则，极大减少了代码量
使用场合：要实现的功能简单，如解析、创建等，但在底层，JDOM还是使用SAX（最常用）、DOM、Xanan
四、JAXP
为多个XML解析器提供了统一编程接口
更换解析器，不用更改代码
使用场合：若不用Jdom，一般建议使用JAPX，将代码与各种解析器的实现细节隔离。