1. 程式人生 > >在JAVA中使用文件物件模型DOM經驗小結

在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!/n" + e.getMessage());
  } catch (IOException e) {
   throw new IllegalArgumentException(
    "不能獲取目標檔案(" + fileName + ")!/n" + 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
  */
 public static String toString(Node node) {
  if (node == null) {
   throw new IllegalArgumentException();
  }
  Transformer transformer = newTransformer();
  if (transformer != null) {
   try {
    StringWriter sw = new StringWriter();
    transformer.transform(
     new DOMSource(node),
     new StreamResult(sw));
    return sw.toString();
   } catch (TransformerException te) {
    throw new RuntimeException(te.getMessage());

   }
  }
  return errXMLString("不能生成XML資訊!");
 }
 /**
  * 將傳入的一個DOM Node物件輸出成字串。如果失敗則返回一個空字串""。
  * @param node DOM Node 物件。
  * @return a XML String from node
  */
 public static String toString(Node node) {
  if (node == null) {
   throw new IllegalArgumentException();
  }
  Transformer transformer = newTransformer();
  if (transformer != null) {
   try {
    StringWriter sw = new StringWriter();
    transformer.transform(
     new DOMSource(node),
     new StreamResult(sw));
    return sw.toString();
   } catch (TransformerException te) {
    throw new RuntimeException(te.getMessage());

   }
  }
  return errXMLString("不能生成XML資訊!");
 }
 /**
  * 獲取一個Transformer物件,由於使用時都做相同的初始化,所以提取出來作為公共方法。
  * @return a Transformer encoding gb2312
  */
 public static Transformer newTransformer() {
  try {
   Transformer transformer =
    TransformerFactory.newInstance().newTransformer();
   Properties properties = transformer.getOutputProperties();
   properties.setProperty(OutputKeys.ENCODING, "gb2312");
   properties.setProperty(OutputKeys.METHOD, "xml");
   properties.setProperty(OutputKeys.VERSION, "1.0");
   properties.setProperty(OutputKeys.INDENT, "no");
   transformer.setOutputProperties(properties);
   return transformer;
  } catch (TransformerConfigurationException tce) {
   throw new RuntimeException(tce.getMessage());
  }
 }
 /**
  * 返回一段XML表述的錯誤資訊。提示資訊的TITLE為:系統錯誤。之所以使用字串拼裝,主要是這樣做一般
  * 不會有異常出現。
  * @param errMsg 提示錯誤資訊
  * @return a XML String show err msg
  */
 public static String errXMLString(String errMsg) {
  StringBuffer msg = new StringBuffer(100);
  msg.append("<?xml version=/"1.0/" encoding=/"gb2312/" ?>");
  msg.append("<errNode title=/"系統錯誤/" errMsg=/"" + errMsg + "/"/>");
  return msg.toString();
 }
 /**
  * 返回一段XML表述的錯誤資訊。提示資訊的TITLE為:系統錯誤
  * @param errMsg 提示錯誤資訊
  * @param errClass 丟擲該錯誤的類,用於提取錯誤來源資訊。
  * @return a XML String show err msg
  */
 public static String errXMLString(String errMsg, Class errClass) {
  StringBuffer msg = new StringBuffer(100);
  msg.append("<?xml version=/"1.0/" encoding=/"gb2312/" ?>");
  msg.append(
   "<errNode title=/"系統錯誤/" errMsg=/""
    + errMsg
    + "/" errSource=/""
    + errClass.getName()
    + "/"/>");
  return msg.toString();
 }
 /**
  * 返回一段XML表述的錯誤資訊。
  * @param title 提示的title
  * @param errMsg 提示錯誤資訊
  * @param errClass 丟擲該錯誤的類,用於提取錯誤來源資訊。
  * @return a XML String show err msg
  */
 public static String errXMLString(
  String title,
  String errMsg,
  Class errClass) {
  StringBuffer msg = new StringBuffer(100);
  msg.append("<?xml version=/"1.0/" encoding=/"gb2312/" ?>");
  msg.append(
   "<errNode title=/""
    + title
    + "/" errMsg=/""
    + errMsg
    + "/" errSource=/""
    + errClass.getName()
    + "/"/>");
  return msg.toString();
 }

以上都是DOM的基本應用,所以就不一一詳細說明了。
在實際使用過程中,有幾種狀況使用很頻繁,但是DOM的介面的設計卻使該操作很麻煩,所以分別添加了相應的處理方法。
其中最麻煩的要數獲取一個節點的Text子節點文字資訊了,如下的XML節點:
<element>
 text
</element>
在擁有element節點物件時,要獲取其中的文字資訊"text",首先要獲取element節點的子節點列表,要判斷其是否存在子節點,如果存在,那麼遍歷其子節點找到一個TextNode節點,通過getNodeValue()方法來獲取該文字資訊,由於這裡element節點沒有資訊時沒有子節點,所以必須判斷element節點是否存在子節點才能去訪問真正包含了文字資訊的TextNode節點,那麼如果要處理的資料都是以這種形式給出的,就會增加大量的開發程式碼同時讓開發工作枯燥無味,因此這裡使用了一個預設的約定實現,就是,給出了一個公共方法,該方法取給定Node下的直接子節點的Text節點文字資訊,如果不存在Text節點則返回null,這個約定雖然使該方法的使用有所限制,也可能導致錯誤使用該方法,但是,按實際使用的狀況來看,這樣的約定和使用方式是沒有問題的,因為實際用到的都是上面舉的例子的狀況,程式碼:
 /**
  * 這個方法獲取給定Node下的Text節點文字資訊,如果不存在Text節點則返回null。
  * 注意:是直接子節點,相差2層或2層以上不會被考慮。
  * @param node a Node 一個Node。
  * @return a String 如果給定節點存在Text子節點,則返回第一個訪問到的Text子節點文字資訊,如果不存在則返回null。
  */
 public static String getNodeValue(Node node) {
  if (node == null) {
   return null;
  }

  Text text = getTextNode(node);

  if (text != null) {
   return text.getNodeValue();
  }

  return null;
 }

 /**
  * 這個方法獲取給定Node下的Text節點,如果不存在Text節點則返回null。
  * 注意:是直接子節點,相差2層或2層以上不會被考慮。
  * @param node a Node 一個Node。
  * @return a Text 如果給定節點存在Text子節點,則返回第一個訪問到的Text子節點,如果不存在則返回null。
  */
 public static Text getTextNode(Node node) {
  if (node == null) {
   return null;
  }
  if (node.hasChildNodes()) {
   NodeList list = node.getChildNodes();
   for (int i = 0; i < list.getLength(); i++) {
    if (list.item(i).getNodeType() == Node.TEXT_NODE) {
     return (Text) list.item(i);
    }
   }
  }
  return null;
 }

上面程式碼將獲取給定Node節點的直接Text子節點分開包裝。

另一個很經常碰到的狀況是,我希望直接定位到目標節點,獲取該節點物件,而不需要通過一層一層的節點遍歷來找到目標節點,DOM2介面中至少提供瞭如下的方式來定位節點:
1、 對於Document物件:
1) getDocumentElement()――獲取根節點物件,實際很少使用的,因為根節點基本也就只是根節點而已,實際的資料節點都是根節點下的直接子節點開始的。
2) getElementById(String elementId)――這個方法本來應該是一個最佳的定位方法,但是在實際使用過程中沒有被我使用,其主要原因就是,這裡的"ID"不同於一個節點的屬性"ID",這在org.w3c.dom.Document的API說明中是明確指出,而我找了不少的資料也沒有看到有關的使用方式,所以只好放棄了。
3) getElementsByTagName(String tagname)――這個方法其實是沒有辦法的選擇,只好用它了,不過實際倒也很合用,雖然該方法返回的是一個NodeList,但是實際使用時,將節點的tagName設計成特殊字串,那麼就可以直接獲取了,而實際使用時,其實也差不多,很多時候會直接拿資料庫中的欄位名來作為tagName,以方便得獲取該欄位得值,在一個簡單得約定下,使用瞭如下方法:
 /**
  * 這個方法檢索引數element下所有TagName為:tagName的節點,並返回節點列表的第一個節點。
  * 如果不存在該tagName的節點,則返回null。
  * @param element 待搜尋節點
  * @param tagName 待搜尋標籤名
  * @return a Element 獲得以tagName為標籤名的節點列表的第一個節點。
  */
 public static Element getFirstElementByName(
  Element element,
  String tagName) {
  return (Element) getFirstElement(element.getElementsByTagName(tagName));
 }
 /**
  * 從給定節點列表中獲取第一個節點返回,如果節點集合為null/空,則返回null。
  * @param nodeList a NodeList
  * @return a Node
  */
 private static Node getFirstElement(NodeList nodeList) {
  if (nodeList == null || nodeList.getLength() == 0) {
   return null;
  }
  return nodeList.item(0);
 }
這個約定看似限制很大,其實實際使用時基本都是這樣的,只要獲取第一個給定tagName的Element節點就可以了的。
 4)getElementsByTagNameNS(String namespaceURI, String localName)――這個方法基本沒有使用,因為還沒有碰到需要使用名稱空間的狀況。
