最近开始学习android,使用的资料是IBM developerWorks的android开发的文章,个人觉得对android学习有很大的参考价值。在ibm中国上有中文版,但不知道是否翻译上的疏漏,还是由于android1.5版本以后的差异,文章中的代码在调试时总是有这样那样的问题(哪怕是一步一步照着文章做)。所以自己对其中的内容进行了一些整理,使后来者少走弯路。
一、构建 Android 手机 RSS 阅读器
1、在eclipse中新建andriod project,工程名:rss,sdk:android1.6,activity:main。
2、打开droid draw,设计一个界面,generate xml代码如下:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
android:id="@+id/widget28"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:orientation="vertical"
xmlns:android="http://schemas.android.com/apk/res/android"
>
<TextView
android:id="@+id/feedtitle"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:text="Android RSSReader"
>
</TextView>
<TextView
android:id="@+id/feedpubdate"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
>
</TextView>
<ListView
android:id="@+id/itemlist"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
>
</ListView>
</LinearLayout>
将xml代码复制粘贴到main.xml中(原来的内容删除)。
3、新建类RSSItem,这是个pojo类,映射了rss中的item元素:
public class RSSItem {
private String _title = null;
private String _description = null;
private String _link = null;
private String _category = null;
private String _pubdate = null;
RSSItem()
{
}
void setTitle(String title)
{
_title = title;
}
void setDescription(String description)
{
_description = description;
}
void setLink(String link)
{
_link = link;
}
void setCategory(String category)
{
_category = category;
}
void setPubDate(String pubdate)
{
_pubdate = pubdate;
}
String getTitle()
{
return _title;
}
String getDescription()
{
return _description;
}
String getLink()
{
return _link;
}
String getCategory()
{
return _category;
}
String getPubDate()
{
return _pubdate;
}
public String toString()
{
// limit how much text you display
if (_title.length() > 42)
{
return _title.substring(0, 42) + "...";
}
return _title;
}
}
4、新建pojo类RSSFeed,映射rss中的channel元素:
public class RSSFeed
{
private String _title = null;
private String _pubdate = null;
private int _itemcount = 0;
private List<RSSItem> _itemlist;
RSSFeed()
{
_itemlist = new Vector<RSSItem>(0);
}
int addItem(RSSItem item)
{
_itemlist.add(item);
_itemcount++;
return _itemcount;
}
RSSItem getItem(int location)
{
return _itemlist.get(location);
}
List<RSSItem> getAllItems()
{
return _itemlist;
}
int getItemCount()
{
return _itemcount;
}
void setTitle(String title)
{
_title = title;
}
void setPubDate(String pubdate)
{
_pubdate = pubdate;
}
String getTitle()
{
return _title;
}
String getPubDate()
{
return _pubdate;
}
}
5、新建helper类RSSHandler,用于对rss进行xml解析,并将解析结果包装为RSSFeed和RSSItem对象,方便在ui界面中显示:
public class RSSHandler extends DefaultHandler{//继承 DefaultHandler,方便进行 sax 解析
RSSFeed _feed; //临时变量,用于保存解析过程中的channel
RSSItem _item; //临时变量,用于保存解析过程中的item
//标记变量,用于标记在解析过程中我们关心的几个标签
int currentstate = 0; //若不是我们关心的标签,记做 0
final int RSS_TITLE = 1; //若是title标签,记做 1,注意有两个title,但我们都保存在_item的title成员变量中
final int RSS_LINK = 2; //若是link标签,记做 2
final int RSS_DESCRIPTION = 3; //若是description标签,记做 3
final int RSS_CATEGORY = 4; //若是category标签,记做 4
final int RSS_PUBDATE = 5; //若是pubdate标签,记做 5,注意有两个pubdate,但我们都保存在_item的pubdate成员变量中
RSSHandler()
{
}
RSSFeed getFeed()//通过这个方法把解析结果封装在 RSSFeed 对象中并返回
{
return _feed;
}
//下面通过重载 DefaultHandler 的 5 个方法来实现 sax 解析
public void startDocument() throws SAXException
{//这个方法在解析xml文档的一开始执行,一般我们需要在该方法中初始化解析过程中有可能用到的变量
_feed = new RSSFeed();
_item = new RSSItem();
}
public void endDocument() throws SAXException
{//这个方法在整个xml文档解析结束时执行,一般需要在该方法中返回或保存整个文档解析解析结果,但由于
//我们已经在解析过程中把结果保持在_feed中,所以这里什么也不做
}
public void startElement(String namespaceURI, String localName,String qName,
Attributes atts) throws SAXException
{//这个方法在解析标签开始标记时执行,一般我们需要在该方法取得标签属性值,但由于我们的rss文档
//中并没有任何我们关心的标签属性,因此我们主要在这里进行的是设置标记变量currentstate,以
//标记我们处理到哪个标签
if (localName.equals("channel"))
{//channel这个标签没有任何值得我们关心的内容,所以currentstate置为0
currentstate = 0;
return;
}
if (localName.equals("image"))
{//如果是image这个标签,说明channel元素的子元素title和pubdate都已经解析出来了
//(参考xml文件结构),那么应该把它们的值从_item转移到_feed,因为我们只是图方便才
//把它们存放在_item的成员中,实际上它们应该是_feed的成员
_feed.setTitle(_item.getTitle());
_feed.setPubDate(_item.getPubDate());
}
if (localName.equals("item"))
{//若是item标签,则重新构造一个RSSItem,从而把已有(已经解析过的)item数据扔掉,当
//然事先是已经保存到_feed的itemlist集合中了
_item = new RSSItem();
return;
}
if (localName.equals("title"))
{//若是title标签,置currentstate为1,表明这是我们关心的数据,这样在characters
//方法中会把元素内容保存到_item变量中
currentstate = RSS_TITLE;
return;
}
if (localName.equals("description"))
{//若是description标签,置currentstate为3,表明这是我们关心的数据,这样在characters
//方法中会把元素内容保存到_item变量中
currentstate = RSS_DESCRIPTION;
return;
}
if (localName.equals("link"))
{//若是description标签,置currentstate为2,表明这是我们关心的数据,这样在characters
//方法中会把元素内容保存到_item变量中
currentstate = RSS_LINK;
return;
}
if (localName.equals("category"))
{//若是description标签,置currentstate为4,表明这是我们关心的数据,这样在characters
//方法中会把元素内容保存到_item变量中
currentstate = RSS_CATEGORY;
return;
}
if (localName.equals("pubDate"))
{//若是description标签,置currentstate为5,表明这是我们关心的数据,这样在characters
//方法中会把元素内容保存到_item变量中
currentstate = RSS_PUBDATE;
return;
}
currentstate = 0;//如果不是上面列出的任何标签,置currentstate为0,我们不关心
}
public void characters(char ch[], int start, int length)
{//这个方法在解析标签内容(即开始标记-结束标记之间的部分)时执行,一般我们在里这获取元素体内容
String theString = new String(ch,start,length); //获取元素体内容
Log.i("RSSReader","characters[" + theString + "]");
switch (currentstate)//根据currentstate标记判断这个元素体是属于我们关心的哪个元素
{
case RSS_TITLE://若是title元素,放入_item的title属性
_item.setTitle(theString);
currentstate = 0;
break;
case RSS_LINK://若是link元素,放入_item的link属性
_item.setLink(theString);
currentstate = 0;
break;
case RSS_DESCRIPTION://若是description元素,放入_item的description属性
_item.setDescription(theString);
currentstate = 0;
break;
case RSS_CATEGORY://若是category元素,放入_item的category属性
_item.setCategory(theString);
currentstate = 0;
break;
case RSS_PUBDATE://若是pubdate元素,放入_item的pubdate属性
_item.setPubDate(theString);
currentstate = 0;
break;
default:
return;
}
}
public void endElement(String namespaceURI, String localName, String qName)
throws SAXException
{//这个方法在解析标签结束标记时执行,一般我们需要在该方法保存元素内容
if (localName.equals("item"))
{//item标签解析结束,把_item保存到_feed的itemlist属性中
_feed.addItem(_item);
return;
}
}
}
6、修改main.java,调用前面的类,从intentert获取rss列表并显示在ui上:
public class main extends Activity implements OnItemClickListener{
private RSSFeed feed = null;
private String tag=this.getClass().getName();
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
//调用getFeed方法,从服务器取得rss提要,strings.xml中定义了r.string.RSSFEEDOFCHOICE
feed = getFeed(this.getString(R.string.RSSFEEDOFCHOICE));
//把rss内容绑定到ui界面进行显示
UpdateDisplay();
}
private RSSFeed getFeed(String urlToRssFeed)
{//该方法通过url获得xml并解析xml内容为RSSFeed对象
try //异常处理
{
RSSHandler theRssHandler=new RSSHandler();
URL url = new URL(urlToRssFeed);
// 构建Sax解析工厂
SAXParserFactory factory = SAXParserFactory.newInstance();
// 使用Sax解析工厂构建Sax解析器
SAXParser parser = factory.newSAXParser();
// 使用Sax解析器构建xml Reader
XMLReader xmlreader = parser.getXMLReader();
// 构建自定义的RSSHandler作为xml Reader的处理器(或代理)
xmlreader.setContentHandler(theRssHandler);
// 使用url打开流,并将流作为xml Reader的输入源并解析
xmlreader.parse(new InputSource(url.openStream()));
// 将解析结果作为 RSSFeed 对象返回
return theRssHandler.getFeed();
}
catch (Exception ee)
{
return null;
}
}
private void UpdateDisplay()
{
TextView feedtitle = (TextView) findViewById(R.id.feedtitle);
TextView feedpubdate = (TextView) findViewById(R.id.feedpubdate);
ListView itemlist = (ListView) findViewById(R.id.itemlist);
if (feed == null)
{
feedtitle.setText("No RSS Feed Available");
return;
}
//设置channel的标题和日期
feedtitle.setText(feed.getTitle());
feedpubdate.setText(feed.getPubDate());
//构建数组适配器,用于绑定listview
ArrayAdapter<RSSItem> adapter = new
ArrayAdapter<RSSItem>(this,android.R.layout.
simple_list_item_1,feed.getAllItems());
itemlist.setAdapter(adapter);//listview绑定适配器
itemlist.setSelection(0);
itemlist.setOnItemClickListener(this);//设置itemclick事件代理
}
//itemclick事件代理方法
public void onItemClick(AdapterView<?> parent, View v, int position, long id) {
Log.d(tag,"item clicked!");
//构建一个“意图”,用于指向activity :detail
Intent itemintent = new Intent(this,detail.class);
//构建buddle,并将要传递参数都放入buddle
Bundle b = new Bundle();
b.putString("title", feed.getItem(position).getTitle());
b.putString("description", feed.getItem(position).getDescription());
b.putString("link","http://www.csdn.net");// feed.getItem(position).getLink());
b.putString("pubdate", feed.getItem(position).getPubDate());
//用android.intent.extra.INTENT的名字来传递参数
itemintent.putExtra("android.intent.extra.INTENT", b);
//把意图转给子activity
this.startActivityForResult(itemintent, 0);
//this.startActivity(itemintent);
}
}
到此,程序已经可以显示第1个activity(页面)了。但由于程序使用了网络,我们还必须在AndroidManifest.xml中增加使用网络的权限:
<uses-permission android:name="android.permission.INTERNET" />
否则,程序会提示Permission denied错误。
7、打开droid draw,设计第2个activity(页面)detail.xml:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
android:id="@+id/widget28"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:orientation="vertical"
xmlns:android="http://schemas.android.com/apk/res/android"
>
<TextView
android:id="@+id/storybox"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:text="TextView"
android:autoLink="all"
>
</TextView>
<Button
android:id="@+id/back"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="back"
>
</Button>
</LinearLayout>
8、同时在AndroidManifest.xml中增加这个activity的声明:
<activity android:name=".detail" >
</activity>
9、新建class detail.java:
public class detail extends Activity {
public void onCreate(Bundle icicle)
{
super.onCreate(icicle);
setContentView(R.layout.detail);//加载detail.xml作为本视图
String theStory = null;
//获取调用者的“意图”
Intent startingIntent = getIntent();
if (startingIntent != null)
{
//通过调用者意图获取对应的“参数”,字符串android.intent.extra.INTENT与调用者指定的一致
Bundle b = startingIntent.getBundleExtra("android.intent.extra.INTENT");
if (b == null)
{
theStory = "bad bundle?";
}
else
{//读取“参数”的内容
theStory = b.getString("title") + "/n/n" + b.getString("pubdate")
+ "/n/n" + b.getString("description").replace('/n',' ')
+ "/n/nMore information:/n" + b.getString("link");
}
}
else
{
theStory = "Information Not Found.";
}
//构建textview并用参数值设置其text
TextView db= (TextView) findViewById(R.id.storybox);
db.setText(theStory);
//构建button并设置其onclicke事件的监听者(代理)
Button backbutton = (Button) findViewById(R.id.back);
backbutton.setOnClickListener(new Button.OnClickListener()
{
public void onClick(View v)
{
finish();//结束本activity,返回给调用者
}
});
}
}
10、运行程序,在ddms中进行调试。