Android解析XML三种方式（PULL、SAX、DOM）

本篇博客重点介绍Android中三种解析XML的方式，包括PULL、SAX、DOM，当然不止这些，还可以用第三方的jar包提供的解析，只是这三种在Android中比较常用吧。再顺便介绍一下AndroidTestCase的用法，用来测试所写的解析业务逻辑是否正确。

本篇博客使用的xml文件如下：

student.xml

<?xml version="1.0" encoding="UTF-8"?>  
<students>  
    <student id="1003">  
        <name>ZhangSan</name>  
        <age>23</age>
        <score>89</score>  
    </student>
    <student id="1004">  
        <name>LiSi</name>  
        <age>24</age>
        <score>72</score>  
    </student>
    <student id="1005">  
        <name>WangWu</name>  
        <age>25</age>
        <score>79</score>  
    </student>
</students>

各字体属性应该很清楚了，这里不再介绍，也不是重点。

此xml文件放在Android工程下面的assets目录下面，等待解析。。。

再建一个类Student.java

package com.and.xml;

public class Student {

	private int id;
	private String name;
	private int age;
	private float score;

	public Student() {
		super();
	}

	public Student(int id, String name, int age, float score) {
		super();
		this.id = id;
		this.name = name;
		this.age = age;
		this.score = score;
	}

	public int getId() {
		return id;
	}

	public void setId(int id) {
		this.id = id;
	}

	public String getName() {
		return name;
	}

	public void setName(String name) {
		this.name = name;
	}

	public int getAge() {
		return age;
	}

	public void setAge(int age) {
		this.age = age;
	}

	public float getScore() {
		return score;
	}

	public void setScore(float score) {
		this.score = score;
	}

	@Override
	public String toString() {
		// TODO Auto-generated method stub
		return "Id:" + this.id + ",Name:" + this.name + ",Age" + this.age
				+ ",Score:" + this.score;
	}
}

下面分别介绍三种解析方式。

第一种：PULL解析

PullParseService

package com.and.xml;

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

import org.xmlpull.v1.XmlPullParser;
import org.xmlpull.v1.XmlPullParserFactory;
/**
 * PULL解析示例
 * @author Administrator
 *
 */
public class PullParseService {
	public static List<Student> getStudents(InputStream input) throws Exception {
		List<Student> data = null;
		Student stu = null;

		XmlPullParserFactory fac = XmlPullParserFactory.newInstance();
		fac.setNamespaceAware(true);
		XmlPullParser parser = fac.newPullParser();
		parser.setInput(input, "UTF-8");
		int eventType = parser.getEventType();
		while (eventType != XmlPullParser.END_DOCUMENT) {
			switch (eventType) {
			case XmlPullParser.START_DOCUMENT:
				System.out.println("START_DOCUMENT");
				data = new ArrayList<Student>();
				break;
			case XmlPullParser.START_TAG:
				if ("student".equals(parser.getName())) {
					stu = new Student();
					stu.setId(Integer.parseInt(parser.getAttributeValue(0)));
				}
				if (stu != null) {
					if ("name".equals(parser.getName())) {
						stu.setName(parser.nextText());
					} else if ("age".equals(parser.getName())) {
						stu.setAge(Integer.parseInt(parser.nextText()));
					} else if ("score".equals(parser.getName())) {
						stu.setScore(Float.parseFloat(parser.nextText()));
					}
				}
				break;
			case XmlPullParser.END_TAG:
				if ("student".equals(parser.getName())) {
					if (data != null && stu != null) {
						data.add(stu);
						stu = null;
					}
				}
				break;
			}
			eventType = parser.next();// 注意：此处勿要写成parser.next();不要理解成指针
		}

		return data;
	}
}

至此，PULL解析的核心业务完成了，怎样来测试有没有问题呢？一般情况下，都是在Activity输出调试日志，根据调试日志判断是否解析成功。这里换一种方式，用Android的测试用例来测试一下。

TestParseService.java

package com.and.test;

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

import javax.xml.parsers.SAXParserFactory;

import org.xml.sax.InputSource;
import org.xml.sax.XMLReader;

import com.and.xml.DomParseService;
import com.and.xml.PullParseService;
import com.and.xml.SaxParserService;
import com.and.xml.Student;

import android.test.AndroidTestCase;
import android.util.Log;

