1.????????
Abstract
在
Java
的世界裡，要操控
XML
，最簡單的方法莫過於使用
JDOM
。在這裡我簡單的介紹如何用
JDOM
從無到有的建立一分
XML
、當有一份
XML file
時，如何將這個
XML file
讀進程式裡及如何利用
JDOM
將
XML
透過
XSLT
轉成
HTML
。
JDOM
是由
Brett Mclaughlin
和
Jason Hunter
編寫，在
http://www.jdom.org
可免費下載。
?
2.????????
建立、新增、刪除、輸出
範例
1
展示如何建立、新增、刪除及輸出一份
XML
，每份
XML
在
JDOM
裡是由一個
Document
類別代表，所以一開始我們要先
new
一個
Document
，在建構
Document
時應指明根節點，如果沒有指明，在建構應由
setRootElement
設定?；旧?/span>
XML
都可以化成一個樹狀結構，所以，在產生根節點之後，就由根節點開始增加子節點，新增的方式是呼叫
Element.addContent
將新的節點加入。刪除如果知道是某節點以下的子節點，則可呼叫
Element.getChildren
取得所有子節點，再找出要刪除的點節予以刪除。
當建立好
XML
之後，通常我們會希望將它輸出到檔案，
JDOM
提供了
XMLOutputter
類別供我們輸出之用，輸出前要先設定編碼方式，不然，會以
UTF-8
為預設值，
setNewlines
則是指明輸出時是否要幫我們斷行，方便閱讀，如果沒有加這行指令，預設是不會斷行，那麼所有資料將在同一行上。
=====
範例
1 =====
import org.jdom.*;
import org.jdom.output.*;
import java.io.*;
import java.util.List;
?
public class myCreate {
? public myCreate() {
??? String[] strChapter = { "XML
簡論
", "
編寫
XML", "
剖析
XML", "
約制
XML", "
驗正
XML", "
轉換
XML" };
?
??? Element elmtRoot = new Element("Article");
??? Document docJDOM = new Document(elmtRoot);
??? //
新增
??? for(int i=0; i<6; i++) {
????? Element elmtChapter = new Element("Chapter");
????? elmtChapter.addContent(strChapter[i]);
????? elmtChapter.setAttribute("sort", new Integer(i).toString());
????
?elmtRoot.addContent(elmtChapter);
??? }
??? //
刪除
??? List lstChapter = elmtRoot.getChildren("Chapter");
??? lstChapter.remove(4);
??? //
輸出
??? OutputXML(docJDOM, "e:/myJDOM.xml");
? }
?
? private void OutputXML(Document docXML, String strFilename) {
??? XMLOutputter fmt = new XMLOutputter();
??? try {
????? fmt.setEncoding("big5");
????? fmt.setNewlines(true);
????? FileWriter fwXML = new FileWriter(strFilename);
????? fmt.output(docXML, fwXML);
????? fwXML.close();
??? }
??? catch (IOException e) {
????
?e.printStackTrace();
??? }
? }
?
? public static void main(String[] args) {
??? myCreate myCreate1 = new myCreate();
? }
}
?
3.????????
讀進一份
XML file
目前
XML
最常被拿來應用的領域之一大概就是當作設定檔，因此，如何從檔案中讀入一份已存在的
XML
更為重要。
JDOM
是利用
SAX
或
DOM
來剖析
XML
，用
SAX
會比
DOM
，所以一般都是用
SAX
，如果對
SAX
不熟悉，在
http://www.saxproject.org/
相關文件資料。
範例
2
就是用
SAX
建立
Document
，在建立
SAXBuilder
時傳入的參數指出是否用
DTD
驗正
XML
的合法性，
true
表示要，
false
表示不要。當呼叫
build
之後
JDOM
就已經幫我們用
SAX
建立好一棵
XML Tree
，如此我們就可以很方便由
Tree
中找到我們要的節點。
?
=====
範例
2 =====
import org.jdom.*;
import org.jdom.input.*;
import org.jdom.output.*;
import java.io.*;
import java.util.List;
?
public class myRead {
? public myRead() {
??? Document docJDOM;
?
??? //
利用
SAX
建立
Document
??? SAXBuilder bSAX = new SAXBuilder(false);
??? try {
????? docJDOM = bSAX.build(new File("e:/myJDOM.xml"));
??? }
??? catch (JDOMException e) {
????? e.printStackTrace();
????? return;
??? }
??? //
在根節點中加入一個新的子節點
??? Element elmtRoot = docJDOM.getRootElement();
??? Element elmtChapter = new Element("Chapter");
??? elmtChapter.setText("
驗正
XML");
??? elmtChapter.setAttribute("sort", "4");
??? elmtRoot.addContent(elmtChapter);
??? //
印出所有根節點的子節點
??? List lstChildren = elmtRoot.getChildren("Chapter");
??? for(int i=0; i<lstChildren.size(); i++) {
????? Element elmtChild = (Element) lstChildren.get(i);
????? System.out.println("Child " + i);
????? System.out.println("? Text:" + elmtChild.getText());
????? System.out.println("? Attribute:" + elmtChild.getAttributeValue("sort"));
??? }
??? //
輸出到檔案
??? OutputXML(docJDOM, "e:/myJDOM2.xml");
? }
?
? private void OutputXML(Document docXML, String strFilename) {
??? XMLOutputter fmt = new XMLOutputter();
??? try {
????? fmt.setEncoding("big5");
????? fmt.setNewlines(true);
????? FileWriter fwXML = new FileWriter(strFilename);
????? fmt.output(docXML, fwXML);
????? fwXML.close();
??? }
??? catch (IOException e) {
????? e.printStackTrace();
??? }
? }
?
? public static void main(String[] args) {
??? myRead myRead1 = new myRead();
? }
}
?
4.????????
轉換
XML
到
HTML
要將
XML
轉成
HTML
當然要先寫好
XSL
，但是即使寫好
XSL
，
JDOM
也並不提供
XML
轉換，幸好在
JDOM
安裝好之後，就會有
Apache
的
Xalan
，它可以幫我們做這樣的轉換。
要使用
Apache
的
Xalan
，首先確定
xalan.jar
在
classpath
裡。
Xalan
的第一個用法是在命令列執行，指令如下…
C:\> java org.apache.xalan.xslt.Process –IN XML
文件
–XSL XSL
樣版
–OUT
輸出檔名
命令列的用法在一般的運用裡是很方便，但是我們有興趣的是在程式裡怎麼用。範例
4
提供了一個簡單的
sample
。
=====
範例
4 =====
import javax.xml.transform.TransformerFactory;
import javax.xml.transform.Transformer;
import javax.xml.transform.TransformerException;
import javax.xml.transform.TransformerConfigurationException;
import javax.xml.transform.stream.*;
?
public class myGenHTML {
?
? public myGenHTML(String strXML, String strXSL, String strHTML) {
??? try {
????? GenHTML(strXML, strXSL, strHTML);
??? }
??? catch (TransformerConfigurationException e) {
????? e.printStackTrace();
??? }
??? catch (TransformerException e) {
????? e.printStackTrace();
??? }
? }
?
? private void GenHTML(String strXMLFile, String strXSLFile, String strHTMLFile) throws TransformerConfigurationException, TransformerException
? {
??? TransformerFactory myFactory = TransformerFactory.newInstance();
??? Transformer myTransformer = myFactory.newTransformer(new StreamSource(strXSLFile));
??? myTransformer.transform(new StreamSource(strXMLFile), new StreamResult(strHTMLFile));
? }
?
? public static void main(String[] args) {
??? myGenHTML myGenHTML1 = new myGenHTML(args[0], args[1], args[2]);
? }
}