Android 使用SAX或者DOM或者pull解析XML文件

在Android平台上可以使用Simple API for XML(SAX) 、 Document Object Model(DOM)和Android附带的pull解析器解析XML文件。 下面是本例子要解析的XML文件：

文件名称：chao.xml

<?xml version="1.0" encoding="UTF-8"?>
<persons>
	<person id=“18">
		<name>allen</name>
		<age>36</age>
	</person>
	<person id=“28">
		<name>james</name>
		<age>25</age>
	</person>
</persons>

例子定义了一个javabean用于存放上面解析出来的xml内容， 这个javabean为Person：

public class Person {
	private Integer id;
	private String name;
	private Short age;
	
	public Integer getId() {
		return id;
	}
	public void setId(Integer id) {
		this.id = id;
	}
	public String getName() {
		return name;
	}
	public void setName(String name) {
		this.name = name;
	}
	public Short getAge() {
		return age;
	}
	public void setAge(Short age) {
		this.age = age;
	}	
}

使用SAX读取XML文件：

SAX是一个解析速度快并且占用内存少的xml解析器，非常适合用于Android等移动设备。 SAX解析XML文件采用的是事件驱动，也就是说，它并不需要解析完整个文档，在按内容顺序解析文档的过程中，SAX会判断当前读到的字符是否合法XML语法中的某部分，如果符合就会触发事件。所谓事件，其实就是一些回调（callback）方法，这些方法(事件)定义在ContentHandler接口。下面是一些ContentHandler接口常用的方法：
startDocument()
当遇到文档的开头的时候，调用这个方法，可以在其中做一些预处理的工作。
endDocument()
和上面的方法相对应，当文档结束的时候，调用这个方法，可以在其中做一些善后的工作。 
startElement(String namespaceURI, String localName, String qName, Attributes atts) 
当读到一个开始标签的时候，会触发这个方法。namespaceURI就是命名空间，localName是不带命名空间前缀的标签名，qName是带命名空间前缀的标签名。通过atts可以得到所有的属性名和相应的值。要注意的是SAX中一个重要的特点就是它的流式处理，当遇到一个标签的时候，它并不会纪录下以前所碰到的标签，也就是说，在startElement()方法中，所有你所知道的信息，就是标签的名字和属性，至于标签的嵌套结构，上层标签的名字，是否有子元属等等其它与结构相关的信息，都是不得而知的，都需要你的程序来完成。这使得SAX在编程处理上没有DOM来得那么方便。
endElement(String uri, String localName, String name)
这个方法和上面的方法相对应，在遇到结束标签的时候，调用这个方法。
characters(char[] ch, int start, int length) 
这个方法用来处理在XML文件中读到的内容，第一个参数为文件的字符串内容，后面两个参数是读到的字符串在这个数组中的起始位置和长度，使用new String(ch,start,length)就可以获取内容。

使用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;
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;

import cn.itcast.xml.domain.Person;
/**
 * 使用Dom解析xml文件
 *
 */
public class DomXMLReader {

public static List<Person> readXML(InputStream inStream) {
	List<Person> persons = new ArrayList<Person>();
	DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
	try {
		DocumentBuilder builder = factory.newDocumentBuilder();
		Document dom = builder.parse(inStream);
		Element root = dom.getDocumentElement();
		NodeList items = root.getElementsByTagName("person");//查找所有person节点
		for (int i = 0; i < items.getLength(); i++) {
			Person person = new Person();
			//得到第一个person节点
			Element personNode = (Element) items.item(i);
			//获取person节点的id属性值
			person.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节点获取数据	    			     				person.setName(childNode.getFirstChild().getNodeValue());
			    } else if (“age”.equals(childNode.getNodeName())) {
			person.setAge(new Short(childNode.getFirstChild().getNodeValue()));
			    }
			}
		        }
		    persons.add(person);
		}
		inStream.close();
	} catch (Exception e) {
		e.printStackTrace();
	}
	return persons;
}

使用Pull解析器读取XML文件：

除了可以使用 SAX或DOM解析XML文件之外，大家也可以使用Android内置的Pull解析器解析XML文件。 Pull解析器是一个开源的java项目，既可以用于android，也可以用于JavaEE。如果用在javaEE需要把其jar文件放入类路径中，因为Android已经集成进了Pull解析器，所以无需添加任何jar文件。android系统本身使用到的各种xml文件，其内部也是采用Pull解析器进行解析的。 Pull解析器的运行方式与 SAX 解析器相似。它提供了类似的事件，如：开始元素和结束元素事件，使用parser.next()可以进入下一个元素并触发相应事件。跟SAX不同的是， Pull解析器产生的事件是一个数字，而非方法，因此可以使用一个switch对感兴趣的事件进行处理。当元素开始解析时，调用parser.nextText()方法可以获取下一个Text类型节点的值。


Pull解析器的源码及文档下载网址：http://www.xmlpull.org/

使用Pull解析器生成XML文件：

有些时候，我们需要生成一个XML文件，生成XML文件的方法有很多，如：可以只使用一个StringBuilder组拼XML内容，然后把内容写入到文件中；或者使用DOM API生成XML文件，或者也可以使用pull解析器生成XML文件，这里推荐大家使用Pull解析器。

