Android使用XML全攻略(1)

入门

在本文中，您将学习如何构建通过 Internet 使用 XML 的 Android 应用程序。Android 应用程序是使用 Java™ 编程语言编写的，因此具备 Java 技术方面的经验是必需的。要进行 Android 开发，您需要使用 android sdk。本文中的所有代码适用于任何版本的 Android SDK，但 SDK 1.5_pre 是用于开发代码的。您可以使用 SDK 和一个文本编辑器来开发 Android 应用程序，但使用Android Developer Tools (ADT)（一款 Eclipse 插件）会更加简单。在本文中，我们使用 0.9 版本的 ADT 和 Eclipse 3.4.2, Java 版本。有关所有这些工具的链接，请参见参考资料。

Android上的XML

Android 平台是一个开源移动开发平台。它允许您访问各种移动设备的所有方面，这些移动设备从低级图形设备到手机摄像头上的硬件不一而足。由于 Android 可以实现这么丰富的功能，因此您可能想知道为何还要为 XML 伤脑筋呢。并不是因为使用 XML 是多么地有趣；而是因为它能提供一些特殊的支持。XML经常用作 Internet上的一种数据格式。如果您希望通过 Internet 访问数据，则数据很有可能是 XML 格式。如果您希望发送数据给 Web 服务，那么您可能也需要发送 XML。简而言之，如果您的Android应用程序将利用 Internet，那么您可能需要使用 XML。幸运的是，您可以采用多种方法在Android上使用 XML。

XML 解析器常用缩略语

API：应用程序编程接口（Application programming interface）
RSS：Really Simple Syndication
SDK：软件开发包（Software Developers Kit）
UI：用户界面（User interface）
URL：通用资源定位符（Universal Resource Locator）
XML：可扩展标记语言（Extensible Markup Language）

Android 平台最大的一个优势在于它利用了 Java 编程语言。Android SDK 并未向您的标准 Java Runtime Environment (JRE) 提供一切可用功能，但它支持其中很大一部分功能。Java 平台支持通过许多不同的方式来使用 XML，并且大多数与 XML 相关的 Java API 在 Android 上得到了完全支持。举例来说，Java 的 Simple API for XML (SAX) 和 Document Object Model (DOM) 在 Android 上都是可用的。这些 API 多年以来一直都是 Java 技术的一部分。较新的 Streaming API for XML (StAX) 在 Android 中并不可用。但是， Android 提供了一个功能相当的库。最后，Java XML Binding API 在 Android 中也不可用。这个 API 已确定可以在 Android 中实现。但是，它更倾向于是一个重量级的 API，需要使用许多不同类的实例来表示 XML 文档。因此，这对于受限的环境，比如说 Android 针对的手持设备，不太理想。在后续小节中，我们将以 Internet 上的一个简单的 XML 源为例，来看看如何在 Android 应用程序中使用上述各种 API 来解析它。首先，我们来看看这个简单应用程序的主要部分，它将通过 Internet 来使用 XML。

Android 新闻阅读器

应用程序将从热门 Android 开发人员站点 Androidster 获取一个 RSS 提要，并将它解析为一组简单的 Java 对象，您可以使用这些对象构建一个 Android ListView（参见下载部分获取源代码）。这是一种典型的多态行为 — 提供相同行为的不同实现（不同的 XML 解析算法）。清单 1 展示了如何在 Java 代码中使用一个接口建立这一模型。

清单 1. XML 提要解析器接口[size=0.76em]

package org.developerworks.android; 
import java.util.List; 
public interface FeedParser { 
List<Message> parse(); 
}

在清单2中，Message 类是一个典型的 Plain Old Java Object (POJO)，它表示一种数据结构。
清单 2. Message POJO

public class Message implements Comparable<Message>{ 
static SimpleDateFormat FORMATTER = 
new SimpleDateFormat("EEE, dd MMM yyyy HH:mm:ss Z"); 
private String title; 
private URL link; 
private String description; 
private Date date; 
// getters and setters omitted for brevity 
public void setLink(String link) { 
try { 
this.link = new URL(link); 
} catch (MalformedURLException e) { 
throw new RuntimeException(e); 
} 
} 
public String getDate() { 
return FORMATTER.format(this.date); 
} 
public void setDate(String date) { 
// pad the date if necessary 
while (!date.endsWith("00")){ 
date += "0"; 
} 
try { 
this.date = FORMATTER.parse(date.trim()); 
} catch (ParseException e) { 
throw new RuntimeException(e); 
} 
} 
@Override 
public String toString() { 
// omitted for brevity 
} 
@Override 
public int hashCode() { 
// omitted for brevity 
} 
@Override 
public boolean equals(Object obj) { 
// omitted for brevity 
} 
// sort by date 
public int compareTo(Message another) { 
if (another == null) return 1; 
// sort descending, most recent first 
return another.date.compareTo(date); 
} 
}

