一.基础知识
在《Android XML解析学习——Sax方式》和《Android XML解析学习——Sax方式(续)》中我们学习了在Android 平台上使用SAX的方式解析XML文档的方法。除了SAX的方式,还有一种常用的为DOM(Document Object Model文档对象模型)方式。
DOM方式解析XML的过程为首先将所有 XML 文档读取到内存中,构造一个树结构,然后允许使用 DOM API 来操作整个树结构,包括遍历 XML 树、检索所需的数据等。
Android平台使用Java SDK中的API来实现DOM方式的解析,具体的方法和之前学习的使用Java SDK中的SAX方式解析XML类似,因此有了前面SAX的基础,学习DOM方式就会比较简单了。DOM 和 之前的SAX 的主要差别是 API 本身的结构,SAX 由基于事件的回调集组成,边解析边产生事件从而调用事件处理器的回调函数进行处理。而DOM不是,DOM直接读取整个XML树保存为Document类,因此只需处理保存在内存中的Document对象即可,没有回调函数。
DOM解析相关的包为javax.xml.parsers和org.w3c.dom。其中javax.xml.parsers提供Document构造器工厂DocumentBuilderFactory和Document构造器DocumentBuilder,DocumentBuilderFactory实例调用newDocumentBuilder()创建构造器DocumentBuilder实例,然后该实例就可以调用parse方法来返回一个解析为Document类的实例。Document 类由表示XML文档的包含元素、属性、文本内容等的各个节点组成。因此有了Document对象后就可以按需要获取xml文档中各个子节点及其相关的值了。Document、Element、Node等各个和DOM相关的具体部分都在org.w3c.dom包中,因此和SAX类似,org.w3c.dom包是底层具体的负责DOM解析相关的内容,并且为上层javax.xml.parsers包提供DOM解析器等相关调用。
下面我们就用上面介绍的DOM方式来实现解析XML形式的USGS地震数据的Demo例子。
二.实例开发
我们要完成的效果图如下图1所示:
图1 ListView列表显示的地震数据
和上一部分Demo例子的一样,也是解析完地震数据后用ListView列表的方式显示每条地震的震级和地名信息。
新建一个Android工程AndroidXMLDemoDom。
要添加的基本内容和上一个Demo中的一样,这里就不再赘述,这次要添加的解析器新类为DomEarthquakeHandler,内容如下所示:
[java] view plaincopyprint?
- public class DomEarthquakeHandler {
- //xml解析用到的Tag
- private String kEntryElementName = "entry";
- private String kLinkElementName = "link";
- private String kLinkAttributeName = "href";
- private String kTitleElementName = "title";
- private String kUpdatedElementName = "updated";
- private String kGeoRSSPointElementName = "georss:point";
- private String kGeoRSSElevElementName = "georss:elev";
- //用于保存xml解析获取的结果
- private ArrayList<EarthquakeEntry> earthquakeEntryList;
- private EarthquakeEntry earthquakeEntry = null;
- //解析xml数据
- public ArrayList<EarthquakeEntry> parse(InputStream inStream)
- {
- earthquakeEntryList = new ArrayList<EarthquakeEntry>();
- //创建DocumentBuilder
- DocumentBuilderFactory docBFactory = DocumentBuilderFactory.newInstance();
- DocumentBuilder docBuilder = null;
- try {
- docBuilder = docBFactory.newDocumentBuilder();
- } catch (ParserConfigurationException e1) {
- // TODO Auto-generated catch block
- e1.printStackTrace();
- }
- //解析地震数据流.
- Document doc = null;
- try {
- doc = docBuilder.parse(inStream);
- } catch (SAXException e1) {
- // TODO Auto-generated catch block
- e1.printStackTrace();
- } catch (IOException e1) {
- // TODO Auto-generated catch block
- e1.printStackTrace();
- }
- Element docEle = doc.getDocumentElement();
- // Get a list of each earthquake entry.
- NodeList nList = docEle.getElementsByTagName(kEntryElementName);
- if(nList != null && nList.getLength() > 0)
- {
- for(int i=0; i < nList.getLength(); i++)
- {
- try {
- Element entry = (Element)nList.item(i);
- Element title = (Element)entry.getElementsByTagName(kTitleElementName).item(0);
- Element when = (Element)entry.getElementsByTagName(kUpdatedElementName).item(0);
- Element gpoint = (Element)entry.getElementsByTagName(kGeoRSSPointElementName).item(0);
- Element gelev = (Element)entry.getElementsByTagName(kGeoRSSElevElementName).item(0);
- Element link = (Element)entry.getElementsByTagName(kLinkElementName).item(0);
- String details = title.getFirstChild().getNodeValue();
- String point = gpoint.getFirstChild().getNodeValue();
- String elevS = gelev.getFirstChild().getNodeValue();
- String date = when.getFirstChild().getNodeValue();
- //获取link链接
- String webLink = link.getAttribute(kLinkAttributeName);
- // Log.v("Dom", webLink);
- //构造更新时间
- SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd'T'hh:mm:ss'Z'");
- Date qdate = new GregorianCalendar(0,0,0).getTime();
- try {
- qdate = sdf.parse(date);
- } catch (ParseException e) {
- e.printStackTrace();
- }
- //提取经纬度信息
- String[] latLongitude = point.split(" ");
- Location location = new Location("dummyGPS");
- location.setLatitude(Double.parseDouble(latLongitude[0]));
- location.setLongitude(Double.parseDouble(latLongitude[1]));
- //提取强度信息
- String magnitudeString = details.split(" ")[1];
- int end = magnitudeString.length()-1;
- double magnitude = Double.parseDouble(magnitudeString.substring(0, end));
- //提取位置信息
- String place = details.split(",")[1].trim();
- //提取海拔高度信息
- double evel;
- //因为USGS数据有可能会输错,比如为"--10000",多了一个"-"号
- try {
- evel = Double.parseDouble(elevS);
- } catch (Exception e) {
- // TODO: handle exception
- e.printStackTrace();
- evel = 0;
- }
- Log.v("Dom_Elev", String.valueOf(evel));
- earthquakeEntry = new EarthquakeEntry(qdate, place, webLink, location, magnitude, evel);
- earthquakeEntryList.add(earthquakeEntry);
- } catch (Exception e) {
- // TODO: handle exception
- e.printStackTrace();
- }
- }
- }
- Log.v("Dom", "End");
- return earthquakeEntryList;
- }
- }
程序首先也是定义解析时需要用到的元素Tag名称变量,其中因为DOM没有像SAX方式那样可以把一个元素的的名称分开为表示名称空间的Uri和当前标签名的localname,只是通过getElementsByTagName方法由完整的名称读取,因此需要定义完整的元素标签名称:
[java] view plaincopyprint?
- private String kGeoRSSPointElementName = "georss:point";
- private String kGeoRSSElevElementName = "georss:elev";
在定义的用于解析xml数据的方法中
public ArrayList<EarthquakeEntry> parse(InputStream inStream)
使用工厂类创建Document构造器DocumentBuilder:
[java] view plaincopyprint?- //创建DocumentBuilder
- DocumentBuilderFactory docBFactory = DocumentBuilderFactory.newInstance();
- DocumentBuilder docBuilder = null;
- try {
- docBuilder = docBFactory.newDocumentBuilder();
- } catch (ParserConfigurationException e1) {
- // TODO Auto-generated catch block
- e1.printStackTrace();
- }
然后调用DocumentBuilder实例的parse方法解析xml文档数据并返回Document对象,并通过getDocumentElement()方法获取文档的根元素。
[java] view plaincopyprint?
- //解析地震数据流.
- Document doc = null;
- try {
- doc = docBuilder.parse(inStream);
- } catch (SAXException e1) {
- // TODO Auto-generated catch block
- e1.printStackTrace();
- } catch (IOException e1) {
- // TODO Auto-generated catch block
- e1.printStackTrace();
- }
- Element docEle = doc.getDocumentElement();
有了XML文档的根元素,就可以通过getElementsByTagName等方法获取具体的子元素,及子节点和节点值等。具体方法可以参考以上的代码。
最后添加AndroidXMLDemoDom.java文件中的内容,内容和前一个Demo工程AndroidXMLDemoSaxII中的AndroidXMLDemoSaxII.java基本一样,
[java] view plaincopyprint?- public class AndroidXMLDemoDom extends Activity {
- /** Called when the activity is first created. */
- //定义显示的List相关变量
- ListView list;
- ArrayAdapter<EarthquakeEntry> adapter;
- ArrayList<EarthquakeEntry> earthquakeEntryList;
- @Override
- public void onCreate(Bundle savedInstanceState) {
- super.onCreate(savedInstanceState);
- setContentView(R.layout.main);
- //获取地震数据流
- InputStream earthquakeStream = readEarthquakeDataFromFile();
- //Dom方式进行xml解析
- DomEarthquakeHandler domHandler = new DomEarthquakeHandler();
- earthquakeEntryList = domHandler.parse(earthquakeStream);
- //用ListView进行显示
- list = (ListView)this.findViewById(R.id.list);
- adapter = new ArrayAdapter<EarthquakeEntry>(this, android.R.layout.simple_list_item_1, earthquakeEntryList);
- list.setAdapter(adapter);
- }
- private InputStream readEarthquakeDataFromFile()
- {
- //从本地获取地震数据
- InputStream inStream = null;
- try {
- inStream = this.getAssets().open("USGS_Earthquake_1M2_5.xml");
- } catch (IOException e) {
- // TODO Auto-generated catch block
- e.printStackTrace();
- }
- return inStream;
- }
- private InputStream readEarthquakeDataFromInternet()
- {
- //从网络上获取实时地震数据
- URL infoUrl = null;
- InputStream inStream = null;
- try {
- infoUrl = new URL("http://earthquake.usgs.gov/earthquakes/catalogs/1day-M2.5.xml");
- URLConnection connection = infoUrl.openConnection();
- HttpURLConnection httpConnection = (HttpURLConnection)connection;
- int responseCode = httpConnection.getResponseCode();
- if(responseCode == HttpURLConnection.HTTP_OK)
- {
- inStream = httpConnection.getInputStream();
- }
- } catch (MalformedURLException e) {
- // TODO Auto-generated catch block
- e.printStackTrace();
- } catch (IOException e) {
- // TODO Auto-generated catch block
- e.printStackTrace();
- }
- return inStream;
- }
- }
只是把进行XML解析的部分换成了如下方式:
[java] view plaincopyprint?- //Dom方式进行xml解析
- DomEarthquakeHandler domHandler = new DomEarthquakeHandler();
- earthquakeEntryList = domHandler.parse(earthquakeStream);
完成了,可以保存运行看下效果。
这样我们就已经学习了Android上使用SAX和DOM两种方式解析XML的方法,下面我们简单总结比较一下两者的区别。
DOM解析器是通过将XML文档解析成树状模型并将其放入内存来完成解析工作的,而后对文档的操作都是在这个树状模型上完成的。这个在内存中的文档树将是 文档实际大小的几倍。这样做的好处是结构清除、操作方便,而带来的麻烦就是极其耗费系统资源。而SAX正好克服了DOM的缺点。SAX解析器的处理过程是 通读整个文档,根据文档内容产生事件,而把对这些事件的处理交由事件处理器处理。SAX不需要在内存中保存整个文档,它对系统资源的节省是显而易见的。这 样在一些需要处理大型XML文档和性能要求比较高的场合就要用SAX了。
我们以表格的形式看一下他们在一些方面的比较:
SAX |
DOM |
顺序读入文档并产生相应事件,可以处理任何大小的XML文档 |
在内存中创建文档树,不适于处理大型XML文档 |
只能对文档按顺序解析一遍,不支持对文档的随意访问 |
可以随意访问文档树的任何部分,没有次数限制 |
只能读取XML文档内容,而不能修改 |
可以随意修改文档树,从而修改XML文档 |
开发上比较复杂,需要自己来实现事件处理器 |
易于理解,易于开发 |
通过比较我们可以知道SAX和DOM各自适合的场合:
SAX适于处理下面的问题:
1. 对大型文档进行处理
2. 只需要文档的部分内容,或者只需要从文档中得到特定信息
DOM适合处理下面的问题:
1. 需要对文档进行修改
2. 需要随机对文档进行访问
以上只是对SAX和DOM方式传统的比较,而对具体的在Android平台上使用来说,因为DOM更加占用内存,而对运行在移动设备上的Android系统来说往往内存是一个比较稀缺的资源,因此除非XML 文档始终保持很小的大小,否则相对来说推荐在Android 应用程序中使用SAX 方式解析XML 。并且Android系统为SAX还提供了额外的实用工具android.util.Xml和特有的包android.sax等,因此实际上在Android使用SAX也一样很方便了。
三.总结
在这部分中我们学习了使用DOM方式解析XML的方法,并且比较了DOM方式和SAX方式的各种特点及区别。
从以上的学习我们知道Android平台已经为XML的解析提供了强大的功能,既可以使用Java SDK中的SAX和DOM方式来解析,还可以使用Android SDK提供的SAX方式。但Android平台上还有一种解析XML的方式,就是使用Pull解析器,这部分内容我们以后接着学习。