Android使用XML全攻略(1)

Android使用XML全攻略(1)

  

Android 是针对移动设备的一种新兴的开源操做系统和 SDK。借助它，您能够建立功能强大的移动应用程序。当您的应用程序能够访问 Web 服务时，其吸引力会大大增长，这意味着您须要使用 Web 语言：XML。在本文中，您将了解在 Android 上使用 XML 的不一样方法，以及如何使用它们构建本身的 Android 应用程序。

 

入门

在本文中，您将学习如何构建经过 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上添加了一些便捷的特性。