android_xml解析之 使用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)就可以获取内容。

只要为SAX提供实现ContentHandler接口的类，那么该类就可以得到通知事件（实际上就是SAX调用了该类中的回调方法）。因为ContentHandler是一个接口，在使用的时候可能会有些不方便，因此，SAX还为其制定了一个Helper类：DefaultHandler，它实现了ContentHandler接口，但是其所有的方法体都为空，在实现的时候，你只需要继承这个类，然后重写相应的方法即可。使用SAX解析itcast.xml的代码如下：

 

public static List<Person> readXML(InputStream inStream) {

   try {

  SAXParserFactory spf = SAXParserFactory.newInstance();

  SAXParser saxParser = spf.newSAXParser(); //创建解析器

  //设置解析器的相关特性，http://xml.org/sax/features/namespaces = true 表示开启命名空间特性 

  //saxParser.setProperty("http://xml.org/sax/features/namespaces",true);

  XMLContentHandler handler = new XMLContentHandler();

  saxParser.parse(inStream, handler);

  inStream.close();

  return handler.getPersons();

   } catch (Exception e) {

  e.printStackTrace();

   }

  return null;

}

SAX 支持已内置到JDK1.5中，你无需添加任何的jar文件。

 

以下为采用SAX解析xml 文件的两种思路:

 

package com.test.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 com.test.bean.Person;

public class SAXPersonService {

 public List<Person> getPersons(InputStream inStream) throws Throwable {
  SAXParserFactory factory = SAXParserFactory.newInstance();
  SAXParser parser = factory.newSAXParser();
  PersonParser personParser = new PersonParser();
  PersonParser2 personParser2 = new PersonParser2();
//  parser.parse(inStream, personParser);
  parser.parse(inStream, personParser2);
  inStream.close();
  return personParser2.getPersons();
 }
 
    private  final class PersonParser2 extends DefaultHandler{
     
     private List<Person> persons =null;
     private Person person =null;
     private StringBuffer buffer = new StringBuffer();
     
     public List<Person> getPersons() {
   
   return persons;
  }
     
  @Override
  public void characters(char[] ch, int start, int length)
    throws SAXException {
   buffer.append(ch, start, length);
   super.characters(ch, start, length);
  }
  @Override
  public void endElement(String uri, String localName, String name)
    throws SAXException {
   
   if("person".equals(localName)){
    
    persons.add(person);
   }
   else if("name".equals(localName)){
       person.setName(buffer.toString().trim());
       buffer.setLength(0);
      }
   else if ("age".equals(localName)) {
    person.setAge(new Short(buffer.toString().trim()));
    buffer.setLength(0);
   }
   super.endElement(uri, localName, name);
  }
  @Override
  public void startDocument() throws SAXException {
   persons = new ArrayList<Person>();
   super.startDocument();
  }
  @Override
  public void startElement(String uri, String localName, String name,
    Attributes attributes) throws SAXException {
      if("person".equals(localName)){
       person = new Person();
       person.setId(new Integer(attributes.getValue(0)));
      }
   super.startElement(uri, localName, name, attributes);
  }
    }
 private final class PersonParser extends DefaultHandler {

  private List<Person> persons = null;
  private String tag = null;
  private Person person = null;

  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 name,
    Attributes attributes) throws SAXException {
   if ("person".equals(localName)) {
    person = new Person();
    person.setId(new Integer(attributes.getValue(0)));
   }
   tag = localName;
  }
  @Override
  public void characters(char[] ch, int start, int length)
    throws SAXException {
   if (tag != null) {
    String data = new String(ch, start,length);
    if ("name".equals(tag)) {
     person.setName(data);
    } else if ("age".equals(tag)) {
     person.setAge(new Short(data));
    }
   }
  }
  @Override
  public void endElement(String uri, String localName, String name)
    throws SAXException {
   if("person".equals(localName)){
    persons.add(person);
    person =null;
   }
   tag = null;
  }
 }

}

 

单元测试代码为：

public class PersonServiceTest extends AndroidTestCase {

 private static final String TAG = "PersonServiceTest";

 public void testSAXGetpersons() throws Throwable {
  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());
  }
 }

}

 

 这里需要注意的是，我们如果用单元测试的话， 需要在anroidmanifest.xml清单文件中加入一些配置信息：

 

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
      package="com.test.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=".Main"
                  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="com.test.xml"
  android:label="Test for my App" />
</manifest>