12.4.2 SAX分析

    为了使用Android上内置的SAX分析器，首先需要创建扩展DefaultHandler的新类。这个类将包含一些方法，可以使用户在启动、停止一个XML元素以及在读取内容时获得通知。下面是一个基本的版本，其仅仅输出日志。

    private class UserXMLHandler extends DefaultHandler{
        @Override
        public void startDocument() throws SAXException {
            super.startDocument();
            Log.v("SimpleXMLParser", "startDocument");
        }
        @Override
        public void endDocument() throws SAXException {
            super.endDocument();
            Log.v("SimpleXMLParser", "endDocument");
        }
        @Override
        public void startElement(String uri, String localName, String qName,
                Attributes attributes) throws SAXException {
            super.startElement(uri, localName, qName, attributes);
            Log.v("SimpleXMLParser", "startElement"+localName);
        }
        @Override
        public void endElement(String uri, String localName, String qName)
                throws SAXException {
            super.endElement(uri, localName, qName);
            Log.v("SimpleXMLParser", "endElement"+localName);
        }
        @Override
        public void characters(char[] ch, int start, int length)
                throws SAXException {
            super.characters(ch, start, length);
            String stringChars=new String(ch,start,length);
            Log.v("SimpleXMLParser",stringChars);
        }
    }

    一旦获得该类，就可以创建一个SAXParserFactory实例，然后创建一个SAXParser实例。

        SAXParserFactory aSAXParserFactory=SAXParserFactory.newInstance();
        SAXParser aSAXParser=aSAXParserFactory.newSAXParser();

    通过SAXParser对象可以得到一个XMLReader，用来确定在分析时会发生什么，并执行实际的分析。

            XMLReader anXMLReader=aSAXParser.getXMLReader();

    然后实例化XMLHandler，并将它传递给XMLReader上的setContentHandler方法。

            XMLHandler anUserXMLHandler=new XMLHandler();
            anXMLReader.setContentHandler(anUserXMLHandler);

    最后调用XMLReader上的parse方法。在当前的情况下，假设有一个称为xmlInputStream的InputStream，其中包含了将要分析的XML。

            anXMLReader.parse(new InputSource(xmlInputStream));

    下面查看一个完整的示例，其显示了如何分析前述的“用户”XML。

package com.nthm.androidtestActivity;

import java.io.ByteArrayInputStream;
import java.io.IOException;
import javax.xml.parsers.ParserConfigurationException;
import javax.xml.parsers.SAXParser;
import javax.xml.parsers.SAXParserFactory;
import org.xml.sax.Attributes;
import org.xml.sax.InputSource;
import org.xml.sax.SAXException;
import org.xml.sax.XMLReader;
import org.xml.sax.helpers.DefaultHandler;
import android.app.Activity;
import android.os.Bundle;
import android.util.Log;

public class SimpleXMLParser extends Activity {

    需要将XML转换成名为XMLUser的类(在本代码的末尾定义该类)的实例，它将是在XML中定义的数据的java表示。

    private XMLUser aUser;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);

    此示例将要分析的XML包含在一个称为xml的字符串中。

        String xml="<?xml version="1.0"?>
"
                    +"<user>
"
                    +"<user-id>15</user-id>
"
                    +"<username>vanevery</username>
"
                    +"<firstname>Shawn</firstname>
"
                    +"<lastname>Van Every</lastname>
"
                    +"</user>