/**
 * 测试三种解析方式（Pull、SAX、Dom）
 * 
 * @author And 2012-02-29
 */
public class TestParseService extends AndroidTestCase {
	private static final String TAG = "testService";
	InputStream input;
	List<Student> students;

	public void init() throws Exception {
		input = this.getContext().getAssets().open("students.xml");
	}

	// 测试Pull解析方式
	public void testPull() throws Exception {
		init();
		students = PullParseService.getStudents(input);
		for (Student stu : students) {
			Log.i(TAG, stu.toString());
		}
	}

	// 测试SAX解析方式
	public void testSAX() throws Exception {
		init();
		SAXParserFactory fac = SAXParserFactory.newInstance();
		XMLReader reader = fac.newSAXParser().getXMLReader();
		SaxParserService saxHandler = new SaxParserService();
		reader.setContentHandler(saxHandler);
		reader.parse(new InputSource(input));
		students = saxHandler.getParseData();
		for (Student stu : students) {
			Log.i(TAG, stu.toString());
		}
	}

	// 测试DOM解析方式
	public void testDom() throws Exception {
		init();
		students = DomParseService.getPersonsByParseXml(input);
		for (Student stu : students) {
			Log.i(TAG, stu.toString());
		}
	}

}

注意一定要继承自 AndroidTestCase这个类。这个文件中写了所有三种解析的测试方法，其它的忽视吧，只看testPull方法，它是用来测试上面所写的PULL解析业务的 。

那么怎样测试呢？

鼠标选中testPull方法名——>右键——>Run As——>Anroid JUnit Test

会提示以下错误：

大概意思就是没有配置running tests.控制台输出：

XmlParseDemo does not specify a android.test.InstrumentationTestRunner instrumentation or does not declare uses-library android.test.runner in its AndroidManifest.xml

从上面的提示信息可知，需要在AndroidManifest.xml中作一些配置，包括instrumentation和uses-library的配置

在AndroidManifest.xml文件中添加如下两行

<instrumentation android:name="android.test.InstrumentationTestRunner" android:targetPackage="com.and.pull"></instrumentation>

<uses-library android:name="android.test.runner"/>

注意添加位置：

第一句跟application节点同级。

第二句跟activity同级。

上面介绍的方法是手动代码添加，下面介绍一种图形化的方式，只需要点击鼠标就可以搞定。

打开AndroidManifest.xml文件

点击Add...

这样，use-library就添加好了

同样的方法添加instrumentation属性

注意Target package后面的内容：com.and.xml包

整个工程目录结构如图：

然后查看一下AndroidManifest.xml的内容，已经包含了刚才添加的那两句了：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.and.xml"
    android:versionCode="1"
    android:versionName="1.0" >

    <uses-sdk android:minSdkVersion="7" />
    <instrumentation android:targetPackage="com.and.test" android:name="android.test.InstrumentationTestRunner"></instrumentation>

    <application
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name" >
        <activity
            android:label="@string/app_name"
            android:name="com.and.xml.MainActivity" >
            <intent-filter >
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
        <uses-library android:name="android.test.runner"/>
    </application>

</manifest>

OK，然后继续之前的操作“鼠标选中testPull方法名——>右键——>Run As——>Anroid JUnit Test”

如果出现类似这样的页面，就表示测试用例建立成功，并且测试方法通过

左上角的绿色条，表示测试方法通过，右下角的调试日志输出，通过判断可以知道解析成功。

第二种：SAX解析

SaxParserService.java

package com.and.xml;

import java.util.ArrayList;
import java.util.List;

import org.xml.sax.Attributes;
import org.xml.sax.SAXException;
import org.xml.sax.helpers.DefaultHandler;

/**
 * SAX解析示例
 * 
 * @author Administrator
 * 
 */
public class SaxParserService extends DefaultHandler {

	List<Student> data = null;
	Student stu = null;
	String tag = "";

	@Override
	public void characters(char[] ch, int start, int length) throws SAXException {
		super.characters(ch, start, length);
		if (stu != null) {
			String str = new String(ch, start, length);
			if (tag.equals("name")) {
				stu.setName(str);
			} else if (tag.equals("age")) {
				stu.setAge(Integer.parseInt(str));
			} else if (tag.equals("score")) {
				stu.setScore(Float.parseFloat(str));
			}
		}
	}

	@Override
	public void endDocument() throws SAXException {
		super.endDocument();
	}

