本文主要說明如何用 SAX 解析 XML 文檔。相較於把整份文檔載入記憶體的 DOM 方式,SAX 以事件驅動、逐段讀取,特別適合處理大型資料流。
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Books>
<Book id="8542f26f-80d4-4b7d-ab25-f80f72a852ef">
<name id="201">
<strings>
<entry>
<key>en_US</key>
<value>thinking in Java</value>
</entry>
</strings>
</name>
<Author>
<entry>
<key>en_US</key>
<value>Tom</value>
</entry>
</Author>
<icon>
<url>think_Java.PNG</url>
</icon>
</Book>
...
</Books>
應用程式想從這份 XML 中讀出各個 book,並提供查詢功能——給定書的 id,就能找到作者與書名。當然,用 JDOM 是很簡單的方式;但如果你讀到的是一個較大的串流,那麼最好改用 SAXParser,因為它不需要把整份 XML 文檔裝入記憶體。
首先我們建立一個 Book 類別,用來保存 book 的相關資訊:
public class Book {
private String id = null;
private String name = null;
private String author = null;
private Image image = null;
// 一系列 get 和 set 方法(略去)
public String toString() {
return "Book [" + "ID=" + id + ", Name=" + name + ", Author=" + author + "]";
}
}
接著我們新增一個 BooksSAXHandler 類別,它擴充了 DefaultHandler,用於解析 XML。SAX 解析以事件為基礎,這裡我們處理三個事件:startElement、endElement 與 characters。
為了取得某個 element 內部的文字值,程式需要知道目前處理的是哪個節點;但僅知道節點名稱還不夠,因為可能有同名節點,因此我們引入 currentPath,如此便能唯一地定位到要處理的節點。以下是解析方法,請特別留意 currentPath 的用法:
public void startElement(String uri, String localName, String qName, Attributes attributes)
throws SAXException {
currentPath.append(qName + "/");
if (qName.equals(ELEMENT_BOOK)) {
book = new Book();
if (attributes.getQName(0).equals(ELEMENT_ID)) {
book.setID(attributes.getValue(ELEMENT_ID));
}
}
}
public void endElement(String uri, String localName, String qName)
throws SAXException {
currentPath.delete(currentPath.lastIndexOf(qName), currentPath.length());
if (qName.equals(ELEMENT_BOOK)) {
booksMap.put(book.getID(), book);
book = null;
}
}
public void characters(char[] ch, int start, int length)
throws SAXException {
if (currentPath.toString().equals(NAME_PATH)) {
book.setName(new String(ch, start, length));
} else if (currentPath.toString().equals(AUTHOR_PATH)) {
book.setAuthor(new String(ch, start, length));
}
}
接著,我們用 javax.xml.parsers.SAXParser 來解析這份 XML 文檔。SAXParser 需要兩個參數:一個是要解析的串流,另一個則是 DefaultHandler 物件。至此,我們已經理清了解析整份 XML 的完整過程。
使用者介面以 JFace 的 TableViewer 實作。定義好 TableViewer 後,關鍵是設定以下三個方法:
tableViewer.setContentProvider(new BooksContentProvider());
tableViewer.setLabelProvider(new BooksLabelProvider());
tableViewer.setInput(getBooks());
其中 getBooks() 負責提供資料,回傳所有資料的列表(本例回傳 List<Book>)。BooksLabelProvider 需實作 ITableLabelProvider,主要回傳 table 各欄的值,其中兩個關鍵方法是 getColumnText(回傳對應欄的文字值,如 Book 的 ID、Name、Author)與 getColumnImage(回傳對應欄的圖片,這裡即 Book 的 Image)。
最終的運行結果如下:
透過 SAXParser 的事件驅動解析,我們得以在不必將整份文檔載入記憶體的前提下,穩定而高效地從大型 XML 串流中擷取所需的資料,再藉由 TableViewer 清晰地呈現出來。