";

    下面将依次执行之前所描述的步骤，并创建SAXParserFactory、SAXParser和XMLReader。

        SAXParserFactory aSAXParserFactory=SAXParserFactory.newInstance();
        try {
            SAXParser aSAXParser=aSAXParserFactory.newSAXParser();
            XMLReader anXMLReader=aSAXParser.getXMLReader();

    然后，将使用下面定义的UserXMLHandler实例作为处理程序，用来确定当分析时会发生的事情。

            UserXMLHandler aUserXMLHandler=new UserXMLHandler();
            anXMLReader.setContentHandler(aUserXMLHandler);

    最后将执行实际的分析。必须做一些额外的工作，将位于xml字符串中的XML转换成一个InputStream和一个能够通过XMLReader使用的InputSource。

            anXMLReader.parse(new InputSource(new ByteArrayInputStream(xml.getBytes())));
        } catch (ParserConfigurationException e) {
            e.printStackTrace();
        } catch (SAXException e) {
            e.printStackTrace();
        }catch (IOException e) {
            e.printStackTrace();
        }
    }

    此示例的主要内容是UserXMLHandler。它扩展了DefaultHandler，而且将随着对XML的分析获得它的数据。

    private class UserXMLHandler extends DefaultHandler{

    我们将使用以下常量并结合state变量来跟踪已经读入了哪些元素。

        static final int NONE=0;
        static final int ID=1;
        static final int FIRSTNAME=2;
        static final int LASENAME=3;
        int state=NONE;

    我们将使用以下常量来匹配在XML中可能出现的元素的名称。

        static final String ID_ELEMENT="user-id";
        static final String FIRSTNAME_ELEMENT="firstname";
        static final String LASTNAME_ELEMENT="lastname";

   当分析器确定一个XML文档已经开始时，将调用startDocument方法，在此方法中实例化XMLUser对象，以保存在XML中表示的数据。

        @Override
        public void startDocument() throws SAXException {
            super.startDocument();
            Log.v("SimpleXMLParser", "startDocument");
            aUser=new XMLUser();
        }

    当分析器确定XML文档已经完成时，将调用endDocument方法。此处将只输出XMLUser对象中的内容。

        @Override
        public void endDocument() throws SAXException {
            super.endDocument();
            Log.v("SimpleXMLParser", "endDocument");
            Log.v("SimpleXMLParser", "User info:"+aUser.user_id+" "+aUser.firstname+" "+aUser.lastname);
        }

    当确定了一个新元素开始时，将调用startElement方法。换言之，在XML中发现一个开始标记。将通过localName变量传入该元素的名称。在此方法中只会将该名称与前面定义的常量相比较，并使用它来更改state变量。

        @Override
        public void startElement(String uri, String localName, String qName,
                Attributes attributes) throws SAXException {
            super.startElement(uri, localName, qName, attributes);
            Log.v("SimpleXMLParser", "startElement"+localName);
            if(localName.equalsIgnoreCase(ID_ELEMENT)){
                state=ID;
            }else if(localName.equalsIgnoreCase(FIRSTNAME_ELEMENT)){
                state=FIRSTNAME;
            }else if(localName.equalsIgnoreCase(LASTNAME_ELEMENT)){
                state=LASENAME;
            }else{
                state=NONE;
            }
        }

    当发现任何XML结束标记时，将调用endElement方法。

        @Override
        public void endElement(String uri, String localName, String qName)
                throws SAXException {
            super.endElement(uri, localName, qName);
            Log.v("SimpleXMLParser", "endElement"+localName);
        }

   每当在开始标记和结束标记之间发现文本时，将调用characters方法。在当前实现中将接受数据，并根据state变量表示的再文档中所处的位置将它放入XMLUser对象。

        @Override
        public void characters(char[] ch, int start, int length)
                throws SAXException {
            super.characters(ch, start, length);
            String stringChars=new String(ch,start,length);
            Log.v("SimpleXMLParser",stringChars);
            if(state==ID){
                aUser.user_id+=stringChars.trim();
            }else if(state==FIRSTNAME){
                aUser.firstname+=stringChars.trim();
            }else if(state==LASENAME){
                aUser.lastname+=stringChars.trim();
            }
        }
    }

    下面是XMLUser类，它用来保存在XML中给定的数据。

    class XMLUser{
        private String user_id;
        private String firstname;
        private String lastname;
        public XMLUser(){
            user_id="";
            firstname="";
            lastname="";
        }
    }
}

    在查看了这个简单的示例之后，可以将它作为在Android上实现任何XML分析的模板，包括处理所接收的用于响应Web服务请求的数据。