android解析xml文件

在androd手机中处理xml数据是很常见的事情，通常在不同平台传输数据的时候就可能使用xml。xml与平台无关的特性，被广泛运用于数据通信中。android中解析xml文件数据通常有三种方式：DOM,SAX,PULL。

一、DOM方式

        DOM方式解析xml是先把xml文档都读到内存中，然后再用DOM API来访问树形结构，并获取数据的。但是这样一来，如果xml文件很大（手机CPU处理能力当然不能与PC机器比），在处理效率方面就相对差了，当然这是对于其它方式处理xml文档而言。写一个river的xml测试文件放在assets目录。如下：

1. <?xml version="1.0" encoding="utf-8"?>
   
2. <rivers>
   
3.  <river name="灵渠" length="605">
   
4.      <introduction>
   
5.       灵渠在广西壮族自治区兴安县境内，是世界上最古老的运河之一，有着“世界古代水利建筑明珠”的美誉。灵渠古称秦凿渠、零渠、陡河、兴安运河，于公元前214年凿成通航，距今已2217年，仍然发挥着功用。
   
6.      </introduction>
   
7.       <imageurl>
   
8.       http://imgsrc.baidu.com/baike/pic/item/389aa8fdb7b8322e08244d3c.jpg
   
9.      </imageurl>
   
10.    </river>
    
11.    
    
12.    <river name="胶莱运河" length="200">
    
13.      <introduction>
    
14.       胶莱运河南起黄海灵山海口，北抵渤海三山岛，流经现胶南、胶州、平度、高密、昌邑和莱州等，全长200公里，流域面积达5400平方公里，南北贯穿山东半岛，沟通黄渤两海。胶莱运河自平度姚家村东的分水岭南北分流。南流由麻湾口入胶州湾，为南胶莱河，长30公里。北流由海仓口入莱州湾,为北胶莱河,长100余公里。
    
15.      </introduction>
    
16.       <imageurl>
    
17.       http://imgsrc.baidu.com/baike/pic/item/389aa8fdb7b8322e08244d3c.jpg
    
18.      </imageurl>
    
19.    </river>
    
20.    
    
21.    <river name="苏北灌溉总渠" length="168">
    
22.      <introduction>
    
23.       位于淮河下游江苏省北部，西起洪泽湖边的高良涧，流经洪泽，青浦、淮安，阜宁、射阳，滨海等六县(区)，东至扁担港口入海的大型人工河道。全长168km。
    
24.      </introduction>
    
25.       <imageurl>
    
26.       http://imgsrc.baidu.com/baike/pic/item/389aa8fdb7b8322e08244d3c.jpg
    
27.      </imageurl>
    
28.    </river>
    
29.  </rivers>

       具体思路是：1、首先利用DocumentBuilderFactory创建一个DocumentBuilderFactory实例；2、然后利用DocumentBuilderFactory创建DocumentBuilder；3、然后加载XML文档（Document）；4、然后获取文档的根结点(Element)；5、然后获取根结点中所有子节点的列表（NodeList）；6、然后使用再获取子节点列表中的需要读取的结点。

       观察节点，需要用一个River对象来保存数据，抽象出River类，如下：

1. public class River implements Serializable {
   
2.     private static final long serialVersionUID = 1L;
   
3.     private String name;
   
4.     public String getName() {
   
5.         return name;
   
6.     }
   
7.     public void setName(String name) {
   
8.         this.name = name;
   
9.     }
   
10.     public int getLength() {
    
11.         return length;
    
12.     }
    
13.     public void setLength(int length) {
    
14.         this.length = length;
    
15.     }
    
16.     public String getIntroduction() {
    
17.         return introduction;
    
18.     }
    
19.     public void setIntroduction(String introduction) {
    
20.         this.introduction = introduction;
    
21.     }
    
22.     public String getImageurl() {
    
23.         return imageurl;
    
24.     }
    
25.     public void setImageurl(String imageurl) {
    
26.         this.imageurl = imageurl;
    
27.     }
    
28.     private int length;
    
29.     private String introduction;
    
30.     private String imageurl;
    
31. }

       下面就开始读取xml文档对象，并添加进List中。这里是使用assets中的river.xml文件，那么就需要读取这个xml文件，返回输入流。读取方法为：inputStream=this.context.getResources().getAssets().open(fileName);   参数是xml文件路径，当然默认的是assets目录为根目录。然后可以用DocumentBuilder对象的parse方法解析输入流，并返回document对象，然后再遍历doument对象的节点属性。代码如下：

1. //获取全部河流数据
   
2.     /**
   
3.      * 参数fileName：为xml文档路径
   
4.      */
   