清单 2 中的消息基本上是相当直观的。通过允许日期和链接作为简单的对象被访问，同时将它们表示为较强类型的对象（java.util.Date 和 java.net.URL），它隐藏了一些内部状态。它是一个典型的 Value Object，因此它基于其内部状态实现了equals() 和 hashCode()。它还实现了Comparable 接口，因此您可以使用它进行排序（按日期）。在实践中，提要中的数据始终是有序的，因为没有必要再进行排序。

每个解析器实现都需要提供一个URL给Androidster提要，并使用它打开一个到Androidster站点的HTTP连接。这一常见行为自然是在 Java 代码中建模，我们使用了一个抽象基类，如清单3所示。

清单 3. 基本提要解析器类

public abstract class BaseFeedParser implements FeedParser { 
// names of the XML tags 
static final String PUB_DATE = "pubDate"; 
static final String DESCRIPTION = "description"; 
static final String LINK = "link"; 
static final String TITLE = "title"; 
static final String ITEM = "item"; 
final URL feedUrl; 
protected BaseFeedParser(String feedUrl){ 
try { 
this.feedUrl = new URL(feedUrl); 
} catch (MalformedURLException e) { 
throw new RuntimeException(e); 
} 
} 
protected InputStream getInputStream() { 
try { 
return feedUrl.openConnection().getInputStream(); 
} catch (IOException e) { 
throw new RuntimeException(e); 
} 
} 
}

基类存储 feedUrl 并使用它打开了一个 java.io.InputStream。如果出现任何差错，它会抛出一个 RuntimeException，造成应用程序出现故障。基类还为标记的名称定义了一些简单的常量。清单 4 显示了提要中的一些示例内容，以便于您理解这些标记的重要性。

清单 4.示例XML提要

<?xml version="1.0" encoding="UTF-8"?> 
<!-- generator="FeedCreator 1.7.2" --> 
<rss version="2.0"> 
<channel> 
<title>android_news</title> 
<description>android_news</description> 
<link><a href=""http://www.androidster.com/android_news.php</link>"" target=""_blank"">http://www.androidster.com/android_news.php</link></a> 
<lastBuildDate>Sun, 19 Apr 2009 19:43:45 +0100</lastBuildDate> 
<generator>FeedCreator 1.7.2</generator> 
<item> 
<title>Samsung S8000 to Run Android, Play DivX, Take Over the 
World</title> 
<link><a href=""http://www.androidster.com/android_news/samsung-s8000-to-run-android-"" target=""_blank"">http://www.androidster.com/andro ... 000-to-run-android-</a> 
play-divx-take-over-the-world</link> 
<description>More details have emerged on the first Samsung handset 
to run Android. A yet-to-be announced phone called the S8000 is being 
reported ...</description> 
<pubDate>Thu, 16 Apr 2009 07:18:51 +0100</pubDate> 
</item> 
<item> 
<title>Android Cupcake Update on the Horizon</title> 
<link><a href=""http://www.androidster.com/android_news/android-cupcake-update-"" target=""_blank"">http://www.androidster.com/android_news/android-cupcake-update-</a> 
on-the-horizon</link> 
<description>After months of discovery and hearsay, the Android 
build that we have all been waiting for is about to finally make it 
out ...</description> 
<pubDate>Tue, 14 Apr 2009 04:13:21 +0100</pubDate> 
</item> 
</channel> 
</rss>

如清单4中的示例所示，一个ITEM对应于一个Message实例。项目的子节点（TITLE、LINK 等）对应于 Message 实例的属性。现在，您已经对提要有了一定的认识，并且已经创建了所有常用部分，接下来看看如何使用 Android 上可用的各种技术来解析这个提要。您将从 SAX 开始。

使用 SAX

