用JDOM處理XML文件 (轉)

用JDOM處理XML文件 (轉)[@more@]

（一）J的介紹以及與JAXB的比較

+ = JDOM ！
這就是JDOM設計者的目標。如果你曾經使用過煩人的SAX或是DOM來處理XML，你就會知道為什麼要有JDOM或者是JAXB。在今年（2002）的JavaOne會議上JDOM的主要創始人Jason Hunter有一篇精彩的演講介紹了JDOM技術，題目就是JDOM Makes XML Easy。
在那篇文件裡，JDOM被拿來與DOM比較，而我更願意拿它同JAXB比較。因為JAXB和JDOM都是為了在Java中提供比DOM和SAX更為方便的XML處理介面而開發的，並且透過完全不同的途徑來解決這個問題。JDOM的處理方式是與DOM類似的樹操作。而JAXB透過DTD和繫結來生成訪問XML文件的Java程式碼，將XML對映成了Java來操作。你可以根據專案的需要和個人喜好來決定採用哪一個。
JDOM與JAXB的比較，從本身的特點來看：
1) JDOM比JAXB更容易上手。使用JAXB首先要會編寫DTD，然後還要會編寫繫結模式。JDOM沒有這樣的要求，如果你會Java和XML，甚至可以說光是看JDOM的javadoc文件就能夠使用JDOM。
2) JAXB編寫好DTD和繫結模式以後，XML文件被對映成了Java物件，其資料就是Java物件的屬性，連資料型別都做好了轉換，因此，訪問XML文件比JDOM要簡便，可以說是一勞永逸。
3) JAXB由某個DTD和繫結模式生成的程式碼只能訪問該DTD所的文件。如果想要訪問其他XML文件，需要再編寫DTD和繫結模式。JDOM可以處理任何XML文件，包括受約束的和不受約束的。

目前JDOM和JAXB都沒有正式版本。JDOM的最新版本是beta8，JAXB是1.0 early access，其規範版本是0.21。相對而言，JDOM更成熟一些。例如JAXB不支援名字空間、不能向XML文件寫入處理指令，有時我們需要保留的換行符和首尾空格在JAXB中自動過濾掉了，就連放在裡面也不能倖免。JDOM就沒有這些限制。如果說以上的3點比較是JDOM和JAXB本身的特點所決定的，幾乎不可能改變，那麼這裡表明，JAXB還需要更多的工作。

（二）獲得並JDOM
在可以JDOM的最新版本。以JDOM beta8的2進製版本為例。下載後解，JDOM的jar就是build目錄下的檔案jdom.jar，將之加入類路徑。另外JDOM還需要lib目錄下那些jar檔案如xerces.jar的支援。如果在使用中出現以下錯誤：
java.lang.NoSuchMethodError
或
java.lang.NoClassDefFoundError: org/xml/sax/SAXNotRecognizedException
你需要保證xerces.jar檔案在CLASSPATH中位於其他XML類，如JAXP或Crimson之前，這些類檔案，包括以前老版本的xerces，可能不支援SAX2.0或DOM Level 2。於是導致了上面的錯誤。

（三）一個簡單的例子
JDOM的處理方式有些類似於DOM，但它主要是用SAX實現的，你不必擔心處理速度和的問題。另外，JDOM中幾乎沒有介面，的類全部是實實在在的類，沒有類工廠類的。其最重要的一個包org.jdom中主要有以下類：
? Attribute
? CDATA
? Comment
? DocType
? Document
? Element
? EntityRef
? Namespace
? ProcessingInstruction
? Text
資料輸入要用到XML文件要透過org.jdom.input包，反過來需要org.jdom.output。如前面所說，關是看文件就能夠使用。
我們的例子讀入XML檔案exampleA.xml，加入一條處理指令，修改第一本書的價格和作者，並新增一條屬性，然後寫入檔案exampleB.xml：
//exampleA.xml


   
       Java
       張三
       2002-6-6
       35.0
   
   
       XML在Java中的應用
       李四
       2002-9-16
       92.0
   

//testJDOM.java
import org.jdom.*;
import org.jdom.output.*;
import org.jdom.input.*;
import java.io.*;
public class TestJDOM{
   public static void main(String args[])throws Exception{
       
       SAXBuilder sb = new SAXBuilder();

       //從檔案構造一個Document，因為XML檔案中已經指定了編碼，所以這裡不必了
       Document doc = sb.build(new FileInputStream("exampleA.xml"));
       
       //加入一條處理指令
       ProcessingInstruction pi = new ProcessingInstruction
           ("xml-stylesheet","href="bookList.html." type="text/xsl"");
       doc.addContent(pi);

       Element = doc.getRootElement(); //得到根元素
       java.util.List books = root.getChildren(); //得到根元素所有子元素的集合
       Element book = (Element)books.get(0); //得到第一個book元素
       //為第一本書新增一條屬性
       Attribute a = new Attribute("hot","true");  
       book.setAttribute(a);
       Element author = book.getChild("author"); //得到指定的字元素
       author.setText("王五"); //將作者改為王五
       //或 Text t = new Text("王五");book.addContent(t);
       Element price = book.getChild("price"); //得到指定的字元素
       //修改價格，比較鬱悶的是我們必須自己轉換資料型別，而這正是JAXB的優勢
       author.setText(Float.toString(50.0f));
       

       String indent = "    ";
       boolean newLines = true;
       XMLOutputter outp = new XMLOutputter(indent,newLines,"GBK");
       outp.output(doc, new FileOutputStream("exampleB.xml"));

   }
};

結果exampleB.xml：


   
       Java程式設計入門
       50.0
       2002-6-6
       35.0
   
   
       XML在Java中的應用
       李四
       2002-9-16
       92.0
   

在預設情況下，JDOM的Element類的getText()這類的方法不會過濾空白字元，如果你需要過濾，用setTextTrim() 。

（四）參考文件
1) JDOM Makes XML Easy ()
2) The Java ™ Architecture for XML Binding User’s Gu ()
3) Services Made Easier. The Java TM APIs and Architectures for XML, A Technical White Paper ( )