在 Android中解析XML文主要有三种方式,分别为Simple API for XML(SAX)、Document Object Model(DOM)和Android附带的PULL解析器。其中SAX是一个解析速度非常快并且占用内存少的XML解析器,非常适合Android手机等移动设备。
SAX解析XML文件采用事件驱动的方式进行,也就是说,SAX是逐行扫描文件,遇到符合条件的设定条件后就会触发特定的事件,回调你写好的事件处理程序。使用SAX的优势在于其解析速度较快,占用内存较少(相对于DOM而言)。而且SAX在解析文件的过程中得到自己需要的信息后可以随时终止解析,并不一定要等文件全部解析完毕。凡事有利必有弊,其劣势在于SAX采用的是流式处理方式,当遇到某个标签的时候,它并不会记录下以前所遇到的标签,也就是说,在处理某个标签的时候,比如在 startElement方法中,所能够得到的信息就是标签的名字和属性,至于标签内部的嵌套结构,上层标签、下层标签以及其兄弟节点的名称等等与其结构相关的信息都是不得而知的。实际上就是把XML文件的结构信息丢掉了,如果需要得到这些信息的话,只能你自己在程序里进行处理了。所以相对DOM而言,SAX处理XML文档没有DOM方便,SAX处理的过程相对DOM而言也比较复杂。
使用SAX解析XML文件一般有以下五个步骤:
1、创建一个SAXParserFactory对象(通过类名很容易得知它利用工厂方法模式实现的);
2、调用SAXParserFactory中的newSAXParser方法创建一个SAXParser对象;
3、然后在调用SAXParser中的getXMLReader方法获取一个XMLReader对象;
4、在XMLReader中注册事件处理接口,一般有ContentHandler、ErrorHandler、DTDHandler、EntityHandler四种;
5、调用XMLReader中的parse方法解析指定的XML字符串对象;
步骤四中提到的四个Handler是事件处理接口,SAX的事件处理函数就定义在这四个接口中,利用SAX解析XML文件需要重写接口中的方法。其中ContentHandler用来处理XML中的内容,ErrorHandler用来处理错误,DTDHandler用来处理DTD,EntityHandler用来处理XML文档中的实体;最常用的是ContentHandler这个接口,下面是该接口中的一些常用方法:
startDocument()
当遇到文档的开头的时候,调用这个方法,可以在其中做一些预处理的工作。
endDocument()
和上面的方法相对应,当文档结束的时候,调用这个方法,可以在其中做一些善后的工作。
startElement(String uri, String localName, String qName, Attributes atts)
当读到一个开始标签的时候,会触发这个方法。uri是命名空间(通过xmlns声明),localName是不带命名空间前缀的标签名,qName是带命名空间前缀的标签名。通过atts可以得到所有的属性名和相应的值。注意,如果没有指定Namespace,则qName可能为空,当然不同的SAX实现会有所不同,比如在Android中qName为空,而J2SE中localName为空,所以想要总是得到标签名,就需要检查这两个参数的值了。
endElement(String uri, String localName, String name)
这个方法和上面的方法相对应,在遇到结束标签的时候,调用这个方法。
characters(char[] ch, int start, int length)
这个方法用来处理在XML文件中读到的内容,第一个参数为文件的字符串内容,后面两个参数是读到的字符串在这个数组中的起始位置和长度,使用new String(ch,start,length)就可以获取内容。
下面是利用SAX解析XML文件的DEMO程序,首先定义一个XML文件users.xml,内容如下:
01
02
03
04
05
06
07
08
09
10
11
其中第二个user标签中字符串long就是所谓的前缀,标签中的id则是该标签的一个属性。
然后我们来实现ContentHandler这个接口,并重写其中的方法来处理上面的XML文件,代码如下:
01 package sax.test;
02
03 import java.util.ArrayList;
04
05 import org.xml.sax.Attributes;
06 import org.xml.sax.SAXException;
07 import org.xml.sax.helpers.DefaultHandler;
08
09 public class MyHandler extends DefaultHandler {
10 private ArrayList
11 private User user;
12 private String content;
13
14 public ArrayList
15 return users;
16 }
17
18 @Override
19 public void startDocument() throws SAXException {
20 super.startDocument();
21 users = new ArrayList
22 System.out.println("----------Start Parse Document----------" );
23 }
24
25 @Override
26 public void endDocument() throws SAXException {
27 System.out.println("----------End Parse Document----------" );
28 }
29
30 @Override
31 public void characters(char[] ch, int start, int length)
32 throws SAXException {
33 super.characters(ch, start, length);
34 // 获得标签中的文本
35 content = new String(ch, start, length);
36 }
37
38 @Override
39 public void startElement(String uri, String localName, String qName,
40 Attributes attributes) throws SAXException {
41 super.startElement(uri, localName, qName, attributes);
42 // 打印出localname和qName
43 System.out.println("LocalName->" + localName);
44 System.out.println("QName->" + qName);
45 if ("user".equals(localName)) {
46 user = new User();
47 user.setId(Integer.parseInt(attributes.getValue("id")));
48 }
49 }
50
51 @Override
52 public void endElement(String uri, String localName, String qName)
53 throws SAXException {
54 super.endElement(uri, localName, qName);
55 if ("name".equals(localName)) {
56 user.setName(content);
57 } else if ("password".equals(localName)) {
58 user.setPassword(content);
59 } else if ("user".equals(localName)) {
60 users.add(user);
61 }
62 }
63 }
最后我们编辑TestSAX这个类,获取users.xml这个文件中的内容,并利用SAX进行解析,代码如下:
01 package sax.test;
02
03 import java.io.IOException;
04
05 import javax.xml.parsers.ParserConfigurationException;
06 import javax.xml.parsers.SAXParser;
07 import javax.xml.parsers.SAXParserFactory;
08
09 import org.xml.sax.InputSource;
10 import org.xml.sax.SAXException;
11 import org.xml.sax.XMLReader;
12
13 import android.app.Activity;
14 import android.os.Bundle;
15 import android.widget.TextView;
16
17 public class TestSAX extends Activity {
18 private TextView text;
19
20 /** Called when the activity is first created. */
21 @Override
22 public void onCreate(Bundle savedInstanceState) {
23 super.onCreate(savedInstanceState);
24 setContentView(R.layout.main);
25
26 text = (TextView) findViewById(R.id.result);
27
28 try {
29 // 创建一个工厂对象
30 SAXParserFactory factory = SAXParserFactory.newInstance();
31 // 通过工厂对象得到一个解析器对象
32 SAXParser parser = factory.newSAXParser();
33 // 通过parser得到XMLReader对象
34 XMLReader reader = parser.getXMLReader();
35 // 为reader对象注册事件处理接口
36 MyHandler handler = new MyHandler();
37 reader.setContentHandler(handler);
38 // 解析指定XML字符串对象
39 reader.parse(newInputSource(TestSAX.class.getClassLoader().getResourceAsStream("users.xml")));
40
41 String usersInfo = "";
42 for (User user : handler.getUsers()) {
43 usersInfo += "ID->" + user.getId() + "\n";
44 usersInfo += "NAME->" + user.getName() + "\n";
45 usersInfo += "PASSWORD->" + user.getPassword() + "\n";
46 usersInfo += "\n\n";
47 }
48 text.setText(usersInfo);
49 } catch (SAXException e) {
50 e.printStackTrace();
51 } catch (ParserConfigurationException e) {
52 e.printStackTrace();
53 } catch (IOException e) {
54 e.printStackTrace();
55 }
56 }
57
58 }
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)就可以获取内容。
注意:一个标签之间的字符比较多时,或者字符串中包含有”\n”等特殊字符时,就会出现字符丢失的现象。遇到这种问题不要怀疑SAX不能解析标签中含有”\n”或字符比较多的XML。实际上是我们写的Handler是有问题的。SAX在解析XML时,当遇到一个标签中的内容比较多时,就会多次调用characters。所以我们在写Handler时要考虑到这种情况。就不会丢字符了。以下是一种解决方案:新建一个临时变量temp,在调用characters方法中用temp接收数据,在endElement方法中把临时变量temp赋值给目标变量,并给临时变量temp清空,避免出现脏数据,这样就可以解决sax读取XML时不能读取换行符号后面的内容的问题。