使用代码如下（生成XML文件）：
File xmlFile = new File("myitcast.xml");
FileOutputStream outStream = new FileOutputStream(xmlFile);
OutputStreamWriter outStreamWriter = new OutputStreamWriter(outStream, "UTF-8");
BufferedWriter writer = new BufferedWriter(outStreamWriter);
writeXML(persons, writer);
writer.flush();
writer.close();
如果只想得到生成的xml字符串内容，可以使用StringWriter：
StringWriter writer = new StringWriter();
writeXML(persons, writer);
String content = writer.toString();

使用Pull解析器读取XML文件，生成XML文件代码示例：

MainActivity.java：

package com.example.xml;

import java.util.List;

import com.example.domain.Person;
import com.example.service.PersonService;

import android.os.Bundle;
import android.app.Activity;
import android.view.Menu;
import android.widget.TextView;

public class MainActivity extends Activity {

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_main);
		
		TextView tv = (TextView) this.findViewById(R.id.tv);
		PersonService ps =new PersonService(this);
		List<Person> persons = ps.getPersons("person.xml");
		StringBuffer sb = new StringBuffer();
		for(Person person:persons){
			String age = "age" + person.getAge();
			String name = "name" + person.getName();
			String id = "id" + person.getId();
			sb.append(name+" "+age+" "+id);
		}
		tv.setText(sb.toString());
	}

	@Override
	public boolean onCreateOptionsMenu(Menu menu) {
		// Inflate the menu; this adds items to the action bar if it is present.
		getMenuInflater().inflate(R.menu.main, menu);
		return true;
	}
}

PersonService.java:

package com.example.service;

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

import org.xmlpull.v1.XmlPullParser;
import org.xmlpull.v1.XmlSerializer;

import com.example.domain.Person;

import android.content.Context;
import android.content.res.AssetManager;
import android.os.Environment;
import android.util.Xml;
import android.widget.Toast;

public class PersonService {
	private Context context;

	public PersonService(Context context) {
		this.context = context;
	}

	/**
	 * 把person.xml的输入流 解析 转化成list集合
	 * 
	 * @param filename
	 *            assets目录下的文件名
	 * @return
	 */
	public List<Person> getPersons(String filename) {
		AssetManager manager = context.getAssets();
		try {
			InputStream is = manager.open(filename);
			// 在android下使用pull解析xml文件
			// 1.获取pull解析器的实例
			XmlPullParser parser = Xml.newPullParser();
			// 2.设置解析器的一些参数
			parser.setInput(is, "utf-8");
			// 获取pull解析器对应的事件类型
			int type = parser.getEventType();
			Person person = null;
			List<Person> persons = new ArrayList<Person>();
			while (type != XmlPullParser.END_DOCUMENT) {
				if (type == XmlPullParser.START_TAG) {
					if ("person".equals(parser.getName())) {
						person = new Person();
						int id = Integer.parseInt(parser.getAttributeValue(0));
						person.setId(id);
					} else if ("name".equals(parser.getName())) {
						String name = parser.nextText();
						person.setName(name);
					} else if ("age".equals(parser.getName())) {
						int age = Integer.parseInt(parser.nextText());
						person.setAge(age);
					}
				}
				if (type == XmlPullParser.END_TAG) {
					if ("person".equals(parser.getName())) {
						persons.add(person);
						person = null;
					}
				}
				type = parser.next();
			}

			return persons;
		} catch (Exception e) {
			e.printStackTrace();
			Toast.makeText(context, "获取person.xml失败", Toast.LENGTH_SHORT)
					.show();
			return null;
		}
	}

	/**
	 * 把persons集合里面的内容写到xml文件里面
	 * 
	 * @param persons
	 *            person的集合
	 * @return
	 */
	public boolean savePersonToXml(List<Person> persons) {
		try {
			XmlSerializer serializer = Xml.newSerializer();
			// /sdcard/person.xml
			// mount unmount 文件系统的权限
			File file = new File(Environment.getExternalStorageDirectory(),
					"person.xml");
			FileOutputStream fos = new FileOutputStream(file);
			serializer.setOutput(fos, "utf-8");
			serializer.startDocument("utf-8", true);
			serializer.startTag(null, "persons");
			for (Person person : persons) {
				serializer.startTag(null, "person");

				serializer.attribute(null, "id", person.getId() + "");

				serializer.startTag(null, "name");
				serializer.text(person.getName());
				serializer.endTag(null, "name");

				serializer.startTag(null, "age");
				serializer.text(person.getAge() + "");
				serializer.endTag(null, "age");

				serializer.endTag(null, "person");
			}
			serializer.endTag(null, "persons");
			serializer.endDocument();
			fos.flush();
			fos.close();
			return true;
		} catch (Exception e) {
			e.printStackTrace();
			return false;
		}
	}
}

Person.java:

package com.example.domain;

public class Person {

	private int age;
	private int id;
	private String name;

	public int getAge() {
		return age;
	}

	public void setAge(int age) {
		if (age > 0 && age <= 100) {
			this.age = age;
		} else {
			this.age = 0;
		}
	}

	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;
	}
}

person.xml文件（在asserts目录下存放）：

<?xml version='1.0' encoding='utf-8'?>
<persons>
	<person id="18">
		<name>allen</name>
		<age>16</age>
	</person>
		<person id="28">
		<name>bing</name>
		<age>21</age>
	</person>
</persons>