网络相关系列之四：数据解析之SAX方式解析XML数据

它仅仅有一个protected的构造方法（单例模式），所以须要使用静态的newInstance()方法来回的SAXParserFactory()对象。使用SAXParserFactory能够通过调用.newSAXParser()方法获得一个SAXParser，通过SAXParser对象能够运行parser()方法。通过传递的參数设定XML流和解析器类。

五、SAX解析XML的步骤：（代码实现）

如今通过一个演示样例程序来解说一下SAX是怎么解析XML文件的，这个演示样例程序是执行在Android平台上的，为了模拟真实情况，在tomcatserver上放置了一个静态的XML文件。即在opt/apache-tomcat-8.0.33/webapps/ROOT文件夹(当然这仅仅是我的文件夹)中新建一个andy.xml文件，xml文件内容例如以下：

<?xml version="1.0" encoding="UTF-8"?>
<persons>
    <person id="01">
        <name>andy</name>
        <age>23</age>
    </person>
    <person id="02">
        <name>koozxcv</name>
        <age>24</age>
    </person>
</persons>

如今我们须要做的是：通过Android程序去获取并解析这段XML数据。在这个演示样例程序中，读取person节点的值。

由于是Android程序，所以别忘了赋予其訪问网络的权限。

（1）【新建工具类HttpUtils】通过URLHttpConnection获取server上的XML流：

我们将其写成工具类。代码例如以下：

 package com.example.androidsaxxml.http;
 
 import java.io.InputStream;
 import java.net.HttpURLConnection;
 import java.net.URL;
 
 //工具类：通过URLHttpConnection获取server上的XML流
 public class HttpUtils {
 
     public HttpUtils() {
     }
     
     //方法：返回的InputStream对象就是server返回的XML流。
     public static InputStream getXML(String path) {//參数path：之后将在MainActivity中指定详细的url链接
         try {
             URL url=new URL(path);
             if(url!=null)
             {
                 HttpURLConnection connection=(HttpURLConnection)url.openConnection();
                 connection.setDoInput(true);
                 connection.setConnectTimeout(3000);
                 connection.setRequestMethod("GET");
                 int requesetCode=connection.getResponseCode();
                 if(requesetCode==200)
                 {
                     //假设运行成功。返回HTTP响应流
                     return connection.getInputStream();
                 }
             }
         } catch (Exception e) {
             // TODO: handle exception
         }        
         return null;
     }
 } 

（2）【新建类MyHandler】新建子类MyHandler，继承DefaultHandler类：用来解析xml

sax解析xml最重要的步骤就是定义一个我们自己的Handler处理类。并让其继承 DefaultHandler 这个类，然后在里面重写其回调方法。在这些回调方法里来做我们的xml解析。

代码例如以下：

 package com.example.androidsaxxml.handler;
  
  import java.util.ArrayList;
  import java.util.HashMap;
  import java.util.List;
  
  import org.xml.sax.Attributes;
  import org.xml.sax.SAXException;
  import org.xml.sax.helpers.DefaultHandler;
 
 
 //类：MyHandler，继承DefaultHandler类。用于解析XML数据。
 //之后在MainActivity中通过设定详细的nodeName来实例化MyHandler
    public class MyHandler extends DefaultHandler {
     private List<HashMap<String, String>> list = null; //解析后的XML内容
     private HashMap<String, String> map = null;  //存放当前须要记录的节点的XML内容
     private String currentTag = null;//当前读取的XML节点
     private String currentValue = null;//当前节点的XML文本值
     private String nodeName = null;//须要解析的节点名称
     
     public MyHandler(String nodeName) {
         // 设置须要解析的节点名称
         this.nodeName = nodeName;
     }
     
     @Override
     public void startDocument() throws SAXException {
         // 接收文档開始的通知
         // 实例化ArrayList用于存放解析XML后的数据
         list = new ArrayList<HashMap<String, String>>();
     }
     
     @Override
     public void startElement(String uri, String localName, String qName,
             Attributes attributes) throws SAXException {
         // 接收元素開始的通知        
         if (qName.equals(nodeName)) {
             //假设当前执行的节点名称与设定须要读取的节点名称同样，则实例化HashMap
             map = new HashMap<String, String>();
         }
         //Attributes为当前节点的属性值，假设存在属性值，则属性值也读取。
         if (attributes != null && map != null) {
             for (int i = 0; i < attributes.getLength(); i++) {
                 //读取到的属性值，插入到Map中。
                 map.put(attributes.getQName(i), attributes.getValue(i));
             }
         }
         //记录当前节点的名称。
         currentTag = qName;
     }
     
     @Override
     public void characters(char[] ch, int start, int length)
             throws SAXException {
         // 接收元素中字符数据的通知。
         //当前节点有值的情况下才继续执行
         if (currentTag != null && map != null) {
             //获取当前节点的文本值，ch这个直接数组就是存放的文本值。

             currentValue = new String(ch, start, length);
             if (currentValue != null && !currentValue.equals("")
                     && !currentValue.equals("\n")) {
                 //读取的文本须要推断不能为null、不能等于”“、不能等于”\n“
                 map.put(currentTag, currentValue);
             }
         }
         //读取完毕后，须要清空当前节点的标签值和所包括的文本值。
         currentTag = null;
         currentValue = null;
     }
     
     @Override
     public void endElement(String uri, String localName, String qName)
             throws SAXException {
         // 接收元素结束的通知。
         if (qName.equals(nodeName)) {
             //假设读取的结合节点是我们须要关注的节点，则把map增加到list中保存
             list.add(map);
             //使用之后清空map，開始新一轮的读取person。

             map = null;
         }
     }
     
     //方法：获取解析之后的数据
     public List<HashMap<String, String>> getList() {
         return list;
     }
 }

