Android 開發之路十———SAX,DOM,PULL解析XML

 

 

SAX 解析XML

 

 SAX是一個解析速度快並且佔用記憶體少的xml解析器，非常適合用於Android等行動裝置。 SAX解析XML檔案採用的是事件驅動，也就是說，它並不需要解析完整個文檔，在按內容順序解析文檔的過程中，SAX會判斷當前讀到的字元是否合法XML文法中的某部分，如果符合就會觸發事件。所謂事件，其實就是一些回調（callback）方法，這些方法(事件)定義在ContentHandler介面。下面是一些ContentHandler介面常用的方法：

startDocument()

當遇到文檔的開頭的時候，調用這個方法，可以在其中做一些預先處理的工作。

endDocument()

和上面的方法相對應，當文檔結束的時候，調用這個方法，可以在其中做一些善後的工作。

startElement(String namespaceURI, StringlocalName, String qName, Attributes atts)

當讀到一個開始標籤的時候，會觸發這個方法。namespaceURI就是命名空間，localName是不帶命名空間首碼的標籤名，qName是帶命名空間首碼的標籤名。通過atts可以得到所有的屬性名稱和相應的值。要注意的是SAX中一個重要的特點就是它的串流，當遇到一個標籤的時候，它並不會紀錄下以前所碰到的標籤，也就是說，在startElement()方法中，所有你所知道的資訊，就是標籤的名字和屬性，至於標籤的嵌套結構，上層標籤的名字，是否有子元屬等等其它與結構相關的資訊，都是不得而知的，都需要你的程式來完成。這使得SAX在編程處理上沒有DOM來得那麼方便。

endElement(String uri, String localName,String name)

這個方法和上面的方法相對應，在遇到結束標籤的時候，調用這個方法。

characters(char[] ch, int start, intlength)

這個方法用來處理在XML檔案中讀到的內容，第一個參數為檔案的字串內容，後面兩個參數是讀到的字串在這個數組中的起始位置和長度，使用new String(ch,start,length)就可以擷取內容。

 

只要為SAX提供實現ContentHandler介面的類，那麼該類就可以得到通知事件（實際上就是SAX調用了該類中的回調方法）。因為ContentHandler是一個介面，在使用的時候可能會有些不方便，因此，SAX還為其制定了一個Helper類：DefaultHandler，它實現了ContentHandler介面，但是其所有的方法體都為空白，在實現的時候，你只需要繼承這個類，然後重寫相應的方法即可。使用SAX解析itcast.xml的代碼如下：

 

 

public static List<Person>readXML(InputStream inStream) {

  try {

       SAXParserFactoryspf = SAXParserFactory.newInstance();

       SAXParsersaxParser = spf.newSAXParser(); //建立解析器

       //設定解析器的相關特性，http://xml.org/sax/features/namespaces= true 表示開啟命名空間特性 

       //saxParser.setProperty("http://xml.org/sax/features/namespaces",true);

       XMLContentHandlerhandler = new XMLContentHandler();

       saxParser.parse(inStream,handler);

       inStream.close();

       returnhandler.getPersons();

   }catch (Exception e) {

       e.printStackTrace();

   }

 return null;

}

SAX 支援已內建到JDK1.5中，你無需添加任何的jar檔案。關於XMLContentHandler的代碼實現請看本頁下面備忘。

 

 

DOM解析XML

 

除了可以使用 SAX解析XML檔案，大家也可以使用熟悉的DOM來解析XML檔案。 DOM解析XML檔案時，會將XML檔案的所有內容以對象樹方式存放在記憶體中，然後允許您使用DOM API遍曆XML樹、檢索所需的資料。使用DOM操作XML的代碼看起來比較直觀，並且，在某些方面比基於SAX的實現更加簡單。但是，因為DOM需要將XML檔案的所有內容以對象樹方式存放在記憶體中，所以記憶體的消耗比較大，特別對於運行Android的行動裝置來說，因為裝置的資源比較寶貴，所以建議還是採用SAX來解析XML檔案，當然，如果XML檔案的內容比較小採用DOM是可行的。如下列代碼：

 

import java.io.InputStream;

import java.util.ArrayList;

import java.util.List;

import javax.xml.parsers.DocumentBuilder;

importjavax.xml.parsers.DocumentBuilderFactory;

import org.w3c.dom.Document;

import org.w3c.dom.Element;

import org.w3c.dom.Node;

import org.w3c.dom.NodeList;

importcn.itcast.xml.domain.Person;

/**

 * 使用Dom解析xml檔案

 *

 */

public class DomXMLReader {

public static List<Person>readXML(InputStream inStream) {

       List<Person>persons = new ArrayList<Person>();

       DocumentBuilderFactoryfactory = DocumentBuilderFactory.newInstance();

       try{

              DocumentBuilderbuilder = factory.newDocumentBuilder();

              Documentdom = builder.parse(inStream);

              Elementroot = dom.getDocumentElement();

              NodeListitems = root.getElementsByTagName("person");//尋找所有person節點

              for(int i = 0; i < items.getLength(); i++) {

                     Personperson = new Person();

                     //得到第一個person節點

                     ElementpersonNode = (Element) items.item(i);

                     //擷取person節點的id屬性值

                     person.setId(newInteger(personNode.getAttribute("id")));

                     //擷取person節點下的所有子節點(標籤之間的空白節點和name/age元素)

                     NodeListchildsNodes = personNode.getChildNodes();

                     for(int j = 0; j < childsNodes.getLength(); j++) {

                     Nodenode = (Node) childsNodes.item(j);
                     //判斷是否為元素類型

                     if(node.getNodeType()== Node.ELEMENT_NODE){                                       Element childNode = (Element) node;

                                        //判斷是否name元素

                         if("name".equals(childNode.getNodeName())) {

                          //擷取name元素下Text節點,然後從Text節點擷取資料                                    person.setName(childNode.getFirstChild().getNodeValue());

                         } else if(“age”.equals(childNode.getNodeName())) {

                     person.setAge(newShort(childNode.getFirstChild().getNodeValue()));

                         }

                     }

                      }

                  persons.add(person);

              }

              inStream.close();

       }catch (Exception e) {

              e.printStackTrace();

       }

       returnpersons;

}

 

 

PULL解析XML

 

除了可以使用 SAX和DOM解析XML檔案，大家也可以使用Android內建的Pull解析器解析XML檔案。 Pull解析器的運行方式與 SAX 解析器相似。它提供了類似的事件，如：開始元素和結束元素事件，使用parser.next()可以進入下一個元素並觸發相應事件。事件將作為數值代碼被發送，因此可以使用一個switch對感興趣的事件進行處理。當元素開始解析時，調用parser.nextText()方法可以擷取下一個Text類型元素的值。

使用Pull解析器讀取itcast.xml的代碼

 

import org.xmlpull.v1.XmlPullParser;

import android.util.Xml;

import cn.itcast.xml.domain.Person;

public class PullXMLReader {

public static List<Person>readXML(InputStream inStream) {

       XmlPullParserparser = Xml.newPullParser();

       try{

       parser.setInput(inStream,"UTF-8");

       inteventType = parser.getEventType();

       PersoncurrentPerson = null;

       List<Person>persons = null;

       while(eventType != XmlPullParser.END_DOCUMENT) {

              switch(eventType) {

              caseXmlPullParser.START_DOCUMENT://文檔開始事件,可以進行資料初始化處理

                     persons= new ArrayList<Person>();

                     break;

              caseXmlPullParser.START_TAG://開始元素事件

                     Stringname = parser.getName();

                     if(name.equalsIgnoreCase("person")) {

                            currentPerson= new Person();

                            currentPerson.setId(newInteger(parser.getAttributeValue(null, "id")));

                     }else if (currentPerson != null) {

                            if(name.equalsIgnoreCase("name")) {

                                   currentPerson.setName(parser.nextText());//如果後面是Text元素,即返回它的值

                            }else if (name.equalsIgnoreCase("age")) {

                                   currentPerson.setAge(newShort(parser.nextText()));

                            }

                     }

                     break;

              caseXmlPullParser.END_TAG://結束元素事件

                     if(parser.getName().equalsIgnoreCase("person") && currentPerson!= null) {

                            persons.add(currentPerson);

                            currentPerson= null;

                     }

                     break;

              }

              eventType= parser.next();

       }

       inStream.close();

       returnpersons;

       }catch (Exception e) {

              e.printStackTrace();

       }

       returnnull;

}

}

 

有些時候，我們需要產生一個XML檔案，產生XML檔案的方法有很多，如：可以只使用一個StringBuilder組拼XML內容，然後把內容寫入到檔案中；或者使用DOM API產生XML檔案，或者也可以使用pull解析器產生XML檔案，這裡推薦大家使用Pull解析器。

使用Pull解析器產生一個與itcast.xml檔案內容相同的myitcast.xml檔案，代碼產生XML檔案）：

File xmlFile = new File("myitcast.xml");

FileOutputStream outStream = newFileOutputStream(xmlFile);

OutputStreamWriter outStreamWriter = newOutputStreamWriter(outStream, "UTF-8");

BufferedWriter writer = newBufferedWriter(outStreamWriter);

writeXML(persons, writer);

writer.flush();

writer.close();

如果只想得到產生的xml字串內容，可以使用StringWriter：

StringWriter writer = new StringWriter();

writeXML(persons, writer);

String content = writer.toString();

public static StringwriteXML(List<Person> persons, Writer writer){

   XmlSerializer serializer = Xml.newSerializer();

   try {

       serializer.setOutput(writer);

       serializer.startDocument("UTF-8", true);

     //第一個參數為命名空間,如果不使用命名空間,可以設定為null

       serializer.startTag("", "persons");

       for (Person person : persons){

           serializer.startTag("", "person");

           serializer.attribute("", "id",person.getId().toString());

           serializer.startTag("", "name");

           serializer.text(person.getName());

           serializer.endTag("", "name");

           serializer.startTag("", "age");

           serializer.text(person.getAge().toString());

           serializer.endTag("", "age");

           serializer.endTag("", "person");

       }

       serializer.endTag("", "persons");

       serializer.endDocument();

       return writer.toString();

    }catch (Exception e) {

       e.printStackTrace();

    }

   return null;

}