Android XML解析學習——Dom方式

一．基礎知識

在《Android XML解析學習——Sax方式》和《Android XML解析學習——Sax方式(續)》中我們學習了在Android 平臺上使用SAX的方式解析XML文檔的方法。除了SAX的方式，還有一種常用的爲DOM（Document Object Model文檔對象模型）方式。

DOM方式解析XML的過程爲首先將所有 XML 文檔讀取到內存中，構造一個樹結構，然後允許使用 DOM API 來操作整個樹結構，包括遍歷 XML 樹、檢索所需的數據等。

Android平臺使用Java SDK中的API來實現DOM方式的解析，具體的方法和之前學習的使用Java SDK中的SAX方式解析XML類似，因此有了前面SAX的基礎，學習DOM方式就會比較簡單了。DOM 和 之前的SAX 的主要差別是 API 本身的結構，SAX 由基於事件的回調集組成，邊解析邊產生事件從而調用事件處理器的回調函數進行處理。而DOM不是，DOM直接讀取整個XML樹保存爲Document類，因此只需處理保存在內存中的Document對象即可，沒有回調函數。

DOM解析相關的包爲javax.xml.parsers和org.w3c.dom。其中javax.xml.parsers提供Document構造器工廠DocumentBuilderFactory和Document構造器DocumentBuilder，DocumentBuilderFactory實例調用newDocumentBuilder()創建構造器DocumentBuilder實例，然後該實例就可以調用parse方法來返回一個解析爲Document類的實例。Document 類由表示XML文檔的包含元素、屬性、文本內容等的各個節點組成。因此有了Document對象後就可以按需要獲取xml文檔中各個子節點及其相關的值了。Document、Element、Node等各個和DOM相關的具體部分都在org.w3c.dom包中，因此和SAX類似，org.w3c.dom包是底層具體的負責DOM解析相關的內容，並且爲上層javax.xml.parsers包提供DOM解析器等相關調用。

 

下面我們就用上面介紹的DOM方式來實現解析XML形式的USGS地震數據的Demo例子。

二．實例開發

我們要完成的效果圖如下圖1所示：

 

圖1 ListView列表顯示的地震數據

和上一部分Demo例子的一樣，也是解析完地震數據後用ListView列表的方式顯示每條地震的震級和地名信息。

新建一個Android工程AndroidXMLDemoDom。

要添加的基本內容和上一個Demo中的一樣，這裏就不再贅述，這次要添加的解析器新類爲DomEarthquakeHandler，內容如下所示：

 

