Android--解析XML之PULL

前言

　　在上一篇博客已经介绍了Android解析XML的几种方式，分别有：SAX、DOM、PULL。详细的可以看看上一篇博客：http://www.cnblogs.com/plokmju/p/android_XMLForSAX.html。这篇博客就介绍一下PULL解析XML。

　　XMLPULL的一些特点：

• 简单的接口：XMLPULL由一个接口（XmlPullParser）、一个例外（XmlPullParserException）、一个工厂（XmlPullParserFactory）来创建。
• 易用性：只有一个关键的next()方法，用于检索下一事件。
• 易扩展：使用通用的接口，并允许多个实现功能，具有更好的扩展性。
• 性能：XMLPULL被设计为允许执行速度非常快的XML解析器。
• 内存要求低：XMLPULL被设计为兼容J2ME，在小型设备上，解析XML时占用非常小的内存。

关键方法next()

　　对于XMLPULL，只有一个关键的next()方法需要了解一下，它是用于检索下一个事件，并有五个事件，这五个分别是：

• START_DOCUMENT：文档的开始，解析器尚未读取任何输入。
• START_TAG：开始标签的解析。
• TEXT：标签内元素的内容解析。
• END_TAG：结束标签的解析。
• END_DOCUMENT：文档的结束。

　　虽然说关键方法只有一个用于检索下一事件的方法next()，但是还存在一些方法也可以检索下一事件，用于不同的情况下使用，如：nextText():用于检索下一元素的文本；nextTag()：用于检索下一元素的标签。

XMLPULL的简单步骤

• 需要建立一个XMLPULL解析器对象。通过XmlPullParserFactory对象得到解析器对象XmlPullParser。
• 再使用XmlPullParser.setInput()方法设置解析器的输入。
• 之后再通过判断事件类型，循环调用next()方法获得解析的数据。

　　对于XmlPullParserFactory类，没有提供公开的构造方法（单例模式），必须使用它的静态方法newInstance()来获得对象实例。获得XmlPullParser必须使用XmlPullParserFactory.newPullParser()获得。

示例

　　现在通过一个示例程序来讲解一下XMLPULL的使用。

　　这是一个Android应用程序，需要增加访问网络的权限，解析IIS服务器上的一个静态的.XML文件。布局界面也比较简单，就是一个按钮，这里不展示代码了，具体的可以下载代码查看。

　　待解析的XML文件内容：

<?xml version="1.0" encoding="utf-8"?>
<persons>
<person id="">
<name >Jack</name>
<age></age>
</person>
<person id="">
<name>Dick</name>
<age></age>
</person>
</persons>

　　IIS服务器上的XML文件，使用的HTTPURLConnection的方式获得，具体参见另外一篇博客：http://www.cnblogs.com/plokmju/p/java-HTTP.html。这里就再重复给出。

　　新建一个Person类，用于存放通过XML解析之后的数据，只有三个字段id、name、age并提供对于的get()set()方法，还有toString()方法，这里不展示代码了。

