XML解析(一),SAX解析XML

前端之家收集整理的这篇文章主要介绍了XML解析(一),SAX解析XML前端之家小编觉得挺不错的,现在分享给大家,也给大家做个参考。

一、概述

 SAX,全称Simple API for XML,是一种以事件驱动的XMl API,是XML解析的一种新的替代方法,解析XML常用的还有DOM解析,PULL解析(Android特有),SAX与DOM不同的是它边扫描边解析,自顶向下依次解析,由于边扫描边解析,所以它解析XML具有速度快,占用内存少的优点,对于Android等cpu资源宝贵的移动平台来说是一个巨大的优势。

  • SAX的优点:

    1. 解析速度快
    2. 占用内存少
  • SAX的缺点:

    1. 无法知道当前解析标签(节点)的上层标签,及其嵌套结构,仅仅知道当前解析的标签的名字和属性,要知道其他信息需要程序猿自己编码
    2. 只能读取XML,无法修改XML
    3. 无法随机访问某个标签(节点)
  • SAX解析适用场合
    1. 对于cpu资源宝贵的设备,如Android等移动设备
    2. 对于只需从xml读取信息而无需修改xml

二、SAX解析的步骤

解析步骤很简单,可分为以下四个步骤

  1. 得到xml文件对应的资源,可以是xml的输入流,文件和uri
  2. 得到SAX解析工厂(SAXParserFactory
  3. 由解析工厂生产一个SAX解析器(SAXParser
  4. 传入输入流和handler给解析器,调用parse()解析

知道了SAX解析的优缺点和解析步骤,下面我们通过一个简单的Demo学习一下SAX解析XML

三、SAX解析实战

新建一个Android工程叫SaxParseXmlDemo,将sax.jar下载放到工程的lib下面并添加到构建路径中,为了方便,我先将工程的目录结构列一下:

1、新建一个xml文件叫users.xml

<?xml version="1.0" encoding="UTF-8"?>
<users>
    <user id="1">
        <name>毕向东</name>
        <password>bxd123</password>
    </user>
    <user id="2">
        <name>韩顺平</name>
        <password>hsp123</password>
    </user>
    <user id="3">
        <name>马士兵</name>
        <password>msb123</password>
    </user>
</users>

2、新建一个JavaBean

package com.example.saxparsexmldemo;

public class User {
    private long id;
    private String name;
    private String password;

    public long getId() {
        return id;
    }
    public void setId(long id) {
        this.id = id;
    }
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    public String getPassword() {
        return password;
    }
    public void setPassword(String password) {
        this.password = password;
    }
}

3、新建一个类XmlParseHandler.java,该类需要继承DefaultHandler或者实现ContentHandler接口,这里我们通过继承DefaultHandler(实现了ContentHandler接口)的方式,该类是SAX解析的核心所在,我们要重写以下几个我们关心的方法

  • startDocument():文档解析开始时调用,该方法只会调用一次
  • startElement(String uri,String localName,String qName,
    Attributes attributes):标签(节点)解析开始时调用

    1. uri:xml文档的命名空间
    2. localName:标签的名字
    3. qName:带命名空间的标签的名字
    4. attributes:标签属性
  • characters(char[] ch,int start,int length):解析标签内容的时候调用

    1. ch:当前读取到的TextNode(文本节点)的字节数组
    2. start:字节开始的位置,为0则读取全部
    3. length:当前TextNode的长度
  • endElement(String uri,String qName):标签(节点)解析结束后调用
  • endDocument():文档解析结束后调用,该方法只会调用一次

 重写startDocument(),我们在这里初始化User集合,该集合用来存放解析出来的user

Log.e("startDocument","startDocument()");
users = new ArrayList<User>();

 重写startElement,在startElement中先判断当前的标签是否user,如果是user标签则说明接下来是一个user的信息,所以我们新建一个User对象用来存放这个user的信息,在这里我们得到当前user标签的id属性,封装到user对象中。并记录当前的标签

Log.e("startElement",localName + "-startElement()");
        if ("user".equals(localName)) { // 是一个用户
            for (int i = 0; i < attributes.getLength(); i++) {
                Log.e("attributes","attribute_name:" + attributes.getLocalName(i)
                        + " attribute_value:" + attributes.getValue(i));
                user = new User();
                if("id".equals(attributes.getLocalName(i))){
                    user.setId(Long.parseLong(attributes.getValue(i)));
                }
            }
        }
        currentTag = localName; // 把当前标签记录下来

 重写characters,在characters中解析出当前标签内容,如果当前标签为name标签,则解析name标签内容封装到当前User对象的name属性中,如果当前标签为password标签,则解析password标签内容封装到当前User对象的password属性

String value = new String(ch,start,length); // 将当前TextNode转换为String
        Log.e("characters",value+"");
        if("name".equals(currentTag)){  // 当前标签为name标签,该标签无子标签,直接将上面获取到的标签的值封装到当前User对象中
            // 该节点为name节点
            user.setName(value);
        }else if("password".equals(currentTag)){  // 当前标签为password标签,该标签无子标签,直接将上面获取到的标签的值封装到当前User对象中
            // 该节点为password节点
            user.setPassword(value);
        }

 重写endElement,在这个方法中判断当前是否是user标签的结束,如果是user标签结束,则这个user信息解析结束,并将当前的User对象和当前的标签重置

Log.e("endElement",localName + "-endElement()");
        if("user".equals(localName)){
            users.add(user);
            user = null;
        }
        currentTag = null;

 重写endDocument,这里直接给个空实现,我们只需观察Log输出

Log.e("endDocument","-endDocument()");

XmlParseHandler.java完整代码:

package com.example.saxparsexmldemo;

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 android.util.Log;

public class XmlParseHandler extends DefaultHandler {

    private List<User> users;
    private String currentTag; // 记录当前解析到的节点名称
    private User user; // 记录当前的user

    /** * 文档解析结束后调用 */
    @H_301_434@@Override
    public void endDocument() throws SAXException {
        super.endDocument();
        Log.e("endDocument","-endDocument()");
    }

    /** * 节点解析结束后调用 * @param uri : 命名空间的uri * @param localName : 标签名称 * @param qName : 带命名空间的标签名称 */
    @H_301_434@@Override
    public void endElement(String uri,String qName)
            throws SAXException {
        super.endElement(uri,localName,qName);
        Log.e("endElement",localName + "-endElement()");
        if("user".equals(localName)){
            users.add(user);
            user = null;
        }
        currentTag = null;
    }

    /** * 文档解析开始调用 */
    @H_301_434@@Override
    public void startDocument() throws SAXException {
        super.startDocument();
        Log.e("startDocument","startDocument()");
        users = new ArrayList<User>();
    }

    /** * 节点解析开始调用 * @param uri : 命名空间的uri * @param localName : 标签名称 * @param qName : 带命名空间的标签名称 */
    @H_301_434@@Override
    public void startElement(String uri,Attributes attributes) throws SAXException {
        super.startElement(uri,qName,attributes);
        Log.e("startElement","attribute_name:" + attributes.getLocalName(i)
                        + " attribute_value:" + attributes.getValue(i));
                user = new User();
                if("id".equals(attributes.getLocalName(i))){
                    user.setId(Long.parseLong(attributes.getValue(i)));
                }
            }
        }
        currentTag = localName; // 把当前标签记录下来
    }

    @H_301_434@@Override
    public void characters(char[] ch,int start,int length)
            throws SAXException {
        super.characters(ch,length); 
        String value = new String(ch,value+"");
        if("name".equals(currentTag)){  // 当前标签为name标签,该标签无子标签,直接将上面获取到的标签的值封装到当前User对象中
            // 该节点为name节点
            user.setName(value);
        }else if("password".equals(currentTag)){  // 当前标签为password标签,该标签无子标签,直接将上面获取到的标签的值封装到当前User对象中
            // 该节点为password节点
            user.setPassword(value);
        }
    }

    public List<User> getUsers() {
        return users;
    }
}