5.     public List<River> getRiversFromXml(String fileName){
   
6.         List<River> rivers=new ArrayList<River>();
   
7.         DocumentBuilderFactory factory=null;
   
8.         DocumentBuilder builder=null;
   
9.         Document document=null;
   
10.         InputStream inputStream=null;
    
11.         //首先找到xml文件
    
12.         factory=DocumentBuilderFactory.newInstance();
    
13.         try {
    
14.             //找到xml，并加载文档
    
15.             builder=factory.newDocumentBuilder();
    
16.             inputStream=this.context.getResources().getAssets().open(fileName);
    
17.             document=builder.parse(inputStream);
    
18.             //找到根Element
    
19.              Element root=document.getDocumentElement();
    
20.              NodeList nodes=root.getElementsByTagName(RIVER);
    
21.             //遍历根节点所有子节点,rivers 下所有river
    
22.              River river=null;
    
23.              for(int i=0;i<nodes.getLength();i++){
    
24.                      river=new River();
    
25.                      //获取river元素节点
    
26.                      Element riverElement=(Element)(nodes.item(i));
    
27.                      //获取river中name属性值
    
28.                      river.setName(riverElement.getAttribute(NAME));
    
29.                      river.setLength(Integer.parseInt(riverElement.getAttribute(LENGTH)));
    
30.                      //获取river下introduction标签
    
31.                      Element introduction=(Element)riverElement.getElementsByTagName(INTRODUCTION).item(0);
    
32.                      river.setIntroduction(introduction.getFirstChild().getNodeValue());
    
33.                      Element imageUrl=(Element)riverElement.getElementsByTagName(IMAGEURL).item(0);
    
34.                      river.setImageurl(imageUrl.getFirstChild().getNodeValue());
    
35.                  rivers.add(river);
    
36.              }
    
37.         }catch (IOException e){
    
38.             e.printStackTrace();
    
39.         } catch (SAXException e) {
    
40.             e.printStackTrace();
    
41.         }
    
42.          catch (ParserConfigurationException e) {
    
43.             e.printStackTrace();
    
44.         }finally{
    
45.             try {
    
46.                 inputStream.close();
    
47.             } catch (IOException e) {
    
48.                 e.printStackTrace();
    
49.             }
    
50.         }
    
51.         return rivers;
    
52.     }

二、SAX方式

       使用DOM方式解析xml文档比较符合日常思维方式，但是它直接把文档调入内存中，比较耗内存。在这里可以用另外一种方式解析xml，这个就是SAX（Simple API for XML）方式。

       SAX是基于事件驱动的。当然android的事件机制是基于回调函数的，在用SAX解析xml文档时候，读取到文档开始和结束标签时候就会回调一个事件，在读取到其他节点与内容时候也会回调一个事件。

       既然涉及到事件，就有事件源，事件处理器。在SAX接口中，事件源是org.xml.sax包中的XMLReader，它通过parser()方法来解析XML文档，并产生事件。事件处理器是org.xml.sax包中ContentHander、DTDHander、ErrorHandler，以及EntityResolver这4个接口。XMLReader通过相应事件处理器注册方法setXXXX()来完成的与ContentHander、DTDHander、ErrorHandler，以及EntityResolver这4个接口的连接，详细介绍请见下表：

       但是无需都继承这4个接口，SDK为我们提供了DefaultHandler类来处理，DefaultHandler类的一些主要事件回调方法如下：

       由以上可知，需要XmlReader 以及DefaultHandler来配合解析xml。处理思路是：1、创建SAXParserFactory对象；2、根据SAXParserFactory.newSAXParser()方法返回一个SAXParser解析器；3、根据SAXParser解析器获取事件源对象XMLReader；4、实例化一个DefaultHandler对象；5、连接事件源对象XMLReader到事件处理类DefaultHandler中；6、调用XMLReader的parse方法从输入源中获取到的xml数据；7、通过DefaultHandler返回我们需要的数据集合。代码如下：

