無線&移動互聯網技術研發

    在 JDOM 中，XML 元素就是 Element 的實例，XML 屬性就是 Attribute 的實例，XML 文檔本身就是 Document 的實例。
    因為 JDOM 對象就是像 Document、Element 和 Attribute 這些類的直接實例，因此創建一個新 JDOM 對象就如在 Java 語言中使用 new 操作符一樣容易。JDOM 的使用是直截了當的。
    JDOM 使用標準的 Java 編碼模式。只要有可能，它使用 Java new 操作符而不故弄玄虛使用復雜的工廠化模式，使對象操作即便對于初學用戶也很方便。
   
    本文分兩步對JDOM的應用加以介紹：XML創建 和 XML解析
一、XML文檔創建
    我們由零開始利用JDOM生成一個XML文檔。最后的結果(樣本文檔)看起來象這樣：

<?xml version="1.0" encoding="UTF-8"?>
<MyInfo comment="introduce myself">
  <sex value="male" />
  <name>Gavin</name>
  <high>1.78</high>
  <contact>
    <telephone>13088817413</telephone>
   <!-- <email value="doingjava@126.com" />-->
  </contact>
</MyInfo>

    1.以 MyInfo 為根元素創建文檔
        Element rootElement = new Element("MyInfo");//所有的XML元素都是 Element 的實例。根元素也不例外：）
        Document myDocument = new Document(rootElement);//以根元素作為參數創建Document對象。一個Document只有一個根，即root元素。
    2.給根元素添加屬性
        Attribute rootAttri = new Attribute("comment","introduce myself");//創建名為 commnet,值為 introduce myself 的屬性。
        rootElement.setAttribute(rootAttri);//將剛創建的屬性添加到根元素。
        這兩行代碼你也可以合成一行來寫，象這樣：
        rootElement.setAttribute(new Attribute("comment","introduce myself"));
        或者
        rootElement.setAttribute("comment","introduce myself");
    3.添加元素和子元素
        JDOM里子元素是作為 content（內容）添加到父元素里面去的,所謂content就是類似上面樣本文檔中<name></name>之間的東東，即kingwong。羅嗦了點是吧：）
        Element nameElement = new Element("name");//創建 name 元素
        nameElement.addContent("kingwong");//將kingwong作為content添加到name元素
 rootElement.addContent(nameElement);//將name元素作為content添加到根元素
 
 這三行你也可以合為一句，象這樣：
 rootElement.addContent((Content)(new Element("name").addContent("kingwong")));//因為addContent(Content child)方法返回的是一個Parent接口，而Element類同時繼承了Content類和實現了Parent接口，所以我們把它造型成Content。
 
        我們用同樣的方法添加帶屬性的子元素<sex value="male"/>
        rootElement.addContent(new Element("sex").setAttribute("value","male"));//注意這里不需要轉型，因為addAttribute(String name,String value)返回值就是一個 Element。
       
        同樣的，我們添加<contract />元素到根元素下，用法上一樣，只是稍微復雜了一些：
        rootElement.addContent((Content)(new Element("contact").addContent((Content)(new Element("telephone").addContent("87654321")))));
        如果你對這種簡寫形式還不太習慣，你完全可以分步來做，就象本節剛開始的時候一樣。事實上如果層次比較多，寫成分步的形式更清晰些，也不容易出錯。
    4.刪除子元素
        這個操作比較簡單：
        rootElement.removeChild("sex");//該方法返回一個布爾值
       
        到目前為止，我們學習了一下JDOM文檔生成操作。上面建立了一個樣本文檔，可是我們怎么知道對不對呢？因此需要輸出來看一下。我們將JDOM生成的文檔輸出到控制臺，使用 JDOM 的 XMLOutputter 類。
    5.  將 JDOM 轉化為 XML 文本        