4、新建一个类XmlParseUtils.java,写一个方法进行xml解析

public static List<User> getUsers() throws ParserConfigurationException,SAXException,IOException {
        // 加载文件返回文件的输入流
        InputStream is = XmlParseUtils.class.getClassLoader().getResourceAsStream("users.xml");
        XmlParseHandler handler = new XmlParseHandler();
        // 1. 得到SAX解析工厂
        SAXParserFactory saxParserFactory = SAXParserFactory.newInstance();
        // 2. 让工厂生产一个sax解析器
        SAXParser newSAXParser = saxParserFactory.newSAXParser();
        // 3. 传入输入流和handler,解析
        newSAXParser.parse(is,handler);
        is.close();
        return handler.getUsers();
    }

 其中第三步也可以通过XMLReader来完成

XMLReader xmlReader = newSAXParser.getXMLReader();
InputSource input = new InputSource(is);
xmlReader.parse(input );

到这里SAX解析XML的代码完成了,OK,万事具备,只欠测试了

这里我们用Android的单元测试,只需完成调用XmlParseUtilsgetUsers()方法测试输出即可

Android的单元测试(需要连接模拟器或者手机)
  • 环境搭建

    • 在 AndroidManifest.xml的根节点下面添加一个instrumentation

      <instrumentation android:targetPackage="com.example.saxparsexmldemo" android:name="android.test.InstrumentationTestRunner"></instrumentation>
    • 在 AndroidManifest.xml的application节点下面添加uses-library

      <uses-library android:name="android.test.runner"/>
  • com.example.saxparsexmldemo下面新建一个测试类SAXParseXmlTest.java,写一个测试方法