	@Override
	public void endElement(String uri, String localName, String qName)
			throws SAXException {
		super.endElement(uri, localName, qName);
		if (localName.equals("student") && stu != null) {
			data.add(stu);
			stu = null;
		}
		tag = "";
	}

	@Override
	public void startDocument() throws SAXException {
		super.startDocument();
		data = new ArrayList<Student>();
	}

	@Override
	public void startElement(String uri, String localName, String qName,
			Attributes attributes) throws SAXException {
		super.startElement(uri, localName, qName, attributes);
		tag = localName;
		if (localName.equals("student")) {
			stu = new Student();
		}
		if (attributes.getValue(0) != null) {
			stu.setId(Integer.parseInt(attributes.getValue(0)));
		}
	}

	public List<Student> getParseData() {
		return data;
	}

}

注意一定要继承自DefaultHandler，然复写里面的方法，这些方法名字根据字面意思很容易理解它的作用。

然后通过上面的的测试文件，按照类似的方法测试一下testSAX()方法，如果出现绿条和日志输出的话，表明解析业务逻辑成功。

第三种：DOM解析

DomParseService.java

package com.and.xml;

import java.io.InputStream;
import java.util.ArrayList;
import java.util.List;
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import org.w3c.dom.Document;
import org.w3c.dom.Element;
import org.w3c.dom.Node;
import org.w3c.dom.NodeList;

/**
 * DOM解析示例
 */
/**
 * DOM解析器在解析XML文档时，会把文档中的所有元素，按照其出现的层次关系，解析成一个个Node对象(节点)。Node对象提供了一系列常量来代表结点的类型
 * ，当开发人员获得某个Node类型后，就可以把Node节点转换成相应节点对象(Node的子类对象)，以便于调用其特有的方法。
 * Node对象提供了相应的方法去获得它的父结点或子结点。编程人员通过这些方法就可以读取整个XML文档的内容、或添加、修改、删除XML文档的内容.
 * 
 * 缺点： 一次性的完全加载整个xml文件，需要消耗大量的内存。
 */
public class DomParseService {

	public static List<Student> getPersonsByParseXml(InputStream is) throws Exception {
		List<Student> persons = new ArrayList<Student>();
		DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
		try {
			DocumentBuilder builder = factory.newDocumentBuilder();
			Document document = builder.parse(is);
			Element root = document.getDocumentElement();
			NodeList items = root.getElementsByTagName("student");// 得到所有person节点
			for (int i = 0; i < items.getLength(); i++) {
				Student Student = new Student();
				Element personNode = (Element) items.item(i);
				Student.setId(new Integer(personNode.getAttribute("id")));
				// 获取person节点下的所有子节点(标签之间的空白节点和name/age元素)
				NodeList childsNodes = personNode.getChildNodes();
				for (int j = 0; j < childsNodes.getLength(); j++) {
					Node node = (Node) childsNodes.item(j); // 判断是否为元素类型
					if (node.getNodeType() == Node.ELEMENT_NODE) {
						Element childNode = (Element) node;
						// 判断是否name元素
						if ("name".equals(childNode.getNodeName())) {
							// 获取name元素下Text节点,然后从Text节点获取数据
							Student.setName(childNode.getFirstChild().getNodeValue());
						} else if ("age".equals(childNode.getNodeName())) {
							Student.setAge(new Short(childNode.getFirstChild().getNodeValue()));
						} else if ("score".equals(childNode.getNodeName())) {
							Student.setScore(Float.parseFloat(childNode.getFirstChild().getNodeValue()));
						}
					}
				}
				persons.add(Student);
			}
			is.close();
		} catch (Exception e) {
			e.printStackTrace();
		}
		return persons;
	}
}

类似的测试方法。。。

至此，三种解析方式全部完成了，如果分别测试这三种方法的时候，一路绿条的话，那么恭喜，解析业务逻辑成功。否则，可能还有哪里有问题，请仔细检查。

对比这三种解析方式，我个人认为PULL和SAX解析方式类似，都是事件触发型的，就是当解析到某个节点的时候触发相应的事件。说明一下DOM解析，会把文档中的所有元素，按照其出现的层次关系，解析成一个个Node对象(节点)，可见它会有点占内存，但是如果待解析的xml文件相对较小的话，使用DOM解析 优点还是很明确的。