XMLOutputter xmlOut = new XMLOutputter("  ",true);
    try {
        xmlOut.output(myDocument,System.out);
    } catch (IOException e) {
        e.printStackTrace();
    }

         XMLOutputter 有幾個格式選項。這里我們已指定希望子元素從父元素縮進兩個空格，并且希望元素間有空行。
 new XMLOutputter(java.lang.String indent, boolean newlines)這個方法在最新版本中已經不建議使用。JDOM有一個專門的用來定義格式化輸出的類：org.jdom.output.Format，如果你沒有特殊的要求，有時候使用里面的幾個靜態方法（應該可以說是預定義格式）如 getPrettyFormat()就可以了。我們把上面的輸出格式稍微改一下，就象這樣：
 XMLOutputter xmlOut = new XMLOutputter(Format.getPrettyFormat()); 
    6.將JDOM文檔轉化為其他形式
        XMLOutputter 還可輸出到 Writer 或 OutputStream。為了輸出JDOM文檔到一個文本文件，我們可以這樣做：
        FileWriter writer = new FileWriter("/some/directory/myFile.xml");
        outputter.output(myDocument, writer);
        writer.close();
       
        XMLOutputter 還可輸出到字符串,以便程序后面進行再處理:
        Strng outString = xmlOut.outputString(myDocument);
       
        當然，在輸出的時候你不一定要輸出所有的整個文檔，你可以選擇元素進行輸出：
        xmlOut.output(rootElement.getChild("name"),System.out);
        一句話，JDOM非常靈活方便！如果你想進一步研究JDOM，請到官方網站去看一看：http://www.jdom.org

    本節示例源碼：

package com.Gavin.xml;
import java.io.FileOutputStream;
import java.io.FileWriter;
import java.io.IOException;
import java.io.OutputStream;
import org.jdom.Attribute;
import org.jdom.Comment;
import org.jdom.Content;
import org.jdom.Document;
import org.jdom.Element;
import org.jdom.output.Format;
import org.jdom.output.XMLOutputter;

public class TestJdom {
    public static void main(String[] args) {
        
        Element rootElement = new Element("MyInfo");
        
        Document document = new Document(rootElement);

        Comment comment = new Comment("this is first comment");        //添加注釋
        rootElement.addContent(comment);
        
        rootElement.setAttribute("comment", "introduce myself");
//        rootElement.setAttribute(new Attribute("comment", "introduce myself"));
        
        Element sexElement = new Element("sex");
        sexElement.setAttribute("value", "male");
        rootElement.addContent(sexElement);
//        rootElement.addContent(new Element("sex").setAttribute("value", "male"));

        Element nameElement = new Element("name");
        nameElement.addContent("Gavin");
        rootElement.addContent(nameElement);
//        rootElement.addContent((Content) (new Element("name").addContent("kingwong")));
        
        Element highElement = new Element("high");
        highElement.addContent("1.78");
        rootElement.addContent(highElement);
//        rootElement.addContent((Content) (new Element("high").addContent("1.78")));
        
        Element contractElement = new Element("contact");
            Element telElement = new Element("telephone");
            telElement.addContent("13088817413");
            contractElement.addContent(telElement);
        rootElement.addContent(contractElement);        
//        rootElement.addContent((Content) (new Element("contact").addContent((Content) (new Element("telephone").addContent("87654321")))));

//        boolean bool = rootElement.removeChild("sex");        //移除sex節點

        XMLOutputter xmlOut = new XMLOutputter(Format.getPrettyFormat().setEncoding("GBK"));    //可指定xml encoding
        OutputStream out = null;
        try {
            out = new FileOutputStream("c:/jdom_test.xml");
            
//            xmlOut.output(myDocument, System.out);    //從控制臺輸出
            
            xmlOut.output(document, out);    //寫到文件
            
            xmlOut.output(rootElement.getChild("name"),System.out);        //輸出name節點<name>Gavin</name>
            
            String outString = xmlOut.outputString(document);        //將文檔轉化成String
            
            System.out.println(outString);
        } catch (IOException e) {
            e.printStackTrace();
        }
        
        
    }
}

       
二、XML文檔解析
    JDOM 不光可以很方便的建立XML文檔，它的另一個用處是它能夠讀取并操作現有的 XML 數據。
    JDOM的解析器在org.jdom.input.*這個包里，其中的DOMBuilder的功能是將DOM模型的Document解析成JDOM模型的Document；SAXBuilder的功能是從文件或流中解析出符合JDOM模型的XML樹。由于我們經常要從一個文件里讀取數據，因此我們應該采用后者作為解析工具。