2、 對於Element物件――――Element物件和Document物件雷同,少了getDocumentElement()方法,不過和Document一樣也都是主要使用getElementsByTagName()方法。
3、 其它的節點物件基本沒有直接定位的訪問方法

還有一種,是由於DOM2的限制導致的,DOM2規範中,不能將一個Document  docA的節點直接加入到另一個Document  docB物件的節點的子節點列表中,要這麼做必須首先將docA的節點通過docB的importNode方法轉換後在新增到目標節點的子節點列表中,所以也有一個方法來統一處理:
 /**
  * 這個方法將引數appendedDoc的根節點及其以下節點附加到doc的跟節點下面。
  * 作為doc的跟節點的作後一個子節點。
  * 相當於:doc.appendDoc(appendedDoc);
  * @param doc a Document
  * @param appendedDoc a Document
  */
 public static void appendXMLDocument(Document doc, Document appendedDoc) {
  if (appendedDoc != null) {
   doc.getFirstChild().appendChild(
    doc.importNode(appendedDoc.getFirstChild(), true));
  }
 }
 /**
  * 這個方法將引數appendedDoc的根節點及其以下節點附加到node節點下面。
  * 作為node節點的作後一個子節點。
  * 相當於:node.appendDoc(appendedNode);
  * @param node 待新增的節點將被新增到該節點的最後。
  * @param appendedNode a Node 這個節點將被新增作為node節點的最後一個子節點。
  */
 public static void appendXMLDocument(Node node, Node appendedNode) {
  if (appendedNode == null) {
   return;
  }
  if (appendedNode instanceof Document) {
   appendedNode = ((Document) appendedNode).getDocumentElement();
  }
  node.appendChild(
   node.getOwnerDocument().importNode(appendedNode, true));
 }

基本上就這些常用的了,其它還有一些零碎的方法,不過都不常用到,就不作介紹了。
另外要說的是,如果哪位知道上面說到的getElementById()方法的具體可行的方便用法,也請指教下。