XML 作為全球通用的結構化語言,愈來愈受開發者青睞,各大開發平台(如 Microsoft Studio 系列、Oracle 系列、Borland 系列等)也都把支援 XML 開發當作號召力之一。在許多專案中,用 XML 交換資料省下了不少麻煩——不必制定繁瑣的資料格式,加上 XML 資料易於表達,也方便一線開發者追蹤與除錯。
在 XML 應用中,最常用也最實用的莫過於 XML 檔案的讀寫,因此筆者透過一個簡單的 XML 讀寫範例來做說明。你可以在任何文字編輯器中建立如下結構的 XML 檔案,它類似 HTML 結構,但語意較為嚴格:起始標記必須成對,例如「<學生花名冊>」與「</學生花名冊>」要對應;空格多少不必計較,但一般以縮排書寫以便閱讀。將它命名為 Input.xml,並用支援 XML 的瀏覽器打開測試,若輸入正確,就能看到這份檔案的樹狀結構。如果你對 XML 結構還比較陌生,建議先補充一下 XML 檔案的基礎知識。
<?XML version="1.0" encoding="GB2312"?>
<學生花名冊>
<學生 性別 = "男">
<姓名>李華</姓名>
<年齡>14</年齡>
<電話>6287555</電話>
</學生>
<學生 性別 = "男">
<姓名>張三</姓名>
<年齡>16</年齡>
<電話>8273425</電話>
</學生>
</學生花名冊>
準備工作完成後,接著開始寫真正的 Java 程式碼。為了保存從 XML 讀入的資訊,先建一個簡單的 Bean 來存放學生資料,命名為 StudentBean:
public class StudentBean {
private String sex; // 學生性別
private String name; // 學生姓名
private int age; // 學生年齡
private String phone; // 電話號碼
public void setSex(String s) { sex = s; }
public void setName(String s) { name = s; }
public void setAge(int a) { age = a; }
public void setPhone(String s){ phone = s; }
public String getSex() { return sex; }
public String getName() { return name; }
public int getAge() { return age; }
public String getPhone() { return phone; }
}
接著撰寫 XML 測試類別,筆者將其命名為 XMLTest。為了讀寫 XML 檔案,需要導入下列 Java 套件(「//」後為註解說明)。筆者的環境是 JDK 1.3.1_04,在 JDK 1.4.0 中也測試通過,XML 解析器採用 Apache 的 Crimson,可到 Apache 官網下載。
import java.io.*; // Java 基礎套件,含各種 IO 操作 import java.util.*; // Java 基礎套件,含各種標準資料結構操作 import javax.xml.parsers.*; // XML 解析器介面 import org.w3c.dom.*; // XML 的 DOM 實作 import org.apache.crimson.tree.XMLDocument; // 寫 XML 檔案時會用到
為了保存多位學生的資料,還得借助一個集合類別(這裡採用 Vector 向量類別),定義在 XMLTest 測試類別中,命名為 student_Vector。然後定義 readXMLFile 與 writeXMLFile 兩個方法來完成讀寫操作:
private void readXMLFile(String inFile) throws Exception {
// 為解析 XML 做準備:建立 DocumentBuilderFactory 實例與 DocumentBuilder
DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance();
DocumentBuilder db = null;
try {
db = dbf.newDocumentBuilder();
} catch (ParserConfigurationException pce) {
System.err.println(pce);
System.exit(1);
}
Document doc = null;
try {
doc = db.parse(inFile);
} catch (DOMException dom) {
System.err.println(dom.getMessage());
System.exit(1);
} catch (IOException ioe) {
System.err.println(ioe);
System.exit(1);
}
// 解析 XML:先取根元素"學生花名冊"
Element root = doc.getDocumentElement();
// 取"學生"元素列表
NodeList students = root.getElementsByTagName("學生");
for (int i = 0; i < students.getLength(); i++) {
Element student = (Element) students.item(i);
StudentBean studentBean = new StudentBean();
studentBean.setSex(student.getAttribute("性別"));
NodeList names = student.getElementsByTagName("姓名");
if (names.getLength() == 1) {
Element e = (Element) names.item(0);
Text t = (Text) e.getFirstChild();
studentBean.setName(t.getNodeValue());
}
NodeList ages = student.getElementsByTagName("年齡");
if (ages.getLength() == 1) {
Element e = (Element) ages.item(0);
Text t = (Text) e.getFirstChild();
studentBean.setAge(Integer.parseInt(t.getNodeValue()));
}
NodeList phones = student.getElementsByTagName("電話");
if (phones.getLength() == 1) {
Element e = (Element) phones.item(0);
Text t = (Text) e.getFirstChild();
studentBean.setPhone(t.getNodeValue());
}
student_Vector.add(studentBean);
}
}
private void writeXMLFile(String outFile) throws Exception {
DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance();
DocumentBuilder db = null;
try {
db = dbf.newDocumentBuilder();
} catch (ParserConfigurationException pce) {
System.err.println(pce);
System.exit(1);
}
Document doc = db.newDocument();
// 建立 XML 文件內容:先建根元素"學生花名冊"
Element root = doc.createElement("學生花名冊");
doc.appendChild(root);
for (int i = 0; i < student_Vector.size(); i++) {
StudentBean studentBean = (StudentBean) student_Vector.get(i);
Element student = doc.createElement("學生");
student.setAttribute("性別", studentBean.getSex());
root.appendChild(student);
Element name = doc.createElement("姓名");
student.appendChild(name);
Text tName = doc.createTextNode(studentBean.getName());
name.appendChild(tName);
Element age = doc.createElement("年齡");
student.appendChild(age);
Text tAge = doc.createTextNode(String.valueOf(studentBean.getAge()));
age.appendChild(tAge);
Element phone = doc.createElement("電話");
student.appendChild(phone);
Text tPhone = doc.createTextNode(studentBean.getPhone());
phone.appendChild(tPhone);
}
// 把 XML 文件輸出到指定檔案
FileOutputStream outStream = new FileOutputStream(outFile);
OutputStreamWriter outWriter = new OutputStreamWriter(outStream);
((XMLDocument) doc).write(outWriter, "GB2312");
outWriter.close();
outStream.close();
}
最後加入測試主函式:
public static void main(String[] args) throws Exception {
XMLTest xmlTest = new XMLTest(); // 建立測試實例
xmlTest.student_Vector = new Vector(); // 初始化向量列表
System.out.println("開始讀 Input.XML 文件");
xmlTest.readXMLFile("Input.xml");
System.out.println("讀入完畢,開始寫 Output.XML 文件");
xmlTest.writeXMLFile("Output.XML");
System.out.println("寫入完成");
}
好了,把 StudentBean 與 XMLTest 存好,並將 Input.xml 放到工作目錄下,執行後你便會看到「寫入完成」的訊息。