一、在Android应用中的XML文件来源
1、本地xml文件
本地XML文件可以放在应用根目录assets文件夹、res/xml、res/raw、SDcard卡、应用的data目录等;
除res/xml可直接通过getXml(int id)获取XML文档,返回一个解析器对象(XmlResourceParer:
XmlResourceParer是XmlPullParser的子类),其它位置情况都可以获取XML文档,返回一个Inputstream对象,进行读取数据,获取方法分别如下:
a.在res/xml目录下(推荐使用):
- XmlResourceParser xmlParser = this.getResources().getXml(R.xml.XXX);
b.在res/xml、res/raw目录下:
- InputStream inputStream = this.getResources().openRawResource(R.xml.XXX);
c.在assets文件夹下(本人测试发现通过此方法获取的XML文档不能带有首行:<?xml version="1.0" encoding="utf-8"?>,否则解析报错,具体原因未查明,知道原因请回复交流):
- InputStream inputStream = getResources().getAssets().open(fileName);
d.在应用指定目录下(SDcard,应用data目录等):
- // path路径根据实际项目修改,此次获取SDcard根目录
- String path = Environment.getExternalStorageDirectory().toString();
- File xmlFlie = new File(path+fileName);
- InputStream inputStream = new FileInputStream(xmlFlie);
2、通过url得到的xml文件
很多时候需要解析xml文件都用于客户端与服务器之间的数据交互,比如解析google天气预报信息,或自己项目内定的一些XML数据结构,其中通过URL,使用DefaultHTTPClient get请求获取XML文件方法如下:
- /**
- * 读取url的xml资源 转成String
- * @param url
- * @return 返回 读取url的xml字符串
- */
- public String getStringByUrl(String url) {
- String outputString = "";
- // DefaultHttpClient
- DefaultHttpClient httpclient = new DefaultHttpClient();
- // HttpGet
- HttpGet httpget = new HttpGet(url);
- // ResponseHandler
- ResponseHandler<String> responseHandler = new BasicResponseHandler();
- try {
- outputString = httpclient.execute(httpget, responseHandler);
- outputString = new String(outputString.getBytes("ISO-8859-1"), "utf-8"); // 解决中文乱码
- Log.i("HttpClientConnector", "连接成功");
- } catch (Exception e) {
- Log.i("HttpClientConnector", "连接失败");
- e.printStackTrace();
- }
- httpclient.getConnectionManager().shutdown();
- return outputString;
- }
二、XML文件的解析方式
能够运用在Android系统上解析XML文件的常用有三种方式:DOM、SAX和PULL,其中DOM解析XML是先把XML文件读进内存中,再通过接口获取数据,该方法使用相对小的XML文件,移动设备往往受硬件性能影响,如果XML文件比较大使用DOM解析往往效率跟不上;SAX和PULL都是采用事件驱动方式来进行解析,在Android中的事件机制是基于回调函数。
本例旨在考虑简单方便性,综合考虑选择了PULL解析,PULL解析器是一个开源项目,Android平台已经内置了PULL解析器,同时Android系统本身也是使用PULL解析器来解析各种XML文档。
1、事件回调类型
PULL解析XML文件时,回调XmlResourceParser内定义表示文档开头结束和节点开头结束的数值(事件回调类型),表示如下:
a.读取到XML文档开头(声明)返回:XmlPullParser.
START_DOCUMENT(0)
b.读取到XML文档结束返回:XmlPullParser.
END_DOCUMENT (1)
c.读取到XML节点开始返回:XmlPullParser.
START_TAG (2)
d.读取到XML节点结束返回:XmlPullParser.
END_TAG (3)
e.读取到XML文本返回:XmlPullParser.
TEXT (4)
2、XmlPullParser有几个主要方法(更多查阅Android APIs):
a.XmlPullParser.
getEventType() : Returns the type of the current event (START_TAG, END_TAG, TEXT, etc.) 【获取当前事件回调类型】
b.XmlPullParser.
getName():For START_TAG or END_TAG events, the (local) name of the current element is returned when namespaces are enabled.【获取当前节点名字】
c.XmlPullParser.
getAttributeValue(int index):Returns the given attributes value.【根据id获取节点属性值】
d.XmlPullParser.
getAttributeValue(String namespace, String name):Returns the attributes value identified by namespace URI and namespace localName.【根据name获取节点属性值】
e.XmlPullParser.
netxText():If current event is START_TAG then if next element is TEXT then element content is returned or if next event is END_TAG then empty string is returned, otherwise exception is thrown.【回调节点START_TAG时,通过此方法获取节点内容】
3、实际编码中如何使用
在实际编码中,主要根据事件回调类型,结合被解析的XML结构进行解析提取数据,PULL解析XML文件的主要模式如下,更具体使用看本文提供的例子:
- try {
- //开始解析事件
- int eventType = parser.getEventType();
- //处理事件,不碰到文档结束就一直处理
- while (eventType != XmlPullParser.END_DOCUMENT) {
- //因为定义了一堆静态常量,所以这里可以用switch
- switch (eventType) {
- case XmlPullParser.START_DOCUMENT:
- // 不做任何操作或初开始化数据
- break;
- case XmlPullParser.START_TAG:
- // 解析XML节点数据
- // 获取当前标签名字
- String tagName = parser.getName();
- if(tagName.equals("XXXTAGXXX")){
- // 通过getAttributeValue 和 netxText解析节点的属性值和节点值
- }
- break;
- case XmlPullParser.END_TAG:
- // 单节点完成,可往集合里边添加新的数据
- break;
- case XmlPullParser.END_DOCUMENT:
- break;
- }
- // 别忘了用next方法处理下一个事件,不然就会死循环
- eventType = parser.next();
- }
- } catch (XmlPullParserException e) {
- e.printStackTrace();
- }catch (IOException e) {
- e.printStackTrace();
- }
三、运用例子
本例主要是解析我国省市的XML文件,文件结构简单,本例采用资源数据地址:http://www.csw333.com/CityScene_I/getPlace.php,关于XML的结构基础之类的就不再累赘,实际项目中,根据XML文件的节点结果来进行变换,主要修改case XmlPullParser.START_TAG部分代码。
1.本例在获取XML文件的省份中,比较了获取三个不同位置的XML文件资源的读取方式;
2.再获取url上的XML文件时,返回的字符串进行utf-8转码,避免中文乱码(本例采用的url资源数据需要转码);
3.针对实际项目中,若xml文件过大,可以使用多线程进行解析,避免ANR,若解析时间较长,可以添加滚动提示;
4.本例存在个Bug,根据例子使用的XML文件结构把直辖市也编进省份中,例子目的是解析XML文件,实际项目是需要避免;
5.
主要代码:
a.各种获取XML文件资源方式
- /**
- * 同样删除首行,才能解析成功,
- * @param fileName
- * @return 返回xml文件的inputStream
- */
- public InputStream getInputStreamFromAssets(String fileName){
- try {
- InputStream inputStream = getResources().getAssets().open(fileName);
- return inputStream;
- } catch (IOException e) {
- e.printStackTrace();
- }
- return null;
- }
- /**
- * 读取XML文件,xml文件放到res/xml文件夹中,若XML为本地文件,则推荐该方法
- *
- * @param fileName
- * @return : 读取到res/xml文件夹下的xml文件,返回XmlResourceParser对象(XmlPullParser的子类)
- */
- public XmlResourceParser getXMLFromResXml(String fileName){
- XmlResourceParser xmlParser = null;
- try {
- //*/
- // xmlParser = this.getResources().getAssets().openXmlResourceParser("assets/"+fileName); // 失败,找不到文件
- xmlParser = this.getResources().getXml(R.xml.provinceandcity);
- /*/
- // xml文件在res目录下 也可以用此方法返回inputStream
- InputStream inputStream = this.getResources().openRawResource(R.xml.provinceandcity);
- /*/
- return xmlParser;
- } catch (Exception e) {
- e.printStackTrace();
- }
- return xmlParser;
- }
- /**
- * 读取url的xml资源 转成String
- * @param url
- * @return 返回 读取url的xml字符串
- */
- public String getStringByUrl(String url) {
- String outputString = "";
- // DefaultHttpClient
- DefaultHttpClient httpclient = new DefaultHttpClient();
- // HttpGet
- HttpGet httpget = new HttpGet(url);
- // ResponseHandler
- ResponseHandler<String> responseHandler = new BasicResponseHandler();
- try {
- outputString = httpclient.execute(httpget, responseHandler);
- outputString = new String(outputString.getBytes("ISO-8859-1"), "utf-8"); // 解决中文乱码
- Log.i("HttpClientConnector", "连接成功");
- } catch (Exception e) {
- Log.i("HttpClientConnector", "连接失败");
- e.printStackTrace();
- }
- httpclient.getConnectionManager().shutdown();
- return outputString;
- }
- /**
- * 解析SDcard xml文件
- * @param fileName
- * @return 返回xml文件的inputStream
- */
- public InputStream getInputStreamFromSDcard(String fileName){
- try {
- // 路径根据实际项目修改
- String path = Environment.getExternalStorageDirectory().toString() + "/test_xml/";
- Log.v("", "path : " + path);
- File xmlFlie = new File(path+fileName);
- InputStream inputStream = new FileInputStream(xmlFlie);
- return inputStream;
- } catch (IOException e) {
- e.printStackTrace();
- }
- return null;
- }
b.多线程解析:
- /**
- * 多线程加载网络端的xml,若xml文件过大也需要用该方式加载
- */
- Handler mHandler = new Handler();
- Runnable mRunnable = new Runnable() {
- public void run() {
- if(!isFinishParser){
- mHandler.postDelayed(mRunnable, 1000);
- }else{
- showView.setText(provinceStr);
- mHandler.removeCallbacks(mRunnable);
- }
- }
- };
- /**
- * 比较耗时操作新建一个线程,避免UI线程ANR
- */
- public void parserWhitThread(){
- new Thread(){
- @Override
- public void run() {
- provinceandcityStr = getStringByUrl(provinceAndCityUrl);
- provinceArray = ProvincePullParse.Parse(provinceandcityStr);
- for(Province pro : provinceArray){
- provinceStr += pro.getProvinceId() + " : " +pro.getProvinceName()+"\n";
- }
- isFinishParser = true;
- }
- }.start();
- }
c.从XML文件中解析出城市:
- public static ArrayList<City> ParseXml(XmlPullParser parser){
- ArrayList<City> CityArray = new ArrayList<City>();
- City CityTemp = null;
- int provinceId = 0;
- int cityId;
- String cityName;
- try {
- //开始解析事件
- int eventType = parser.getEventType();
- //处理事件,不碰到文档结束就一直处理
- while (eventType != XmlPullParser.END_DOCUMENT) {
- //因为定义了一堆静态常量,所以这里可以用switch
- switch (eventType) {
- case XmlPullParser.START_DOCUMENT:
- break;
- case XmlPullParser.START_TAG:
- //给当前标签起个名字
- String tagName = parser.getName();
- // Log.d("", "====XmlPullParser.START_TAG=== tagName: " + tagName);
- if(tagName.equals("province")){
- provinceId = Integer.parseInt(parser.getAttributeValue(0));
- }else if(tagName.equals("item")){
- CityTemp = new City();
- }else if(tagName.equals("id")){
- cityId = Integer.parseInt(parser.nextText());
- parser.next();
- cityName = parser.nextText();
- Log.v("", "id getText: "+cityId);
- Log.v("", "name getText: "+cityName);
- Log.e("", "=========================");
- CityTemp.setProvinceId(provinceId);
- CityTemp.setCityId(cityId);
- CityTemp.setCityName(cityName);
- CityArray.add(CityTemp);
- }
- break;
- case XmlPullParser.END_TAG:
- break;
- case XmlPullParser.END_DOCUMENT:
- break;
- }
- //别忘了用next方法处理下一个事件,忘了的结果就成死循环#_#
- eventType = parser.next();
- }
- } catch (XmlPullParserException e) {
- // TODO Auto-generated catch block
- e.printStackTrace();
- }catch (IOException e) {
- // TODO Auto-generated catch block
- e.printStackTrace();
- }
- return CityArray;
- }
源码下载:
参考引用
1.谷歌天气预报:
http://android.yaohuiji.com/archives/935
2.android解析xml文件的三种方式:
http://www.cnblogs.com/zhangdongzi/archive/2011/04/14/2016434.html