1. public List<River> parse(String xmlPath){
   
2.         List<River> rivers=null;
   
3.         SAXParserFactory factory=SAXParserFactory.newInstance();
   
4.         try {
   
5.             SAXParser parser=factory.newSAXParser();
   
6.             //获取事件源
   
7.             XMLReader xmlReader=parser.getXMLReader();
   
8.             //设置处理器
   
9.             RiverHandler handler=new RiverHandler();
   
10.             xmlReader.setContentHandler(handler);
    
11.             //解析xml文档
    
12.             //xmlReader.parse(new InputSource(new URL(xmlPath).openStream()));
    
13.             xmlReader.parse(new InputSource(this.context.getAssets().open(xmlPath)));
    
14.             rivers=handler.getRivers();
    
15.         } catch (ParserConfigurationException e) {
    
16.             // TODO Auto-generated catch block
    
17.             e.printStackTrace();
    
18.         } catch (SAXException e) {
    
19.             // TODO Auto-generated catch block
    
20.             e.printStackTrace();
    
21.         } catch (IOException e) {
    
22.             e.printStackTrace();
    
23.         }
    
24.         
    
25.         return rivers;
    
26.     }

       重点在于DefaultHandler对象中对每一个元素节点，属性，文本内容，文档内容进行处理。前面说过DefaultHandler是基于事件处理模型的，基本处理方式是：当SAX解析器导航到文档开始标签时回调startDocument方法，导航到文档结束标签时回调endDocument方法。当SAX解析器导航到元素开始标签时回调startElement方法，导航到其文本内容时回调characters方法，导航到标签结束时回调endElement方法。

       根据以上的解释，可以得出以下处理xml文档逻辑：

1、当导航到文档开始标签时，在回调函数startDocument中，可以不做处理，当然你可以验证下UTF-8等等。

2、当导航到rivers开始标签时，在回调方法startElement中可以实例化一个集合用来存贮list，不过我们这里不用，因为在构造函数中已经实例化了。

3、导航到river开始标签时，就说明需要实例化River对象了，当然river标签中还有name ,length属性，因此实例化River后还必须取出属性值，attributes.getValue(NAME)，同时赋予river对象中，同时添加为导航到的river标签添加一个boolean为真的标识，用来说明导航到了river元素。

4、当然有river标签内还有子标签（节点），但是SAX解析器是不知道导航到什么标签的，它只懂得开始，结束而已。那么如何让它认得我们的各个标签呢？当然需要判断了，于是可以使用回调方法startElement中的参数String localName，把我们的标签字符串与这个参数比较下，就可以了。我们还必须让SAX知道，现在导航到的是某个标签，因此添加一个true属性让SAX解析器知道。因此

5、它还会导航到文本内标签，（就是<img></img>里面的内容），回调方法characters，我们一般在这个方法中取出就是<img></img>里面的内容，并保存。

6、当然它是一定会导航到结束标签</river> 或者</rivers>的，如果是</river>标签，记得把river对象添加进list中。如果是river中的子标签</introduction>，就把前面设置标记导航到这个标签的boolean标记设置为false.

按照以上实现思路，可以实现如下代码：

1. /**导航到开始标签触发**/
   
2.         public void startElement (String uri, String localName, String qName, Attributes attributes){
   
3.          String tagName=localName.length()!=0?localName:qName;
   
4.          tagName=tagName.toLowerCase().trim();
   
5.          //如果读取的是river标签开始，则实例化River
   
6.          if(tagName.equals(RIVER)){
   
7.              isRiver=true;
   
8.              river=new River();
   
9.                 /**导航到river开始节点后**/
   
10.                 river.setName(attributes.getValue(NAME));
    
11.                 river.setLength(Integer.parseInt(attributes.getValue(LENGTH)));
    
12.          }
    
13.          //然后读取其他节点
    
14.           if(isRiver){
    
15.               if(tagName.equals(INTRODUCTION)){
    
16.                  xintroduction=true;
    
17.              }else if(tagName.equals(IMAGEURL)){
    
18.                  ximageurl=true;
    
19.              }
    
20.          }
    
21.         }
    
22.         
    
23.         /**导航到结束标签触发**/
    
24.         public void endElement (String uri, String localName, String qName){
    
25.          String tagName=localName.length()!=0?localName:qName;
    
26.          tagName=tagName.toLowerCase().trim();
    
27.          
    
28.         //如果读取的是river标签结束，则把River添加进集合中
    
29.          if(tagName.equals(RIVER)){
    
30.              isRiver=true;
    
31.              rivers.add(river);
    
32.          }
    
33.          //然后读取其他节点
    
34.           if(isRiver){
    
35.               if(tagName.equals(INTRODUCTION)){
    
36.                  xintroduction=false;
    
37.              }else if(tagName.equals(IMAGEURL)){
    
38.                  ximageurl=false;
    
39.              }
    
40.           }
    
41.         }
    
42.         
    
43.         //这里是读取到节点内容时候回调
    
44.         public void characters (char[] ch, int start, int length){
    
45.             //设置属性值
    
46.                 if(xintroduction){
    
47.                      //解决null问题
    
48.                      river.setIntroduction(river.getIntroduction()==null?"":river.getIntroduction()+new String(ch,start,length));
    
49.                  }else if(ximageurl){
    
50.                      //解决null问题
    
51.                      river.setImageurl(river.getImageurl()==null?"":river.getImageurl()+new String(ch,start,length));
    
52.                  }
    
53.         }

