学步园

SAX(Simple API for XML) 是一个解析速度快并且占用内存少的xml解析器，非常适合用于Android等移动设备。 SAX解析XML文件采用的是事件驱动, 顺序读取XML文件，边加载边解析。也就是说，它并不需要解析完整个文档，在按内容顺序解析文档的过程中，SAX会判断当前读到的字符是否合法XML语法中的某部分，如果符合就会触发事件。(如:当遇到像文件开头，文档结束，或者标签开头与标签结束时，会触发一个事件，用户通过在其回调事件中写入处理代码来处理XML文件，适合对XML的顺序访问，且是只读的.)所谓事件，其实就是一些回调（callback）方法，这些方法(事件)定义在ContentHandler接口。在SAX接口中，事件源是org.xml.sax包总的XMLReader，它通过parser()方法来解析XML文档，并产生事件。事件处理器是org.xml.sax包中的ContentHandler,DTDHandler,ErrorHandler,以及EntityResolver这4个接口。它们分别处理事件源在解析XML文档过程中产生的不同种类的事件。

定义的事件处理类在实现该接口时，必须实现4个接口中的所有方法。在开发中不必直接从这4个接口直接继承，因为org.xml.sax.helper包提供了类DefaultHandler，其继承了这4个接口，在实际开发中直接从DefaultHandler继承并实现相关函数就可以了并调用相应的监听器设置方法(setXXXX()来完成与XMLReader事件源的连接)，为了减少工作量，SDK提供了DefaultHandler类(适配器类)来做事件处理，主要的事件的回调方法如下：

各方法详细说明：

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

通过XMLReader及DefaultHandler的配合来解析XML，基本思路如下：

创建SAXParserFactory对象:SAXParserFactory factory = SAXParserFactory.newInstance(); 

创建SAX解析器 :SAXParser parser = factory.newSAXParser();  

实例化一个DefaultHandler对象

将XML解析处理器(DefaultHandler对象)分配给解析器 

对文档进行解析，将每个事件发送给处理器,parser.parse(file, contentHandler); 

通过DefaultHandler返回需要的数据集合

具体代码如下：

domain：

package cn.itcast.domain;

public class Person {
    private Integer id;
    private String name;
    private Short age;
    
    public Person(){}
    
    public Person(Integer id, String name, Short age) {
        this.id = id;
        this.name = name;
        this.age = 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;
    }
    @Override
    public String toString() {
        return "Person [age=" + age + ", id=" + id + ", name=" + name + "]";
    }
    
}

service：

package cn.itcast.service;

import java.io.InputStream;
import java.util.ArrayList;
import java.util.List;
import javax.xml.parsers.SAXParser;
import javax.xml.parsers.SAXParserFactory;
import org.xml.sax.Attributes;
import org.xml.sax.SAXException;
import org.xml.sax.helpers.DefaultHandler;

import cn.itcast.domain.Person;
/**
 * 采用SAX解析XML内容
 */
public class SAXPersonService {
    
    public List<Person> getPersons(InputStream inStream) throws Throwable{
        //得到一个Sax解析器工厂
        SAXParserFactory factory = SAXParserFactory.newInstance();
        //得到解析器
        SAXParser parser = factory.newSAXParser();
        //new出一个PersonParser对象出来。把这个对象传到下面语句中
        PersonParser personParser = new PersonParser();
        //对得到的输入流Sax进行解析，第一个参数是要进行解析的xml内容，第二个参数是给 SAX DefaultHandler使用（回调函数）
        parser.parse(inStream, personParser);
        inStream.close();
        //返回得到的getPersons
        return personParser.getPersons();
    }

    private final class PersonParser extends DefaultHandler{
        //把解析到的数据都放到集合里面去
        private List<Person> persons = null;
        //记录当前所解析到的元素节点名称
        private String tag = null;
        private Person person = null;
        //提供一个getpersons方法，主要是为主程序使用
        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();//new出person对象，把要解析的内容传给person的Id属性
                person.setId(new Integer(attributes.getValue(0)));
            }
            //存放节点名称到成员变量里面
            tag = localName;
        }
        
        @Override
        public void characters(char[] ch, int start, int length)
                throws SAXException {
            //首先判断节点名称是否为空，然后在判断节点名称是否为name
            if(tag!=null){
                String data = new String(ch, start, length);//获取文本节点的数据
                if("name".equals(tag)){//判断节点名称是否为name
                    person.setName(data);//把要解析的内容传给person的name属性
                }else if("age".equals(tag)){//判断节点名称是否为age
                    person.setAge(new Short(data));
                }
            }
        }

        @Override
        public void endElement(String uri, String localName, String qName)
                throws SAXException {
            if("person".equals(localName)){//当跟末节点为person时
                persons.add(person);//把person放到集合persons里面
                person = null;//把当前person设为空
            }
            //遇到结束元素就把记录设为空
            tag = null;
        }
    }
}

Activity或测试类：

public class PersonServiceTest extends AndroidTestCase {
    private static final String TAG = "PersonServiceTest";

    public void testSAXGetPersons() throws Throwable{
        //new出一个业务对象
        SAXPersonService service = new SAXPersonService();
        //通过类加载器加载要解析的文件
        InputStream inStream = getClass().getClassLoader().getResourceAsStream("itcast.xml");
        List<Person> persons = service.getPersons(inStream);
        for(Person person : persons){
            Log.i(TAG, person.toString());    
        }
    }
｝

AndroidMainFest文件代码，这里主要是用到了单元测试，需要加几句代码:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
      package="cn.itcast.xml"
      android:versionCode="1"
      android:versionName="1.0">
    <application android:icon="@drawable/icon" android:label="@string/app_name">
         <uses-library android:name="android.test.runner" />
        <activity android:name=".MainActivity"
                  android:label="@string/app_name">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

    </application>
    <uses-sdk android:minSdkVersion="8" />
<instrumentation android:name="android.test.InstrumentationTestRunner"
  android:targetPackage="cn.itcast.xml" android:label="Tests for My App" />
</manifest>