android学习——使用SAX、DOM 和 PULL 解析xml文件,及使用pull生成xml文件

sax

DefaultHandler 实现了 Handler接口，使用 sax解析时，只需要继承下

package com.hujl.parserxml.service;

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

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

import com.hujl.parserxml.entity.Person;

public class SAXPersonHandler extends DefaultHandler {
	
	private List<Person> persons;
	private String nodeName=null;
	private Person person;
	
	public List<Person> getPersons(){
		return persons;
	}
	
	
	@Override
	public void startDocument() throws SAXException {
		persons=new ArrayList<Person>();
	}
	
	@Override
	public void startElement(String uri, String localName, String qName,
			Attributes attributes) throws SAXException {
		if("person".equals(localName)){
			person=new Person();
			person.setId(Integer.valueOf(attributes.getValue(0)));			
		}
		nodeName=localName;
	}
	
	@Override
	public void characters(char[] ch, int start, int length)
			throws SAXException {
		if(nodeName!=null){
			String data=new String(ch, start, length);
			if("name".equals(nodeName)){
				person.setName(data);
			}else if("age".equals(nodeName)){
				person.setAge(new Short(data));
			}
		}
	}

	@Override
	public void endElement(String uri, String localName, String qName)
			throws SAXException {
		if("person".equals(localName)){
			persons.add(person);
			person=null;
		}
		nodeName=null;
	}
	
}

package com.hujl.parserxml.service;

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

import javax.xml.parsers.SAXParser;
import javax.xml.parsers.SAXParserFactory;


import com.hujl.parserxml.entity.Person;

/**
 * 用SAX来解析XML文件
 * @author Administrator
 * @website http://hujl.sinaapp.com
 */
public class SAXParserService{
	
	/**
	 * 得到解析后的集合
	 * @param is 输入流
	 * @return
	 * @throws Exception
	 */
	public static List<Person> getPersons(InputStream is) throws Exception{
		SAXParserFactory factory=SAXParserFactory.newInstance();
		//得到解析器
		SAXParser saxParser=factory.newSAXParser();
		SAXPersonHandler dh=new SAXPersonHandler();
		saxParser.parse(is, dh);
		return dh.getPersons();
	}
}

dom 解析

package com.hujl.parserxml.service;

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 com.hujl.parserxml.entity.Person;

/**
 * 用DOM解析XML文件
 * @author Administrator
 * @website http://hujl.sinaapp.com
 */
public class DOMParserService {

	/**
	 * 得到解析后的集合
	 * @param is
	 * @return
	 * @throws Exception
	 */
	public static List<Person> getPersons(InputStream is) throws Exception{
		List<Person> persons=new ArrayList<Person>();
		DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
		DocumentBuilder builder = factory.newDocumentBuilder();
		//得到对象树的形式存放到内存中
		Document document=builder.parse(is);
		//getDocumentElement() 这是一种便捷属性，该属性允许直接访问文档的文档元素的子节点
		Element root=document.getDocumentElement();
		//查找所有 person节点
		NodeList nodes=root.getElementsByTagName("person");
		
		for (int i = 0; i < nodes.getLength(); i++) {
			Person person=new Person();
			Element personElement=(Element)nodes.item(i);
			person.setId(new Integer(personElement.getAttribute("id")));
			
			//获取person节点下的所有子节点(标签之间的空白节点和name/age元素)
			NodeList personChilds=personElement.getChildNodes();
			for (int j = 0; j < personChilds.getLength(); j++) {
				//判断是否为元素类型  xml 大致分两种类型 Element 和 Text类型 
				if (personChilds.item(j).getNodeType() == Node.ELEMENT_NODE) {
					Element element = (Element) personChilds.item(j);
					if ("name".equals(element.getNodeName())) {
						person.setName(element.getFirstChild().getNodeValue());
					} else if ("age".equals(element.getNodeName())) {
						person.setAge(new Short(element.getFirstChild()
								.getNodeValue()));
					}
				}
			}
			persons.add(person);
		}
		return persons;
	}
		
}

pull 解析 ， 和是用 pull 输出 xml 文件

package com.hujl.parserxml.service;

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

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


import android.util.Xml;

import com.hujl.parserxml.entity.Person;
/**
 * 是用pull操作xml文件的类
 * @author janrone
 * @website http://hujl.sinaapp.com
 */
public class PullParserService {
	
