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 支持已内置到JDK1.5中,你无需添加任何的jar文件。
Strings.xml
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="app_name">lession03_xml</string>
<string name="action_settings">Settings</string>
<string name="hello_world">Hello world!</string>
<string name="btn_sax">采用sax解析xml文件</string>
<string name="btn_dom">采用dom解析方式解析</string>
<string name="btn_pull">采用pull解析方式解析</string>
<string name="btn_cpull">采用pull解析生成xml文件</string>
</resources>
activity_xml.xml
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:paddingBottom="@dimen/activity_vertical_margin"
android:paddingLeft="@dimen/activity_horizontal_margin"
android:paddingRight="@dimen/activity_horizontal_margin"
android:paddingTop="@dimen/activity_vertical_margin"
tools:context=".XmlActivity" >
<Button
android:id="@+id/button_cpull"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignLeft="@+id/btn_pull"
android:layout_alignRight="@+id/btn_pull"
android:layout_below="@+id/btn_pull"
android:layout_marginTop="20dp"
android:text="@string/btn_cpull" />
<Button
android:id="@+id/btn_sax"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignParentLeft="true"
android:layout_alignParentRight="true"
android:text="@string/btn_sax" />
<Button
android:id="@+id/btn_pull"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignLeft="@+id/btn_dom"
android:layout_alignRight="@+id/btn_dom"
android:layout_below="@+id/btn_dom"
android:layout_marginTop="68dp"
android:text="@string/btn_pull" />
<Button
android:id="@+id/btn_dom"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignLeft="@+id/btn_sax"
android:layout_alignRight="@+id/btn_sax"
android:layout_below="@+id/btn_sax"
android:layout_marginTop="60dp"
android:text="@string/btn_dom" />
</RelativeLayout>
Person.java
package com.example.lession03_xml.domain;
import java.io.Serializable;
/**
* 创建一个javabean存储xml解析的数据
*
* @author chenhj
*
*/
public class Person implements Serializable {
/**
*
*/
private static final long serialVersionUID = 1L;
private int id;
private String name;
private short age;
public Person() {
super();
// TODO Auto-generated constructor stub
}
public Person(int id, String name, short age) {
super();
this.id = id;
this.name = name;
this.age = age;
}
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;
}
public short getAge() {
return age;
}
public void setAge(short age) {
this.age = age;
}
}
XMLContentHandlerService.java
package com.example.lession03_xml.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.example.lession03_xml.domain.Person;
public class XMLContentHandlerService extends DefaultHandler {
// 解析的person对象存储到list集合中
private List<Person> persons;// = new ArrayList<Person>();
public Person currentPerson;// 解析的当前person对象
public String tagName;// 声明标签的名称
//获取解析的所有的person对象
public List<Person> getPersons() {
return persons;
}
public void setPersons(List<Person> persons) {
this.persons = persons;
}
/**
* 文档开始触发的事件
*/
@Override
public void startDocument() throws SAXException {
super.startDocument();
persons = new ArrayList<Person>();
}
/**
* 当接受到元素开始标签的时候触发该事件 <person>
* uri:元素的命名空间
* localName:元素的本地名称(不带前缀)
* qName:元素的限定名(带前缀)
* attributes:属性集合
*/
@Override
public void startElement(String uri, String localName, String qName,
Attributes attributes) throws SAXException {
super.startElement(uri, localName, qName, attributes);
// 判断解析的标签是否是person
if (localName.equals("person")) {
// 创建person对象
currentPerson = new Person();
// 把id属性的值解析出来 并且把id赋值给currentPerson对象
currentPerson.setId(Integer.parseInt(attributes.getValue(0)));
}
// person name age
this.tagName = localName;
}
@Override
public void characters(char[] ch, int start, int length)
throws SAXException {
super.characters(ch, start, length);
// 首先判断tagName是否为空
if (tagName != null) {
// 获取标签中的内容
String data = new String(ch, start, length);
// 判断标签是否是name
if (tagName.equals("name")) {
currentPerson.setName(data);
} else if (tagName.equals("age")) {// 判断标签是否是age
currentPerson.setAge((short) Integer.parseInt(data));
}
}
}
@Override
public void endElement(String uri, String localName, String qName)
throws SAXException {
super.endElement(uri, localName, qName);
// 当person标签结束的时候 把person对象存储到集中
if (localName.equals("person")) {
persons.add(currentPerson);
// 当对象=null
currentPerson = null;
}
// person age
// name
this.tagName = null;
}
@Override
public void endDocument() throws SAXException {
// TODO Auto-generated method stub
super.endDocument();
}
}
XmlActivity.java
package com.example.lession03_xml;
import java.io.InputStream;
import java.util.List;
import javax.xml.parsers.SAXParser;
import javax.xml.parsers.SAXParserFactory;
import com.example.lession03_xml.domain.Person;
import com.example.lession03_xml.service.XMLContentHandlerService;
import com.example.lession03_xml.service.XMLDomService;
import com.example.lession03_xml.service.XMLPullService;
import android.os.Bundle;
import android.app.Activity;
import android.view.Menu;
import android.view.View;
import android.widget.Button;
import android.widget.Toast;
public class XmlActivity extends Activity {
// 声明控件
public Button btn_sax, btn_dom, btn_pull, btn_cpull;
public XMLDomService xmlDomService;
public XMLPullService xmlPullService;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// 设置显示的视图
setContentView(R.layout.activity_xml);
// 实例化
xmlDomService = new XMLDomService();
xmlPullService = new XMLPullService();
// 通过findViewById方法获取控件对象
btn_sax = (Button) findViewById(R.id.btn_sax);
btn_dom = (Button) findViewById(R.id.btn_dom);
btn_pull = (Button) findViewById(R.id.btn_pull);
btn_cpull = (Button) findViewById(R.id.button_cpull);
// 给按钮注册事件
btn_sax.setOnClickListener(new MyClickListener());
btn_dom.setOnClickListener(new MyClickListener());
btn_pull.setOnClickListener(new MyClickListener());
btn_cpull.setOnClickListener(new MyClickListener());
}
@Override
public boolean onCreateOptionsMenu(Menu menu) {
// Inflate the menu; this adds items to the action bar if it is present.
getMenuInflater().inflate(R.menu.xml, menu);
return true;
}
class MyClickListener implements View.OnClickListener {
@Override
public void onClick(View v) {
// 获取组件的id
int id = v.getId();
switch (id) {
case R.id.btn_sax:
Toast.makeText(XmlActivity.this, "采用sax解析xml文件案例",
Toast.LENGTH_LONG).show();
// sax解析的工厂对象
SAXParserFactory factory = SAXParserFactory.newInstance();
try {
// 得到sax的解析器
SAXParser saxParser = factory.newSAXParser();
// 创建handler对象
XMLContentHandlerService handlerService = new XMLContentHandlerService();
// 获取到了 asserts目录中 csdn.xml文件
InputStream is = getAssets().open("csdn.xml");
// 直接解析 InputStream的流对象
saxParser.parse(is, handlerService);
// 通过 handlerService对象
Toast.makeText(XmlActivity.this,
"---" + handlerService.getPersons().size(),
Toast.LENGTH_LONG).show();
} catch (Exception e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
break;
case R.id.btn_dom:
InputStream is = null;
try {
// 获取读取文件的输入流对象
is = getAssets().open("csdn.xml");
// 采用
List<Person> persons = xmlDomService.parseXML(is);
//
Toast.makeText(XmlActivity.this,
"" + persons.get(0).getName(), Toast.LENGTH_LONG)
.show();
} catch (Exception e) {
e.printStackTrace();
}
break;
case R.id.btn_pull:
break;
case R.id.button_cpull:
break;
default:
break;
}
}
}
}