解析一個xml文檔，基本可以看成以下幾個步驟：
    1.實例化一個合適的解析器對象
        本例中我們使用SAXBuilder:
        SAXBuilder sb = new SAXBuilder();
    2.以包含XML數據的文件為參數，構建一個文檔對象myDocument
        Document myDocument = sb.build(/some/directory/myFile.xml);
    3.獲到根元素
        Element rootElement = myDocument.getRootElement();
       
        一旦你獲取了根元素，你就可以很方便地對它下面的子元素進行操作了，下面對Element對象的一些常用方法作一下簡單說明：
        getChild("childname") 返回指定名字的子節點,如果同一級有多個同名子節點，則只返回第一個；如果沒有返回null值。
        getChildren("childname") 返回指定名字的子節點List集合。這樣你就可以遍歷所有的同一級同名子節點。
        getAttributeValue("name") 返回指定屬性名字的值。如果沒有該屬性則返回null,有該屬性但是值為空，則返回空字符串。
        getChildText("childname") 返回指定子節點的內容文本值。
        getText() 返回該元素的內容文本值。
       
        還有其他沒有羅列出來的方法，如果需要的話，可以隨時查閱JDOM的在線文檔：http://www.jdom.org/docs/apidocs/index.html。當然你可以在你需要的地方添加、刪除元素操作，還記得上面的創建XML的方法嗎？呵呵~~~
       
        學習新東東還是從實例學起最為快捷，下面簡單舉個例子，就以上面的XML樣本代碼來學習JDOM的XML解析。本例中讀取了樣本XML文件里一些屬性和content，最后我們還在contact元素里插入了一個新元素<email value="wanghua@cyberobject.com" />。盡管我們實現了對于XML的基本操作，細心的朋友可能會
有疑問：如果XML文檔的層次稍微復雜一些，如果嵌套多達幾十上百層的話（開個玩笑），如果靠這樣從根元素一級一級地通過getChild("childname")來訪問子元素的話，將會非常痛苦！是的，的確是這樣，但是我們有另一個有力的工具XPath，為什么不用呢？這是后話！先賣個關子（手敲累啦，下回吧，呵呵）。

package com.Gavin.xml;

import java.io.FileOutputStream;
import java.io.OutputStream;
import java.util.Iterator;

import org.jdom.Document;
import org.jdom.Element;
import org.jdom.input.SAXBuilder;
import org.jdom.output.Format;
import org.jdom.output.XMLOutputter;

public class JdomParse {
    public static void main(String[] args) {
        SAXBuilder sb = new SAXBuilder();
        try {
            Document document = sb.build("c:/jdom_test.xml");
            Element root = document.getRootElement();
            
            System.out.println("***********:" + root.getName());
            System.out.println("***********:" + root.getChildren().size());
                        
            System.out.println("***********:" + root.getChildren().get(0));
            
            String str1 = root.getAttributeValue("comment");
            System.out.println("Root Element's comment attribute is : " + str1);
            
            String str2 = root.getChild("sex").getAttributeValue("value");
            System.out.println("sex Element's value attribute is : " + str2);
            
            String str3 = root.getChildText("name");
            System.out.println("name Element's content is :" + str3);
            
            Element contractElement = root.getChild("contact");
            String str4 = contractElement.getChildText("telephone");
            
            System.out.println("contact Element's telephone subelement content is : " + str4 + "\n");
                    
            contractElement.addContent(new Element("email").setAttribute("value", "doingjava@126.com"));

            XMLOutputter xmlOut = new XMLOutputter(Format.getPrettyFormat());
            OutputStream out = new FileOutputStream("c:/jdom_test.xml");
            xmlOut.output(document, out);
            String outStr = xmlOut.outputString(root);
            System.out.println(outStr);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}