Java中如何引用文档对象模型_在JAVA中使用文档对象模型DOM经验小结
文檔對象模型 (DOM) 是一個文檔標準，對于完備的文檔和復雜的應用程序，DOM 提供了大量靈活性。DOM標準是標準的。它很強壯且完整，并且有許多實現(xiàn)。這是許多大型安裝的決定因素--特別是對產(chǎn)品應用程序，以避免在API發(fā)生改變時進行大量的改寫。
以上是我在選擇處理XML數(shù)據(jù)時之所以沒有選擇JDOM或者dom4j等其它面向?qū)ο蟮臉藴实脑?#xff0c;不過也由于DOM從一開始就是一種與語言無關(guān)的模型，而且它更趨向用于像C或Perl這類語言，沒有利用Java的面向?qū)ο蟮男阅?#xff0c;所以在使用的過程中也遇到了不少的麻煩，今天這里做一個小結(jié)。另外，我目前使用XML主要是作為數(shù)據(jù)傳輸?shù)慕y(tǒng)一格式，并統(tǒng)一用戶界面展示的接口，應用的面并不是很廣，所以使用到的DOM的內(nèi)容其實不多。
在準備使用它的時候，是做了充足的準備的，也有遇到困難的準備，所以一開始就有了一個簡單的工具類來封裝DOM對象使用時必要的公共方法，實際證明這樣做是很明智的，一個簡單的創(chuàng)建Document對象的操作，要是每次都需要寫上5行以上代碼，并且還要處理那些煩人的Exception，實在是會打擊大家的積極性，所以在最初，做了一個XMLTool類，專門封裝了如下的公共方法：
1、?Document對象創(chuàng)建(包括空的Document對象創(chuàng)建，以一個給定Node節(jié)點作為根節(jié)點創(chuàng)建。
2、?將一個規(guī)范的XML字符串轉(zhuǎn)換成一個Document對象。
3、?從物理硬盤讀取一個XML文件并返回一個Document對象。
4、?將一個Node對象轉(zhuǎn)換成字符串。
其中每個方法都截獲相關(guān)的DOM操作所拋出的異常，轉(zhuǎn)換成一個RuntimeException拋出，這些異常在實際使用過程中，一般狀況下其實都不會拋出，特別是象生成一個Document對象時的ParserConfigurationException、轉(zhuǎn)換Node節(jié)點成字符串時要生成一個Transformer對象時的TransformerConfigurationException等等，沒有必要在它們身上花時間精力。而且真就出了相關(guān)的異常的話，其實根本沒有辦法處理，這樣的狀況通常是系統(tǒng)環(huán)境配置有問題(比如必要的DOM實現(xiàn)解析器等包沒有加入環(huán)境)，所以包裝該異常時只是很簡要的獲取其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轉(zhuǎn)換成一個org.w3c.dom.Document對象返回。
* @param xmlString 一個符合XML規(guī)范的字符串表達。
* @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("參數(shù)為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());
}
}
/**
* 給定一個節(jié)點，將該節(jié)點加入新構(gòu)造的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為：系統(tǒng)錯誤。之所以使用字符串拼裝，主要是這樣做一般
* 不會有異常出現(xiàn)。
* @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("");
return msg.toString();
}
/**
* 返回一段XML表述的錯誤信息。提示信息的TITLE為：系統(tǒng)錯誤
* @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(
"
+ 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(
"
+ title
+ "\" errMsg=\""
+ errMsg
+ "\" errSource=\""
+ errClass.getName()
+ "\"/>");
return msg.toString();
}
以上都是DOM的基本應用，所以就不一一詳細說明了。
在實際使用過程中，有幾種狀況使用很頻繁，但是DOM的接口的設計卻使該操作很麻煩，所以分別添加了相應的處理方法。
其中最麻煩的要數(shù)獲取一個節(jié)點的Text子節(jié)點文本信息了，如下的XML節(jié)點：
text
在擁有element節(jié)點對象時，要獲取其中的文本信息"text"，首先要獲取element節(jié)點的子節(jié)點列表，要判斷其是否存在子節(jié)點，如果存在，那么遍歷其子節(jié)點找到一個TextNode節(jié)點，通過getNodeValue()方法來獲取該文本信息，由于這里element節(jié)點沒有信息時沒有子節(jié)點，所以必須判斷element節(jié)點是否存在子節(jié)點才能去訪問真正包含了文本信息的TextNode節(jié)點，那么如果要處理的數(shù)據(jù)都是以這種形式給出的，就會增加大量的開發(fā)代碼同時讓開發(fā)工作枯燥無味，因此這里使用了一個默認的約定實現(xiàn)，就是，給出了一個公共方法，該方法取給定Node下的直接子節(jié)點的Text節(jié)點文本信息，如果不存在Text節(jié)點則返回null，這個約定雖然使該方法的使用有所限制，也可能導致錯誤使用該方法，但是，按實際使用的狀況來看，這樣的約定和使用方式是沒有問題的，因為實際用到的都是上面舉的例子的狀況，代碼：
/**
* 這個方法獲取給定Node下的Text節(jié)點文本信息，如果不存在Text節(jié)點則返回null。
* 注意：是直接子節(jié)點，相差2層或2層以上不會被考慮。
* @param node a Node 一個Node。
* @return a String 如果給定節(jié)點存在Text子節(jié)點，則返回第一個訪問到的Text子節(jié)點文本信息，如果不存在則返回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節(jié)點，如果不存在Text節(jié)點則返回null。
* 注意：是直接子節(jié)點，相差2層或2層以上不會被考慮。
* @param node a Node 一個Node。
* @return a Text 如果給定節(jié)點存在Text子節(jié)點，則返回第一個訪問到的Text子節(jié)點，如果不存在則返回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節(jié)點的直接Text子節(jié)點分開包裝。
另一個很經(jīng)常碰到的狀況是，我希望直接定位到目標節(jié)點，獲取該節(jié)點對象，而不需要通過一層一層的節(jié)點遍歷來找到目標節(jié)點，DOM2接口中至少提供了如下的方式來定位節(jié)點：
1、?對于Document對象：
1)?getDocumentElement()
總結(jié)
以上是生活随笔為你收集整理的Java中如何引用文档对象模型_在JAVA中使用文档对象模型DOM经验小结的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： 去年累计接到 700 例误报，急救人员呼
- 下一篇： 苹果App Store累计营收超3200