public void testSAXgetUsers() throws Exception{
        List<User> users = XmlParseUtils.getUsers();
        for(User user : users){
            Log.e(TAG,"name:"+user.getName());
            Log.e(TAG,"password:"+user.getPassword());
        }
    }

 OK,右键该类的testSAXgetUsers,Run As Android JUnit Test,我们可以看到XML解析成功

通过上面的这个小Demo的完成,我们可以看到SAX解析代码不多也不难理解,关键是Handler的几个方法的使用,即遇到什么符号会触发什么事件,以及触发过程,掌握了SAX的事件触发,那么就掌握了SAX解析XML,下面我们来分析一下SAX解析的原理或流程

四、SAX解析XML原理

在分析SAX解析原理之前,我们先看一下上面的demo的日志输出

以users.xml的解析过程为例,结合上面的日志输出,我们可以分析出SAX解析的流程

1、xml解析开始,startDocument被调用,这个方法在整个xml解析过程中调用了一次,所以我们可以在这个方法里面初为解析XML做一些准备,比如初始化变量
2、解析每遇到一个标签都会经历startElement-characters-endElement这个过程,即每一个标签都会触发startElement-characters-endElement
3、通过users这个根节点的解析,user标签解析以及name,password标签解析过程,我们知道user标签是users的子标签,name和password标签是user标签的子标签,我们知道当解析一个标签的时候,如果该标签有子标签,则先回调用标签startElement方法,这里面可以先得到该标签属性信息,然后触发characters解析该标签内容(值),然后子标签触发startElement-characters-endElement(子标签触发),最后该标签触发endElement,该标签解析结束

下面画一个图让我们进一步理解SAX解析XML的原理:

对上图做个简单说明,当当前标签有子标签的时候,该标签先触发characters,然后子标签触发startElement-characters-endElement事件,这个过程可以理解为一个不断递归的过程。

OK,SAX解析原理分析完了,最后用一句话描述SAX解析过程

startDocument-startElement-characters-endElement-endDocument

总结,SAX解析XML具有解析速度快,占用内存少,对于Android等移动设备来说有巨大的优势,深入了解SAX的事件触发机制是掌握SAX解析的关键,掌握了SAX的事件触发就掌握了SAX解析XML

上面这篇文章由于个人理解,如果有理解错的地方,欢迎大家指出,与君共勉,一起进步。

Demo下载地址:http://download.csdn.net/detail/ydxlt/9328309

下篇文章:【XML解析(二)】DOM解析XML

猜你在找的XML相关文章