Java中文檔對象模型DOM經驗小結(1 / 3)

Java中文檔對象模型DOM經驗小結

文檔對象模型 (DOM) 是一個文檔標準,對於完備的文檔和複雜的應用程序,DOM 提供了大量靈活性。DOM標準是標準的。它很強壯且完整,並且有許多實現。這是許多大型安裝的決定因素--特別是對產品應用程序,以避免在API發生改變時進行大量的改寫。

以上是我在選擇處理XML數據時之所以沒有選擇JDOM或者dom4j等其它麵向對象的標準的原因,不過也由於DOM從一開始就是一種與語言無關的模型,而且它更趨向用於像C或Perl這類語言,沒有利用Java的麵向對象的性能,所以在使用的過程中也遇到了不少的麻煩,今天這裏做一個小結。另外,我目前使用XML主要是作為數據傳輸的統一格式,並統一用戶界麵展示的接口,應用的麵並不是很廣,所以使用到的DOM的內容其實不多。

在準備使用它的時候,是做了充足的準備的,也有遇到困難的準備,所以一開始就有了一個簡單的工具類來封裝DOM對象使用時必要的公共方法,實際證明這樣做是很明智的,一個簡單的創建Document對象的操作,要是每次都需要寫上5行以上代碼,並且還要處理那些煩人的Exception,實在是會打擊大家的積極性,所以在最初,做了一個XMLTool類,專門封裝了如下的公共方法:

1、 Document對象創建(包括空的Document對象創建,以一個給定Node節點作為根節點創建。

2、 將一個規範的XML字符串轉換成一個Document對象。

3、 從物理硬盤讀取一個XML文件並返回一個Document對象。

4、 將一個Node對象轉換成字符串。

其中每個方法都截獲相關的DOM操作所拋出的異常,轉換成一個RuntimeException拋出,這些異常在實際使用過程中,一般狀況下其實都不會拋出,特別是象生成一個Document對象時的ParserConfigurationException、轉換Node節點成字符串時要生成一個Transformer對象時的TransformerConfigurationException等等,沒有必要在它們身上花時間精力。而且真就出了相關的異常的話,其實根本沒有辦法處理,這樣的狀況通常是係統環境配置有問題(比如必要的DOM實現解析器等包沒有加入環境),所以包裝該異常時隻是很簡要的獲取其Message拋出。

代碼如下:

/**

* 初始化一個空Document對象返回。

* @return a Document

*/

public static Document newXMLDocument() {

try {

return newDocumentBuilder().newDocument();

} catch (ParserConfigurationException e) {

throw new RuntimeException(e.getMessage());

}

}

/**

* 初始化一個DocumentBuilder

* @return a DocumentBuilder

* @throws ParserConfigurationException

*/

public static DocumentBuilder newDocumentBuilder()

throws ParserConfigurationException {

return newDocumentBuilderFactory().newDocumentBuilder();

}

/**

* 初始化一個DocumentBuilderFactory

* @return a DocumentBuilderFactory

*/

public static DocumentBuilderFactory newDocumentBuilderFactory() {

DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance();

dbf.setNamespaceAware(true);

return dbf;

}

/**

* 將傳入的一個XML String轉換成一個org.w3c.dom.Document對象返回。

* @param xmlString 一個符合XML規範的字符串表達。

* @return a Document

*/

public static Document parseXMLDocument(String xmlString) {

if (xmlString == null) {

throw new IllegalArgumentException();

}

try {

return newDocumentBuilder().parse(

new InputSource(new StringReader(xmlString)));

} catch (Exception e) {

throw new RuntimeException(e.getMessage());

}

}

/**

* 給定一個輸入流,解析為一個org.w3c.dom.Document對象返回。

* @param input

* @return a org.w3c.dom.Document

*/

public static Document parseXMLDocument(InputStream input) {

if (input == null) {

throw new IllegalArgumentException("參數為null!");

}

try {

return newDocumentBuilder().parse(input);

} catch (Exception e) {

throw new RuntimeException(e.getMessage());

}

}

/**

* 給定一個文件名,獲取該文件並解析為一個org.w3c.dom.Document對象返回。

* @param fileName 待解析文件的文件名

* @return a org.w3c.dom.Document

*/

public static Document loadXMLDocumentFromFile(String fileName) {

if (fileName == null) {

throw new IllegalArgumentException("未指定文件名及其物理路徑!");

}

try {

return newDocumentBuilder().parse(new File(fileName));

} catch (SAXException e) {

throw new IllegalArgumentException("目標文件(" + fileName + ")不能被正確解析為XML!

" + e.getMessage());

} catch (IOException e) {

throw new IllegalArgumentException("不能獲取目標文件(" + fileName + ")!

" + e.getMessage());

} catch (ParserConfigurationException e) {

throw new RuntimeException(e.getMessage());

}

}

/**

* 給定一個節點,將該節點加入新構造的Document中。

* @param node a Document node

* @return a new Document

*/

public static Document newXMLDocument(Node node) {

Document doc = newXMLDocument();

doc.appendChild(doc.importNode(node, true));

return doc;

}

/**

* 將傳入的一個DOM Node對象輸出成字符串。如果失敗則返回一個空字符串""。

* @param node DOM Node 對象。

* @return a XML String from node