JDOM 介绍及使用指南

来源：互联网发布：mac上如何登陆oa系统编辑：程序博客网时间：2024/04/26 00:49

一、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.JDOMorg.JDOM.inputorg.JDOM.outputorg.JDOM.adaptersorg.JDOM.transform三、JDOM 类说明org.JDOM这个包里的类是你解析xml文件后所要用到的所有数据类型。AttributeCDATAComentDocTypeDocumentElementEntityRefNamespaceProscessingInstructionTextorg.JDOM.transform在涉及xslt格式转换时应使用下面的2个类JDOMSourceJDOMResultorg.JDOM.input输入类，一般用于文档的创建工作SAXBuilderDOMBuilderResultSetBuilderorg.JDOM.output输出类，用于文档转换输出XMLOutputterSAXOutputterDomOutputterJTreeOutputter使用前注意事项：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则需要更为复杂的代码，如下：DocumentBuilde***ctory factory =DocumentBuilde***ctory.newInstance();DocumentBuilder builde* =**ctory.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 = "";textXml = textXml + "aaabbbcccddd";textXml = textXml + "";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 outputoutp.output(doc, fileOutputStream);// Compressed outputoutp.setTextTrim(true);outp.output(doc, socket.getOutputStream());// Pretty outputoutp.setIndent(" ");outp.setNewlines(true);outp.output(doc, System.out);......详细请参阅最新的JDOM API手册3.Element 类：(1)浏览Element树//获得根元素elementElement root = doc.getRootElement();// 获得所有子元素的一个listList allChildren = root.getChildren();// 获得指定名称子元素的listList 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); // placeparent1.removeContent(movable); // removeparent2.addContent(movable); // add在Dom里Element movable = doc1.createElement("movable");parent1.appendChild(movable); // placeparent1.removeChild(movable); // removeparent2.appendChild(movable); // 出错!补充：纠错性JDOM的Element构造函数（以及它的其他函数）会检查element是否合法。而它的add/remove方法会检查树结构，检查内容如下：1.在任何树中是否有回环节点2.是否只有一个根节点3.是否有一致的命名空间（Namespaces）(3)Element的text内容读取A cool demo// 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(" content");4.CDATA的数据写入、读出element.addContent(new CDATA(" content"));String noDifference = element.getText();混合内容element可能包含很多种内容，比如说Some textSome child element取table的子元素trString 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类 //获得attributeString width = table.getAttributeValue("width");int border = table.getAttribute("width").getIntValue();//设置attributetable.setAttribute("vspace", "0");// 删除一个或全部attributetable.removeAttribute("vspace");table.getAttributes().clear();5.处理指令(Processing Instructions)操作一个Pls的例子 | | | | 目标数据处理目标名称(Target)String target = pi.getTarget();获得所有数据（data），在目标（target）以后的所有数据都会被返回。String data = pi.getData();获得指定属性的数据String type = pi.getValue("type");获得所有属性的名称List ls = pi.getNames();6.命名空间操作Home PageNamespace 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 = Transforme***ctory.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);}}