在Java环境中，当您需要一个速度快的解析器并且希望最大限度减少应用程序的内存占用时，通常可以使用 SAX API。这非常适用于运行 Android 的移动设备。您可以在 Java 环境中照原样使用 SAX API，在 Android 上运行它不需要做任何修改。清单 5 显示了FeedParser 接口的一个 SAX 实现。

清单 5. SAX 实现

public class SaxFeedParser extends BaseFeedParser { 
protected SaxFeedParser(String feedUrl){ 
super(feedUrl); 
} 
public List<Message> parse() { 
SAXParserFactory factory = SAXParserFactory.newInstance(); 
try { 
SAXParser parser = factory.newSAXParser(); 
RssHandler handler = new RssHandler(); 
parser.parse(this.getInputStream(), handler); 
return handler.getMessages(); 
} catch (Exception e) { 
throw new RuntimeException(e); 
} 
} 
}

如果您以前使用过 SAX，那么这对您肯定非常熟悉。与任何 SAX 实现相同，大多数细节都在 SAX 处理程序中。在分解 XML 文档时，处理程序从 SAX 解析器接收事件。在本例中，您创建了一个新的名称为 RssHandler 的类，并将它注册为解析器的处理程序，如清单 6 所示。

清单 6. SAX 处理程序

import static org.developerworks.android.BaseFeedParser.*; 
public class RssHandler extends DefaultHandler{ 
private List<Message> messages; 
private Message currentMessage; 
private StringBuilder builder; 
public List<Message> getMessages(){ 
return this.messages; 
} 
@Override 
public void characters(char[] ch, int start, int length) 
throws SAXException { 
super.characters(ch, start, length); 
builder.append(ch, start, length); 
} 
@Override 
public void endElement(String uri, String localName, String name) 
throws SAXException { 
super.endElement(uri, localName, name); 
if (this.currentMessage != null){ 
if (localName.equalsIgnoreCase(TITLE)){ 
currentMessage.setTitle(builder.toString()); 
} else if (localName.equalsIgnoreCase(LINK)){ 
currentMessage.setLink(builder.toString()); 
} else if (localName.equalsIgnoreCase(DESCRIPTION)){ 
currentMessage.setDescription(builder.toString()); 
} else if (localName.equalsIgnoreCase(PUB_DATE)){ 
currentMessage.setDate(builder.toString()); 
} else if (localName.equalsIgnoreCase(ITEM)){ 
messages.add(currentMessage); 
} 
builder.setLength(0); 
} 
} 
@Override 
public void startDocument() throws SAXException { 
super.startDocument(); 
messages = new ArrayList<Message>(); 
builder = new StringBuilder(); 
} 
@Override 
public void startElement(String uri, String localName, String name, 
Attributes attributes) throws SAXException { 
super.startElement(uri, localName, name, attributes); 
if (localName.equalsIgnoreCase(ITEM)){ 
this.currentMessage = new Message(); 
} 
} 
}

RssHandler 类扩展了 org.xml.sax.helpers.DefaultHandler 类。该类为 SAX 解析器生成的事件所对应的所有方法都提供了一个默认的非操作实现。这允许子类根据需要仅覆盖一些方法。RssHandler 提供了一个额外的 API，即 getMessages。它返回处理程序在从 SAX 解析器接收事件时所收集的 Message 对象列表。它有另外两个内部变量，currentMessage 针对被解析的 Message 实例，以及名称为 builder 的 StringBuilder 变量，用于存储文本节点中的字符数据。解析器将相应事件发送给处理程序时会调用 startDocument 方法，这两个变量的初始化操作就是在此时完成。

查看清单6中的startElement方法。在XML文档中每次遇到开始标记时都会调用它。您只关心该标记何时为ITEM标记。对于这种情况，您将创建一个新的Message。现在来看characters方法。遇到文本节点中的字符数据时便会调用此方法。数据只是被添加到builder变量中。最后，我们来看endElement方法。遇到结束标记时会调用此方法。对于与某Message属性相对应的标记，如TITLE和LINK，则使用builder变量中的数据在currentMessage上设置适当的属性。如果结束标记是一个ITEM，则currentMessage将被添加到Messages列表中。所有这些都是非常典型的SAX解析；此处的一切都不是Android所特有的。因此，如果您知道如何编写Java SAX解析器，则应该知道如何编写Android SAX解析器。但是，Android SDK确实在SAX上添加了一些便捷的特性。