`
fastwind
  • 浏览: 325151 次
  • 性别: Icon_minigender_1
  • 来自: 天津
社区版块
存档分类
最新评论

JDOM 介绍及使用指南

阅读更多

一、JDOM 简介
JDOM是一个开源项目,它基于树型结构,利用纯JAVA的技术对XML文档实现解析、生成、序列化以及多种操作。
JDOM 直接为JAVA编程服务。它利用更为强有力的JAVA语言的诸多特性(方法重载、集合概念以及映射),把SAX和DOM的功能有效地结合起来。
在使用设计上尽可能地隐藏原来使用XML过程中的复杂性。利用JDOM处理XML文档将是一件轻松、简单的事。
JDOM 在2000年的春天被Brett McLaughlin和Jason Hunter开发出来,以弥补DOM及SAX在实际应用当中的不足之处。
这些不足之处主要在于SAX没有文档修改、随机访问以及输出的功能,而对于DOM来说,JAVA程序员在使用时来用起来总觉得不太方便。
DOM的缺点主要是来自于由于Dom是一个接口定义语言(IDL),它的任务是在不同语言实现中的一个最低的通用标准,并不是为JAVA特别设计的。JDOM的最新版本为JDOM Beta 9。最近JDOM被收录到JSR-102内,这标志着JDOM成为了JAVA平台组成的一部分。


二、JDOM 包概览
JDOM是由以下几个包组成的
org.JDOM
org.JDOM.input
org.JDOM.output
org.JDOM.adapters
org.JDOM.transform

三、JDOM 类说明

org.JDOM
这个包里的类是你解析xml文件后所要用到的所有数据类型。
Attribute
CDATA
Coment
DocType
Document
Element
EntityRef
Namespace
ProscessingInstruction
Text

org.JDOM.transform
在涉及xslt格式转换时应使用下面的2个类
JDOMSource
JDOMResult

org.JDOM.input
输入类,一般用于文档的创建工作
SAXBuilder
DOMBuilder
ResultSetBuilder

org.JDOM.output
输出类,用于文档转换输出
XMLOutputter
SAXOutputter
DomOutputter
JTreeOutputter

使用前注意事项:
1.JDOM对于JAXP 以及 TRax 的支持
JDOM 支持JAXP1.1:你可以在程序中使用任何的parser工具类,默认情况下是JAXP的parser。
制定特别的parser可用如下形式
SAXBuilder parser 
= new SAXBuilder("org.apache.crimson.parser.XMLReaderImpl");
Document doc = parser.build("http://www.cafeconleche.org/");
// work with the document...
JDOM也支持TRaX:XSLT可通过JDOMSource以及JDOMResult类来转换(参见以后章节)
2.注意在JDOM里文档(Document)类由org.JDOM.Document 来表示。这要与org.w3c.dom中的Document区别开,这2种格式如何转换在后面会说明。
以下如无特指均指JDOM里的Document。


四、JDOM主要使用方法
1.Ducument类
(1)Document的操作方法:
Element root = new Element("GREETING");
Document doc = new Document(root);
root.setText("Hello JDOM!");
或者简单的使用Document doc = new Document(new Element("GREETING").setText("Hello JDOM!t"));

这点和DOM不同。Dom则需要更为复杂的代码,如下:
DocumentBuilderFactory factory =DocumentBuilderFactory.newInstance();
DocumentBuilder builder =factory.newDocumentBuilder();
Document doc = builder.newDocument();
Element root =doc.createElement("root");
Text text = doc.createText("This is the root");
root.appendChild(text);
doc.appendChild(root);


注意事项:JDOM不允许同一个节点同时被2个或多个文档相关联,要在第2个文档中使用原来老文档中的节点的话。首先需要使用detach()把这个节点分开来。

(2)从文件、流、系统ID、URL得到Document对象:
DOMBuilder builder = new DOMBuilder();
Document doc = builder.build(new File("jdom_test.xml"));

SAXBuilder builder = new SAXBuilder();
Document doc = builder.build(url);
在新版本中DOMBuilder 已经Deprecated掉 DOMBuilder.builder(url),用SAX效率会比较快。

这里举一个小例子,为了简单起见,使用String对象直接作为xml数据源:

public jdomTest() {
  String textXml = null;
  textXml = "<note>";
  textXml = textXml +
  "<to>aaa</to><from>bbb</from><heading>ccc</heading><body>ddd</body>";
  textXml = textXml + "</note>";
  SAXBuilder builder = new SAXBuilder();
  Document doc = null;
  Reader in= new StringReader(textXml);
  try {
  doc = builder.build(in);
  Element root = doc.getRootElement();
  List ls = root.getChildren();//注意此处取出的是root节点下面的一层的Element集合
  for (Iterator iter = ls.iterator(); iter.hasNext(); ) {
  Element el = (Element) iter.next();
  if(el.getName().equals("to")){
  System.out.println(el.getText());
  }
  }
  }
  catch (IOException ex) {
  ex.printStackTrace();
  }
  catch (JDOMException ex) {
  ex.printStackTrace();
  }
}
 
很简单把。


(3)DOM的document和JDOM的Document之间的相互转换使用方法,简单!
DOMBuilder builder = new DOMBuilder();
org.jdom.Document jdomDocument = builder.build(domDocument);
// work with the JDOM document…

DOMOutputter converter = new DOMOutputter();
org.w3c.dom.Document domDocument = converter.output(jdomDocument);
// work with the DOM document…

2.XML文档输出
XMLOutPutter类:
JDOM的输出非常灵活,支持很多种io格式以及风格的输出
Document doc = new Document(...);
XMLOutputter outp = new XMLOutputter();
// Raw output
outp.output(doc, fileOutputStream);
// Compressed output
outp.setTextTrim(true);
outp.output(doc, socket.getOutputStream());
// Pretty output
outp.setIndent(" ");
outp.setNewlines(true);
outp.output(doc, System.out);
......
详细请参阅最新的JDOM API手册


3.Element 类:
(1)浏览Element树
//获得根元素element
Element root = doc.getRootElement();
// 获得所有子元素的一个list
List allChildren = root.getChildren();
// 获得指定名称子元素的list
List namedChildren = root.getChildren("name");
//获得指定名称的第一个子元素
Element child = root.getChild("name");
(这里的List是java.util.List)

JDOM给了我们很多很灵活的使用方法来管理子元素
List allChildren = root.getChildren();
// 删除第四个子元素
allChildren.remove(3);
// 删除叫“jack”的子元素
allChildren.removeAll(root.getChildren("jack"));

root.removeChildren("jack"); // 便捷写法
// 加入
allChildren.add(new Element("jane"));

root.addContent(new Element("jane")); // 便捷写法
allChildren.add(0, new Element("first"));


(2)移动Elements:
在JDOM里很简单
Element movable = new Element("movable");
parent1.addContent(movable); // place
parent1.removeContent(movable); // remove
parent2.addContent(movable); // add

在Dom里
Element movable = doc1.createElement("movable");
parent1.appendChild(movable); // place
parent1.removeChild(movable); // remove
parent2.appendChild(movable); // 出错!

补充:
纠错性
JDOM的Element构造函数(以及它的其他函数)会检查element是否合法。
而它的add/remove方法会检查树结构,检查内容如下:
1.在任何树中是否有回环节点
2.是否只有一个根节点
3.是否有一致的命名空间(Namespaces)



(3)Element的text内容读取
<description>
A cool demo
</description>

// The text is directly available
// Returns "\n A cool demo\n"
String desc = element.getText();

// There's a convenient shortcut
// Returns "A cool demo"
String desc = element.getTextTrim();

(4)Elment内容修改
element.setText("A new description");
3.可正确解释特殊字符
element.setText("<xml> content");
4.CDATA的数据写入、读出
element.addContent(new CDATA("<xml> content"));
String noDifference = element.getText();

混合内容
element可能包含很多种内容,比如说

<table>
<!-- Some comment -->
Some text
<tr>Some child element</tr>
</table>

取table的子元素tr
String text = table.getTextTrim();
Element tr = table.getChild("tr");

也可使用另外一个比较简单的方法
List mixedCo = table.getContent();
Iterator itr = mixedCo.iterator();
while (itr.hasNext()) {
Object o = i.next();
if (o instanceof Comment) {
...
}
// 这里可以写成Comment, Element, Text, CDATA,ProcessingInstruction, 或者是EntityRef的类型
}
// 现在移除Comment,注意这里游标应为1。这是由于回车键也被解析成Text类的缘故,所以Comment项应为1。
mixedCo.remove(1);



4.Attribute类
<table width="100%" border="0"> </table>
//获得attribute
String width = table.getAttributeValue("width");
int border = table.getAttribute("width").getIntValue();
//设置attribute
table.setAttribute("vspace", "0");
// 删除一个或全部attribute
table.removeAttribute("vspace");
table.getAttributes().clear();



5.处理指令(Processing Instructions)操作
一个Pls的例子
<?br?>
<?cocoon-process type="xslt"?>
  | |
  | |
  目标 数据

处理目标名称(Target)
String target = pi.getTarget();
获得所有数据(data),在目标(target)以后的所有数据都会被返回。
String data = pi.getData();
获得指定属性的数据
String type = pi.getValue("type");
获得所有属性的名称
List ls = pi.getNames();

6.命名空间操作
<xhtml:html 
xmlns:xhtml="http://www.w3.org/1999/xhtml">
<xhtml:title>Home Page</xhtml:title>
</xhtml:html>

Namespace xhtml = Namespace.getNamespace("xhtml", "http://www.w3.org/1999/xhtml");
List kids = html.getChildren("title", xhtml);
Element kid = html.getChild("title", xhtml);
kid.addContent(new Element("table", xhtml));

7.XSLT格式转换
使用以下函数可对XSLT转换
最后如果你需要使用w3c的Document则需要转换一下。
public static Document transform(String stylesheet,Document in)
  throws JDOMException {
  try {
  Transformer transformer = TransformerFactory.newInstance()
  .newTransformer(new StreamSource(stylesheet));
  JDOMResult out = new JDOMResult();
  transformer.transform(new JDOMSource(in), out);
  return out.getDeocument();
  }
  catch (TransformerException e) {
  throw new JDOMException("XSLT Trandformation failed", e);
  }
  }
 

参考书目:

1.JDOM官方网站: http://www.jdom.org

2.<<Processing XML with Java>> Elliotte Rusty Harold 2002

3.JDOM API Documentation

4.<<JDOM Makes XML Easy>>Jason Hunter Co-Creator JDOM Project

5.WSDP Tutorial

分享到:
评论

相关推荐

    jdom介绍及使用指南

    ### JDOM介绍及使用指南 #### 一、JDOM包概览 JDOM是一个轻量级的Java XML API,它提供了简洁的API用于处理XML文档。JDOM的主要优点在于其简单性和易于使用性,适用于那些希望避免DOM的复杂性和SAX的事件驱动模型...

    jdom的两种版本jar包集合

    - **README.txt**: 提供关于JDOM库的基本信息和使用指南,通常会包含安装步骤、依赖关系以及注意事项等。 - **LICENSE.txt**: 记录了JDOM的许可协议,规定了软件的使用、分发和修改的法律条款。 - **lib**: 可能包含...

    java org.jdom 包下载

    6. **README.txt**:通常提供有关如何使用软件的基本信息,包括安装指南、版本说明等。 7. **LICENSE.txt**:描述了JDOM的许可协议,对于开源项目,这通常是MIT、Apache 2.0或其他类似许可,允许在特定条件下使用、...

    jdom.rar内含多个jdom包

    3. **帮助文档**:这可能包括API文档、用户指南或者教程,它们详细解释了JDOM的各种类和方法,以及如何有效地使用这些工具。对于初学者来说,这是一份非常宝贵的资源,可以帮助他们理解JDOM的工作原理和最佳实践。 ...

    jdom教程

    2. **XPath查询**:JDOM 2.0及以上版本支持XPath表达式,可以方便地查找XML文档中的特定元素。 3. **事件驱动的XML处理**:JDOM提供了基于SAX的事件处理器接口,如`ContentHandler`和`EntityResolver`,用于定制XML...

    JAVA操作XML\XML\Jdom使用指南 java教程 -113e博章.mht

    JAVA操作XML\XML\Jdom使用指南 java教程 -113e博章.mht

    jdom的帮助文档 jdom的帮助文档

    在“jdom_v1[1].1.CHM”帮助文档中,你将找到详细的API参考、示例代码和使用指南,这将有助于你更好地理解和掌握JDOM的使用。通过学习JDOM,你可以更有效地处理XML,提高Web应用的开发效率。同时,JDOM也支持XPath和...

    JDOM讲解(java)

    #### 二、JDOM与DOM及其他XML技术的比较 1. **W3C DOM**:这是一种由W3C制定的标准,可以应用于多种编程语言中,包括Java、JavaScript、VB、VBScript、Perl、C/C++等。然而,由于它是跨平台且跨语言的设计,因此在...

    jdom 2.0.0

    1. **API优化**:JDOM 2.0.0对API进行了重构,使其更加符合Java 5及更高版本的编程习惯,如使用泛型和注解,提高了代码的可读性和类型安全性。 2. **性能提升**:在处理大型XML文档时,JDOM 2.0.0通过优化内部数据...

    用jdom解析xml

    **Java与XML:JDOM解析XML的详细指南** 在Java编程中,XML(eXtensible Markup Language)是一种被广泛使用的数据交换格式,用于存储结构化数据。为了处理XML文档,开发者可以使用多种库,其中之一就是JDOM。JDOM是...

    jdom-1.1开源包下载。完整资料。

    4. **README.txt**或类似的文件:包含了关于JDOM-1.1的一些基本信息和安装指南。 5. **LICENSE**:许可证文件,规定了JDOM-1.1的使用权限和条件,由于它是开源软件,通常遵循Apache License 2.0或其他开放源码许可...

    jdom开发Jar包

    6. **文档支持**:JDOM项目提供详细的API文档和用户指南,帮助开发者快速上手并深入理解其工作原理。 **使用JDOM进行XML操作** 1. **解析XML**:通过SAXBuilder或者DOMBuilder,可以将XML字符串或文件解析为JDOM的...

    jdom-2.0.2.zip

    README通常包含安装指南、使用提示和版本变更记录,LICENSE则规定了使用JDOM库的法律条款。 7. **lib**目录:可能包含了JDOM运行所需的其他依赖库,例如SAX和DOM等XML解析器的基础库。 JDOM的核心优势在于它的设计...

    Jdom.rar

    **JDOM的使用步骤** 1. **创建Document对象**:首先,你需要创建一个Document对象,这是XML文档的根节点。你可以使用`DocumentBuilderFactory`和`DocumentBuilder`来实现。 2. **添加元素**:然后,通过`Element`...

    jdom-1.1-all

    2. 文档和API:可能包括用户手册、开发者指南以及详细的API文档,帮助用户了解如何使用JDOM 1.1。 3. 示例代码:可能包含示例程序,展示如何使用JDOM 1.1进行XML操作。 4. 测试类:用于验证库的功能和性能。 学习和...

    jdom-1.1 资源 精简版

    "read me.txt"文件是每个软件或库的必备部分,它通常包含了使用指南、注意事项以及可能的依赖信息。在JDOM 1.1的资源中,read me.txt文件列出了运行JDOM可能需要的其他JAR包。这很重要,因为JDOM可能会依赖于一些...

    Javascript,Actionscript3,css2,DHTML,JDOM,JQuery API开发文档打包下载

    DHTML_Handbook.chm可能包含关于如何使用这些技术创建交互式元素和动画的教程和指南。 5. **JDOM**:Java Document Object Model(JDOM)是Java平台上的一个API,用于读写XML文档。JDOMAPIDOCS.CHM文档提供JDOM的...

    jdom帮助文档

    JDOM项目官网提供完整的API文档、用户指南和示例代码,是学习和解决问题的重要资源。此外,Stack Overflow等技术论坛上也有大量关于JDOM的问题和解答,可以帮助开发者解决实际问题。 总结,JDOM是Java中处理XML的...

    Jdom.chm & Dom4j.chm帮助文档

    《Jdom.chm & Dom4j.chm帮助文档》提供了关于Java中XML处理的重要库——JDOM和DOM4J的详细指南。这两个库是Java开发者处理XML数据时不可或缺的工具,它们都为XML文档对象模型(Document Object Model,简称DOM)提供...

Global site tag (gtag.js) - Google Analytics