public class DomEarthquakeHandler { //xml解析用到的Tag private String kEntryElementName = "entry"; private String kLinkElementName = "link"; private String kLinkAttributeName = "href"; private String kTitleElementName = "title"; private String kUpdatedElementName = "updated"; private String kGeoRSSPointElementName = "georss:point"; private String kGeoRSSElevElementName = "georss:elev"; //用於保存xml解析獲取的結果 private ArrayList<EarthquakeEntry> earthquakeEntryList; private EarthquakeEntry earthquakeEntry = null; //解析xml數據 public ArrayList<EarthquakeEntry> parse(InputStream inStream) { earthquakeEntryList = new ArrayList<EarthquakeEntry>(); //創建DocumentBuilder DocumentBuilderFactory docBFactory = DocumentBuilderFactory.newInstance(); DocumentBuilder docBuilder = null; try { docBuilder = docBFactory.newDocumentBuilder(); } catch (ParserConfigurationException e1) { // TODO Auto-generated catch block e1.printStackTrace(); } //解析地震數據流. Document doc = null; try { doc = docBuilder.parse(inStream); } catch (SAXException e1) { // TODO Auto-generated catch block e1.printStackTrace(); } catch (IOException e1) { // TODO Auto-generated catch block e1.printStackTrace(); } Element docEle = doc.getDocumentElement(); // Get a list of each earthquake entry. NodeList nList = docEle.getElementsByTagName(kEntryElementName); if(nList != null && nList.getLength() > 0) { for(int i=0; i < nList.getLength(); i++) { try { Element entry = (Element)nList.item(i); Element title = (Element)entry.getElementsByTagName(kTitleElementName).item(0); Element when = (Element)entry.getElementsByTagName(kUpdatedElementName).item(0); Element gpoint = (Element)entry.getElementsByTagName(kGeoRSSPointElementName).item(0); Element gelev = (Element)entry.getElementsByTagName(kGeoRSSElevElementName).item(0); Element link = (Element)entry.getElementsByTagName(kLinkElementName).item(0); String details = title.getFirstChild().getNodeValue(); String point = gpoint.getFirstChild().getNodeValue(); String elevS = gelev.getFirstChild().getNodeValue(); String date = when.getFirstChild().getNodeValue(); //獲取link鏈接 String webLink = link.getAttribute(kLinkAttributeName); // Log.v("Dom", webLink); //構造更新時間 SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd'T'hh:mm:ss'Z'"); Date qdate = new GregorianCalendar(0,0,0).getTime(); try { qdate = sdf.parse(date); } catch (ParseException e) { e.printStackTrace(); } //提取經緯度信息 String[] latLongitude = point.split(" "); Location location = new Location("dummyGPS"); location.setLatitude(Double.parseDouble(latLongitude[0])); location.setLongitude(Double.parseDouble(latLongitude[1])); //提取強度信息 String magnitudeString = details.split(" ")[1]; int end = magnitudeString.length()-1; double magnitude = Double.parseDouble(magnitudeString.substring(0, end)); //提取位置信息 String place = details.split(",")[1].trim(); //提取海拔高度信息 double evel; //因爲USGS數據有可能會輸錯，比如爲"--10000"，多了一個"-"號 try { evel = Double.parseDouble(elevS); } catch (Exception e) { // TODO: handle exception e.printStackTrace(); evel = 0; } Log.v("Dom_Elev", String.valueOf(evel)); earthquakeEntry = new EarthquakeEntry(qdate, place, webLink, location, magnitude, evel); earthquakeEntryList.add(earthquakeEntry); } catch (Exception e) { // TODO: handle exception e.printStackTrace(); } } } Log.v("Dom", "End"); return earthquakeEntryList; } }

 

程序首先也是定義解析時需要用到的元素Tag名稱變量，其中因爲DOM沒有像SAX方式那樣可以把一個元素的的名稱分開爲表示名稱空間的Uri和當前標籤名的localname，只是通過getElementsByTagName方法由完整的名稱讀取，因此需要定義完整的元素標籤名稱：

 

private String kGeoRSSPointElementName = "georss:point"; private String kGeoRSSElevElementName = "georss:elev";

 

在定義的用於解析xml數據的方法中

public ArrayList<EarthquakeEntry> parse(InputStream inStream)

使用工廠類創建Document構造器DocumentBuilder:

//創建DocumentBuilder DocumentBuilderFactory docBFactory = DocumentBuilderFactory.newInstance(); DocumentBuilder docBuilder = null; try { docBuilder = docBFactory.newDocumentBuilder(); } catch (ParserConfigurationException e1) { // TODO Auto-generated catch block e1.printStackTrace(); }

然後調用DocumentBuilder實例的parse方法解析xml文檔數據並返回Document對象，並通過getDocumentElement()方法獲取文檔的根元素。

 

//解析地震數據流. Document doc = null; try { doc = docBuilder.parse(inStream); } catch (SAXException e1) { // TODO Auto-generated catch block e1.printStackTrace(); } catch (IOException e1) { // TODO Auto-generated catch block e1.printStackTrace(); } Element docEle = doc.getDocumentElement();

有了XML文檔的根元素，就可以通過getElementsByTagName等方法獲取具體的子元素，及子節點和節點值等。具體方法可以參考以上的代碼。

最後添加AndroidXMLDemoDom.java文件中的內容，內容和前一個Demo工程AndroidXMLDemoSaxII中的AndroidXMLDemoSaxII.java基本一樣，

public class AndroidXMLDemoDom extends Activity { /** Called when the activity is first created. */ //定義顯示的List相關變量 ListView list; ArrayAdapter<EarthquakeEntry> adapter; ArrayList<EarthquakeEntry> earthquakeEntryList; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); //獲取地震數據流 InputStream earthquakeStream = readEarthquakeDataFromFile(); //Dom方式進行xml解析 DomEarthquakeHandler domHandler = new DomEarthquakeHandler(); earthquakeEntryList = domHandler.parse(earthquakeStream); //用ListView進行顯示 list = (ListView)this.findViewById(R.id.list); adapter = new ArrayAdapter<EarthquakeEntry>(this, android.R.layout.simple_list_item_1, earthquakeEntryList); list.setAdapter(adapter); } private InputStream readEarthquakeDataFromFile() { //從本地獲取地震數據 InputStream inStream = null; try { inStream = this.getAssets().open("USGS_Earthquake_1M2_5.xml"); } catch (IOException e) { // TODO Auto-generated catch block e.printStackTrace(); } return inStream; } private InputStream readEarthquakeDataFromInternet() { //從網絡上獲取實時地震數據 URL infoUrl = null; InputStream inStream = null; try { infoUrl = new URL("http://earthquake.usgs.gov/earthquakes/catalogs/1day-M2.5.xml"); URLConnection connection = infoUrl.openConnection(); HttpURLConnection httpConnection = (HttpURLConnection)connection; int responseCode = httpConnection.getResponseCode(); if(responseCode == HttpURLConnection.HTTP_OK) { inStream = httpConnection.getInputStream(); } } catch (MalformedURLException e) { // TODO Auto-generated catch block e.printStackTrace(); } catch (IOException e) { // TODO Auto-generated catch block e.printStackTrace(); } return inStream; } }

 

只是把進行XML解析的部分換成了如下方式：

//Dom方式進行xml解析 DomEarthquakeHandler domHandler = new DomEarthquakeHandler(); earthquakeEntryList = domHandler.parse(earthquakeStream);

完成了，可以保存運行看下效果。

 

這樣我們就已經學習了Android上使用SAX和DOM兩種方式解析XML的方法，下面我們簡單總結比較一下兩者的區別。

DOM解析器是通過將XML文檔解析成樹狀模型並將其放入內存來完成解析工作的，而後對文檔的操作都是在這個樹狀模型上完成的。這個在內存中的文檔樹將是 文檔實際大小的幾倍。這樣做的好處是結構清除、操作方便，而帶來的麻煩就是極其耗費系統資源。而SAX正好克服了DOM的缺點。SAX解析器的處理過程是 通讀整個文檔，根據文檔內容產生事件，而把對這些事件的處理交由事件處理器處理。SAX不需要在內存中保存整個文檔，它對系統資源的節省是顯而易見的。這 樣在一些需要處理大型XML文檔和性能要求比較高的場合就要用SAX了。

我們以表格的形式看一下他們在一些方面的比較：

SAX	DOM
順序讀入文檔併產生相應事件，可以處理任何大小的XML文檔	在內存中創建文檔樹，不適於處理大型XML文檔
只能對文檔按順序解析一遍，不支持對文檔的隨意訪問	可以隨意訪問文檔樹的任何部分，沒有次數限制
只能讀取XML文檔內容，而不能修改	可以隨意修改文檔樹，從而修改XML文檔
開發上比較複雜，需要自己來實現事件處理器	易於理解，易於開發

通過比較我們可以知道SAX和DOM各自適合的場合：

SAX適於處理下面的問題：

1. 對大型文檔進行處理

2. 只需要文檔的部分內容，或者只需要從文檔中得到特定信息

DOM適合處理下面的問題：

1. 需要對文檔進行修改

2. 需要隨機對文檔進行訪問

以上只是對SAX和DOM方式傳統的比較，而對具體的在Android平臺上使用來說，因爲DOM更加佔用內存，而對運行在移動設備上的Android系統來說往往內存是一個比較稀缺的資源，因此除非XML 文檔始終保持很小的大小，否則相對來說推薦在Android 應用程序中使用SAX 方式解析XML 。並且Android系統爲SAX還提供了額外的實用工具android.util.Xml和特有的包android.sax等，因此實際上在Android使用SAX也一樣很方便了。

三．總結

在這部分中我們學習了使用DOM方式解析XML的方法，並且比較了DOM方式和SAX方式的各種特點及區別。

從以上的學習我們知道Android平臺已經爲XML的解析提供了強大的功能，既可以使用Java SDK中的SAX和DOM方式來解析，還可以使用Android SDK提供的SAX方式。但Android平臺上還有一種解析XML的方式，就是使用Pull解析器，這部分內容我們以後接着學習。

 

注：

參考資料：http://www.ibm.com/developerworks/cn/xml/x-jaxp/