三、PULL方式

       使用SAX方式解析xml文档是基于事件驱动的。当然android的事件机制是基于回调函数的。也可以用另外一种方式解析xml文档，这种方式也是基于事件驱动的，与SAX方式一样，它就是PULL方式。只不过PULL方式读xml回调方法返回的是数字。

   读取到xml的声明返回      START_DOCUMENT;
   读取到xml的结束返回       END_DOCUMENT ;
   读取到xml的开始标签返回 START_TAG
   读取到xml的结束标签返回 END_TAG
   读取到xml的文本返回       TEXT 

       xml数据结果还是采用我们先前使用的river.xml文件。采用PULL方式与SAX大同小异，重点在于我们需要知道导航到什么标签时候做什么就行了，依据SAX处理方式的思路，我们也可以一样处理，基本方法是：当PULL解析器导航到文档开始标签时就开始实例化list集合用来存贮数据对象。导航到元素开始标签时回判断元素标签类型，如果是river标签，则需要实例化River对象了，如果是其他类型，则取得该标签内容并赋予River对象。当然它也会导航到文本标签，不过在这里，可以不用。

 根据以上的解释，可以得出以下处理xml文档逻辑：

1、当导航到XmlPullParser.START_DOCUMENT，可以不做处理，当然你可以实例化集合对象等等。

2、当导航到XmlPullParser.START_TAG，则判断是否是river标签，如果是，则实例化river对象，并调用getAttributeValue方法获取标签中属性值。

3、当导航到其他标签，比如Introduction时候，则判断river对象是否为空，如不为空，则取出Introduction中的内容，nextText方法来获取文本节点内容

4、当然啦，它一定会导航到XmlPullParser.END_TAG的，有开始就要有结束嘛。在这里我们就需要判读是否是river结束标签，如果是，则把river对象存进list集合中了，并设置river对象为null.

        由以上的处理逻辑，可以得出以下代码：

1. public List<River> parse(String xmlPath){
   
2.         List<River> rivers=new ArrayList<River>();
   
3.         River river=null;
   
4.         InputStream inputStream=null;
   
5.         //获得XmlPullParser解析器
   
6.         XmlPullParser xmlParser = Xml.newPullParser();
   
7.         try {
   
8.             //得到文件流，并设置编码方式
   
9.             inputStream=this.context.getResources().getAssets().open(xmlPath);
   
10.             xmlParser.setInput(inputStream, "utf-8");
    
11.             //获得解析到的事件类别，这里有开始文档，结束文档，开始标签，结束标签，文本等等事件。
    
12.             int evtType=xmlParser.getEventType();
    
13.          //一直循环，直到文档结束
    
14.          while(evtType!=XmlPullParser.END_DOCUMENT){
    
15.             switch(evtType){
    
16.             case XmlPullParser.START_TAG:
    
17.                 String tag = xmlParser.getName();
    
18.                 //如果是river标签开始，则说明需要实例化对象了
    
19.                 if (tag.equalsIgnoreCase(RIVER)) {
    
20.                    river = new River();
    
21.                   //取出river标签中的一些属性值
    
22.                   river.setName(xmlParser.getAttributeValue(null, NAME));
    
23.                   river.setLength(Integer.parseInt(xmlParser.getAttributeValue(null, LENGTH)));
    
24.                 }else if(river!=null){
    
25.                     //如果遇到introduction标签，则读取它内容
    
26.                     if(tag.equalsIgnoreCase(INTRODUCTION)){
    
27.                     river.setIntroduction(xmlParser.nextText());
    
28.                     }else if(tag.equalsIgnoreCase(IMAGEURL)){
    
29.                         river.setImageurl(xmlParser.nextText());
    
30.                     }
    
31.                 }
    
32.                 break;
    
33.                 
    
34.            case XmlPullParser.END_TAG:
    
35.              //如果遇到river标签结束，则把river对象添加进集合中
    
36.                if (xmlParser.getName().equalsIgnoreCase(RIVER) && river != null) {
    
37.                    rivers.add(river);
    
38.                    river = null;
    
39.                }
    
40.                 break;
    
41.                 default:break;
    
42.             }
    
43.             //如果xml没有结束，则导航到下一个river节点
    
44.             evtType=xmlParser.next();
    
45.          }
    
46.         } catch (XmlPullParserException e) {
    
47.             // TODO Auto-generated catch block
    
48.             e.printStackTrace();
    
49.         }catch (IOException e1) {
    
50.             // TODO Auto-generated catch block
    
51.             e1.printStackTrace();
    
52.         }
    
53.         return rivers;
    
54.     }