　　以下是PullXML的解析类：

 package cn.bgxt.parser;

 import java.io.IOException;
 import java.io.InputStream;
 import java.util.ArrayList;
 import java.util.List;

 import org.xmlpull.v1.XmlPullParser;
 import org.xmlpull.v1.XmlPullParserException;
 import org.xmlpull.v1.XmlPullParserFactory;

 import cn.pull.domain.Person;

 public class PullXMLTools {

     public PullXMLTools() {
         // TODO Auto-generated constructor stub
     }

     /**
      * 把服务器传递过的XML流数据解析成对象
      * @param inputStream  XML流
      * @param encode  编码格式
      * @return
      */
     public static List<Person> parserXML(InputStream inputStream, String encode)
             throws XmlPullParserException, IOException {
         List<Person> list = null;
         Person person = null;
         //获得一个XMLPULL工厂类的实例
         XmlPullParserFactory factory = XmlPullParserFactory.newInstance();
         //获得一个XML解析器的实例
         XmlPullParser parser = factory.newPullParser();
         //设置解析器的输入，使用inputStream流式数据。
         parser.setInput(inputStream, encode);
         //判断当前的事件类型
         int eventType = parser.getEventType();
         //循环读取，知道事件类型为文档结束
         while (eventType != XmlPullParser.END_DOCUMENT) {
             switch (eventType) {
             // 通过判断事件类型来选择执行不同的代码
             case XmlPullParser.START_DOCUMENT:
                 //文档开始的时候，实例化list对象，用于存放XML解析后的数据
                 list=new ArrayList<Person>();
                 break;
             case XmlPullParser.START_TAG:
                 //读取标签的时候触发这个事件
                 if(parser.getName().equals("person"))
                 {
                     //如果当前读取到的节点是person节点，那么实例化一个person对象。
                     person=new Person();
                     //获得person节点中的属性ID
                     int id=Integer.parseInt(parser.getAttributeValue(0));
                     person.setId(id);
                 }
                 else if(parser.getName().equals("name"))
                 {
                     if(person!=null)
                     {
                         //获得name节点的下一个element Text
                         String name=parser.nextText();
                         person.setName(name);
                     }
                 }
                 else if(parser.getName().equals("age"))
                 {
                     if(person!=null)
                     {
                         //获得age节点的下一个element Text
                         int age=Integer.parseInt(parser.nextText());
                         person.setAge(age);
                     }
                 }
                 break;
             case XmlPullParser.END_TAG:
                 if(parser.getName().equals("person"))
                 {
                     //读到结束节点标签，如果为person，则把之前读取到的person对象加入list中，
                     //并且制空person对象。
                     list.add(person);
                     person=null;
                 }
                 break;
             }
             //读取
             eventType=parser.next();
         }
         return list;
     }

 }

　　Activity中的代码，需要实现一个按钮的点击事件，因为是在Android4.0+的环境下，需要使用多线程访问网络。

 package cn.bgxt.xmlforpull;

 import java.io.InputStream;
 import java.util.List;
 import cn.bgxt.Http.HttpUtils;
 import cn.bgxt.parser.PullXMLTools;
 import cn.pull.domain.Person;
 import android.os.Bundle;
 import android.app.Activity;
 import android.view.Menu;
 import android.view.View;
 import android.widget.Button;

 public class MainActivity extends Activity {

     private Button btn;

     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.activity_main);

         btn=(Button)findViewById(R.id.btn);

         btn.setOnClickListener(new View.OnClickListener() {

             @Override
             public void onClick(View v) {
                 // TODO Auto-generated method stub
                 Thread thread=new Thread(new Runnable() {
                     @Override
                     public void run() {
                         String path="http://192.168.1.107:1231/persons.xml";
                         InputStream inputStream=HttpUtils.getXML(path);
                         List<Person> list=null;
                         try {
                             list = PullXMLTools.parserXML(inputStream, "utf-8");
                             for(Person person:list)
                             {
                                 System.out.println(person.toString());
                             }
                         } catch (Exception e) {
                             // TODO: handle exception
                         }

                     }
                 });
                 thread.start();
             }
         });
     }

 }

　　在设备上运行程序，如果读取成功，可以在LogCat中查看到输出内容。

　　提供一下示例程序的源码，有需要的朋友可以下载观看：http://download.csdn.net/detail/plokmju88/5640375

总结

　　现在已经说了两种在Android平台下解析XML的方式，分别是SAX和PULL，这两种方式都适用于Android平台，因为都是以流的形式访问数据，消耗的硬件资源小，速度快，但是也存在不同的适用环境。如果清楚的知道XML文档的结构，每一级节点的名称，那么使用PULL方式可以简化开发，但是如果不确定XML文档的结构，那还是使用SAX的方式比较妥当，无需关心各节点的名称。

　　请支持原创，尊重原创，转载请注明出处。谢谢。