(3)【新建类SaxService】实例化一个SAX解析器的工厂对象:SAXParserFactory

须要一个调用SAXParser对象的类，这里新建一个SaxService类，实例化SAXParserFactory用于设定XML流和解析器，也就是在这里调用了上一步中的MyHandler类。

代码例如以下：

package com.example.androidsaxxml.service;
  
 import java.io.InputStream;
 import java.util.HashMap;
 import java.util.List;
 
 import javax.xml.parsers.SAXParser;
 import javax.xml.parsers.SAXParserFactory;
  
 import com.example.androidsaxxml.handler.MyHandler;
 
 
 //类：用于实例化例化一个SAX解析器的工厂对象:SAXParserFactory
 public class SaxService {
 
     public SaxService() {
         // TODO Auto-generated constructor stub
     }
     
     //方法：解析xml数据并返回，返回值类型是HashMap
     public static List<HashMap<String, String>> readXML(InputStream inputStream,String nodeName)
     {
         try {
             //实例化SAX工厂类
             SAXParserFactory factory=SAXParserFactory.newInstance();
             //实例化SAX解析器。
             SAXParser sParser=factory.newSAXParser();
             //实例化工具类MyHandler。设置须要解析的节点
             MyHandler myHandler=new MyHandler(nodeName);
             // 開始解析
             sParser.parse(inputStream, myHandler);
             // 解析完毕之后，关闭流
             inputStream.close();
             //返回解析结果。
             return myHandler.getList();  //在这里返回解析之后的数据
         } catch (Exception e) {
             // TODO: handle exception
         }        
         return null;
     }
     
 } 

（4）在MainActicity中实例化：即实例化须要訪问的链接path和须要解析的节点nodeName

布局界面非常easy。仅仅有一个button控件，这里就不展示布局代码了。点击button后，触发点击事件，由于是Android4.0+。所以不能在主线程中訪问网络。须要另起一个线程。这里使用Thread类。代码例如以下：　

 package com.example.androidsaxxml;
 
 import java.io.InputStream;
 import java.util.HashMap;
 import java.util.List;
 
 import android.app.Activity;
 import android.os.Bundle;
 import android.view.View;
 import android.widget.Button;
 
 import com.example.androidsaxxml.http.HttpUtils;
 import com.example.androidsaxxml.service.SaxService;
 
 
 public class MainActivity extends Activity {
     private Button button;
     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.activity_main);
         
         button=(Button)findViewById(R.id.button1);
         button.setOnClickListener(new View.OnClickListener() {
             
             @Override
             //点击按钮，开启线程訪问网络
             public void onClick(View v) {
                 Thread thread=new Thread(new Runnable() {
                     
                     @Override
                     public void run() {
                         // 设置XML文档的路径
                         String path="http://192.168.1.112:8080/smyhvae.xml";
                         //调用类HttpUtils：从server上获取XML流。
                         InputStream inputStream=HttpUtils.getXML(path);
                         try {
                             //调用类SaxService：解析流。同一时候设定须要解析的节点
                             List<HashMap<String, String>> list=SaxService.readXML(inputStream, "person");
                             for(HashMap<String,String> map:list)
                             {
                                 //打印到LogCat中
                                 System.out.println(map.toString());
                             }
                         } catch (Exception e) {
                             // TODO: handle exception
                         }
                     }
                 });
                 thread.start();                
             }
         });        
     }
 }

当点击按钮后。XML解析后的内容会把打印到日志中: