java xml JDOM

java xml JDOM

概述

JDOM是一种使用XML的独特Java工具包，用于快速开发XML应用程序。

它的设计包含Java语言的语法乃至语义。

JDOM是一个开源项目，它基于树形结构，利用纯Java的技术对XML文档实现解析、生成、序列化及多种操作

JDOM和DOM及SAX的关系

JDOM主要用来弥补DOM和SAX在实际应用当中的不足。

主要是SAX没有文档修改、随机访问及输出的功能；

而DOM，Java程序员在使用时总觉得不太方便（比如DOM定义了自己的Text类而不是使用Java的String）。

DOM的缺点主要是由于DOM是一个接口定义语言（IDL），它的任务是在不同语言实现中的一个最低的通用标准，并不是为Java特别设计的。

DOM API沿袭了XML规范，在XML中，每件东西都是一个结点，因此在DOM中找到的几乎每件东西都基于Node接口。

就多态性来讲，它是优秀的，但鉴于如上解释，它在Java语言中的应用是困难而且不便的，其中从Node向叶类型作显式向下类型转换会导致代码的冗长和难以理解。

JDOM和DOM在性能测试时表现不佳，在测试10M文档时内存溢出。在小文档情况下还值得考虑使用DOM和JDOM。虽然JDOM的开发者已经说明他们期望在正式发行版前专注性能问题，但是从性能观点来看，它确实没有值得推荐之处。另外，DOM仍是一个非常好的选择。DOM实现广泛应用于多种编程语言。它还是许多其它与XML相关的标准的基础，因为它正式获得W3C推荐（与基于非标准的Java模型相对），所以在某些类型的项目中可能也需要它（如在JavaScript中使用DOM）
SAX表现较好，这要依赖于它特定的解析方式－事件驱动。一个SAX检测即将到来的XML流，但并没有载入到内存（当然当XML流被读入时，会有部分文档暂时隐藏在内存中）

JDOM是作为一种轻量级的API被制定的，最主要的是它是以Java为中心的。它在遵循DOM主要规则的基础上除去了上述缺点。

JDOM是Java平台专用的，只要有可能，API都使用Java语言的内建String支持。

在JDOM中，XML元素就是Element的实例，XML属性就是Attribute的实例，XML文档本身就是Document的实例。

类驱动：因为JDOM对象就是像Document、Element和Attribute这些类的直接实例，因此创建一个新的JDOM对象就如在Java语言中使用new操作符一样容易。

它还意味着不需要进行工厂化接口配置——JDOM的使用是直截了当的

使用前需要下载JDOM的jar包

<!-- https://mvnrepository.com/artifact/org.jdom/jdom2 -->
        <dependency>
            <groupId>org.jdom</groupId>
            <artifactId>jdom2</artifactId>
            <version>2.0.6</version>
        </dependency>

常用类

Document：表示整个xml文档，是一个树形结构

Eelment：表示一个xml的元素，提供方法操作其子元素，如文本，属性和名称空间等

Attribute：表示元素包含的属性

Text：表示xml文本信息

XMLOutputter：xml输出流，底层是通过JDK中流实现

Format：提供xml文件输出的编码、样式和排版等设置

实例

// 文档
        Document document = new Document();
        // 生成一个元素
        Element root = new Element("root");
        // 将生成的元素加入文档：根元素
        document.addContent(root);
        // 给结点加上注释
        Comment comment = new Comment("This is my comments");
        root.addContent(comment);
        // 加上子元素1
        Element e = new Element("hello");
        // 加属性
        e.setAttribute("sohu", "www.sohu.com");
        root.addContent(e);
        // 加子元素2
        Element e2 = new Element("world");
        Attribute attribute = new Attribute("testAttr", "attr Value");
        e2.setAttribute(attribute);// set方法会返回元素本身（方法链method chain style）
        root.addContent(e2);
        e2.addContent(new Element("subElement").setAttribute("a", "aValue")
                .setAttribute("x", "xValue").setAttribute("y", "yValue")
                .setText("textContent"));
        // 格式化
        Format format = Format.getPrettyFormat();
        // Format.getRawFormat()方法，通常用于XML数据的网络传输，因为这种格式会去掉所有不必要的空白，因此能够减少数据量
        // 可以自己设定一些format的属性
        format.setIndent("    ");// 把缩进设为四个空格（默认为两个空格）
        // 输出
        XMLOutputter out = new XMLOutputter(format);
        out.output(document, new FileOutputStream("jdom.xml"));// 可在当前项目路径下找到

 // 构造器
        SAXBuilder saxBuilder = new SAXBuilder();
        // 获取文档
        Document document = saxBuilder.build(new File("jdom.xml"));
        // 得到根元素
        Element element = document.getRootElement();
        System.out.println("Root: " + element.getName());
        // 获取子元素
        Element hello = element.getChild("hello");
        System.out.println("child: " + hello.getName());
        // 获取属性
        List<Attribute> list = hello.getAttributes();
        for (int i = 0; i < list.size(); ++i)
        {
            Attribute attr = (Attribute) list.get(i);
            String attrName = attr.getName();
            String attrValue = attr.getValue();
            System.out.println("hello的属性： " + attrName + " = " + attrValue);
        }
        // 移除一个元素
        element.removeChild("world");
        // 设定格式
        XMLOutputter out = new XMLOutputter(Format.getPrettyFormat().setIndent("    "));
        out.output(document, new FileWriter("jdom2.xml"));
        // FileWriter和FileOutputStream都能用