	/**
	 * 是用pull生成xml
	 * @param persons
	 * @param writer 文件读写器
	 * @throws Exception
	 */
	public static void savePersons(List<Person> persons, Writer writer)throws Exception{
		XmlSerializer serializer=Xml.newSerializer();
		serializer.setOutput(writer);
		 
		serializer.startDocument("UTF-8", true);
		serializer.startTag(null, "persons");
		for(Person person : persons){
			serializer.startTag(null, "person");
			serializer.attribute(null, "id", person.getId().toString());
			
			serializer.startTag(null, "name");
			serializer.text(person.getName());
			serializer.endTag(null, "name");
			
			serializer.startTag(null, "age");
			serializer.text(person.getAge().toString());
			serializer.endTag(null, "age");
			
			serializer.endTag(null, "person");
		}
		serializer.endTag(null, "persons");
		serializer.endDocument();
		writer.flush();
		writer.close();
	}
	
	/**
	 * 使用pull 生成 xml 文件
	 * @param persons
	 * @param outputStream 输入流
	 * @throws Exception
	 */
	public static void savePersons(List<Person> persons,OutputStream outputStream)throws Exception{
		XmlSerializer serializer=Xml.newSerializer();
		serializer.setOutput(outputStream, "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().toString());
			
			serializer.startTag(null, "name");
			serializer.text(person.getName());
			serializer.endTag(null, "name");
			
			serializer.startTag(null, "age");
			serializer.text(person.getAge().toString());
			serializer.endTag(null, "age");
			
			serializer.endTag(null, "person");
		}
		serializer.endTag(null, "persons");
		serializer.endDocument();
		outputStream.close();
	}
	/**
	 * 是用PULL解析xml文件的方法
	 * @param inputStream
	 * @return
	 * @throws Exception
	 */
	public static List<Person> getPersons(InputStream inputStream) throws Exception{
		List<Person> persons=null;
		XmlPullParser pullParser=Xml.newPullParser();
		pullParser.setInput(inputStream, "UTF-8");
		Person person=null;
		
		int eventType=pullParser.getEventType();
		//当eventType不为xml文档结束元素时,则循环
		while(eventType!=XmlPullParser.END_DOCUMENT){
			switch (eventType) {
			case XmlPullParser.START_DOCUMENT:
				persons=new ArrayList<Person>();
				break;
			case XmlPullParser.START_TAG:
				if("person".equals(pullParser.getName())){
					person=new Person();
					person.setId(new Integer(pullParser.getAttributeValue(0)));
				}
				if(person!=null){
					if("name".equals(pullParser.getName())){
						person.setName(pullParser.nextText());
					}else if("age".equals(pullParser.getName())){
						person.setAge(new Short(pullParser.nextText()));
					}
				}
				break;	
				case XmlPullParser.END_TAG:
					if("person".equals(pullParser.getName())){
						persons.add(person);
						person=null;
					}
				break;	
			}
			eventType=pullParser.next(); // 进入下一个元素并触发事件.
		}
		return persons;
	}
}

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)就可以获取内容。

除了可以使用 SAX和DOM解析XML文件，大家也可以使用Android内置的Pull解析器解析XML文件。 Pull解析器的运行方式与 SAX 解析器相似。它提供了类似的事件，如：开始元素和结束元素事件，使用parser.next()可以进入下一个元素并触发相应事件。事件将作为数值代码被发送，因此可以使用一个switch对感兴趣的事件进行处理。当元素开始解析时，调用parser.nextText()方法可以获取下一个Text类型元素的值。


使用Pull解析器读取itcast.xml的代码在本页下方备注
Pull解析器的源码及文档下载网址：http://www.xmlpull.org/


如果在一个XML文档中我们只需要前面一部分数据，但是使用SAX方式或DOM方式会对整个文档进行解析，尽管XML文档中后面的大部分数据我们其实都不需要解析，因此这样实际上就浪费了处理资源。使用PULL方式正合适。
    Pull解析器和SAX解析器虽有区别但也有相似性。他们的区别为：SAX解析器的工作方式是自动将事件推入注册的事件处理器进行处理，因此你不能控制事件的处理主动结束；而Pull解析器的工作方式为允许你的应用程序代码主动从解析器中获取事件，正因为是主动获取事件，因此可以在满足了需要的条件后不再获取事件，结束解析。这是他们主要的区别。
    而他们的相似性在运行方式上，Pull解析器也提供了类似SAX的事件，开始文档START_DOCUMENT和结束文档END_DOCUMENT，开始元素START_TAG和结束元素END_TAG，遇到元素内容TEXT等，但需要调用next() 方法提取它们（主动提取事件）。
因为sax是由reader将所有内容推给你，pull则是在需要的时候将信息从reader拉回来，如果一个节点忽略不处理时，sax引擎后台还是解析,pull则只需要做最简单的tag匹配就可跳过  。