RSSOwlMidlet(RSS无线阅读器)开源说明

转自:http://www.cnblogs.com/zhengyun_ustc/archive/2005/10/07/rssowlj2memidlet.html

摘要：

本文档给出 RSS 无线阅读器 J2ME 版本的开源说明。

第 1 章 简单描述 RSS 无线阅读器 J2ME 版本的功能和特别之处 。

第 2 章 描述调用 RSS 无线阅读器 J2ME 版本的开源版权声明 。

第 3 章 给出了 RSS 无线阅读器 J2ME 版本的下载资源 。

 

我的 RssReader 资源：

1 ：《[J2ME]RSSOwlMidlet(RSS无线阅读器)开源说明》

2 ：《[J2ME]RSSOwlMidlet(RSS无线阅读器)设计说明》

3 ：下载源代码：http://www.cnblogs.com/Files/zhengyun_ustc/RSSOwlMidlet-src.rar

4 ：下载midlet：jad: RSSOwlMidlet.jad jar:RSSOwlMidlet.jar包可能有点偏大，您可以进行混淆来缩小) (jar

 

1背景、功能和特别之处

摘要 ：本章 简单描述 RSS 无线阅读器 J2ME 版本的背景、功能和特别之处。

 

我们提供的 RSS 无线阅读器 J2ME 版本 [ 开源 ] 是一个可以下载到手机 ( 例如 Nokia7610) 或者其他无线手持设备 ( 例如 PocketPC) 的应用程序，用来阅读存在于 Internet 中广泛的 RSS 新闻源，比如

豆瓣最新评论 http://www.douban.com/feed/review/latest ；

博客堂 http://blog.joycode.com/MainFeed.aspx ；

博客园 http://www.cnblogs.com/rss.aspx ；

CSDN 技术文档 http://www.csdn.net/Rss/RssFeed.aspx?rssid=3 ；

ChinaUnix.net- 业界新闻与评论 http://bbs.chinaunix.net/rss/46.xml ；

keso's blog http://feeds.feedburner.com/PlayinWithIt

等等，这些新闻源我们将预置在本应用程序中。

 

下面介绍 RSS 无线阅读器的功能列表：

l         RSS Feed 列表

n         添加 Rss Feed

n         编辑 Rss Feed

n         删除 Rss Feed

l         读取 Rss Feed 新闻

n         查看新闻摘要

l         重新读取 Rss Feed 新闻

l         关于我

 

下面就是应用程序的主界面：
                                

图 1-1 RSS 无线阅读器的主界面

 

图 1-2 RSS 无线阅读器的读取动画界面

 

图 1-3 RSS 无线阅读器的读取新闻列表界面

 

下面，我们说说这个应用程序的特别之处。

这个应用程序的思路来自于两个开源的应用程序：

How to create a J2ME MIDP RSS Reader application with NetBeans 4.0 作者 Tommi Laukkanen

J2ME手机电话本 作者 garrey

RSS 读取以及用 xmlpull 解析这部分思路，采用了 Tommi 的思路；

MVC 的类分解，以及对 RMS 记录存储的封装模式，采用了 garrey 的思路。

 

对于获取 RMS 中存储的所有的 Rss Feed 列表，采用了文章《 探索J2ME：对记录进行排序 》的代码，放弃了 garrey 的 RecordComparator 比较器的实现。

另外，在调试过程中，也加入了我的一些思考，以及兼容各种 RSS 的办法。

 

总结一下特别之处。

特别是比原来 Tommi 的版本增加了几个特性：

l         最大的改动就是，原来 Tommi 把视图 / 控制器都放在 RssReaderMIDlet.java 了，而我们将视图分拆出来为 RssFeedAdd.java 、 RssFeedEdit.java 、 RssFeedList.java 等等，控制器则为 GUIController.java ；

l         可以添加 / 编辑 / 删除 Rss Feed 书签；

l         原来 Tommi 将 Feed 列表以及 URL 存储在 RMS 的一个条目，我放弃了这种做法，而是像 garrey 处理电话记录一样；

l         当请求远端服务器时，加入了动画等候画面，提示用户正在获取新闻列表；

l         由于采用了 xmlpull 方式解析 XML ，所以可以做到一边后台扫描 XML 文档，一边前台将解析到的新闻 Title 显示在用户界面上，不影响用户阅读新闻列表；

l         兼容博客堂 / 博客园这种 .Text 类型 Blog 的 RSS ，因为它们限制请求方的“ User-Agent ”；

l         采用 KxmlParser 的自动检测 RSS XML 文档的编码格式，所以不用用户专门设置编码格式。

 

2 开源版权声明

摘要 ：本章描述 RSS 无线阅读器 J2ME 版本的开源版权声明。

 

由于我这个版本的 RSS J2ME 阅读器也是基于 Tommi 和 garrey 源代码基础上改编而来的，所以决定遵照 GPL 协议的大意开放源代码，您可以自由传播和修改，在遵照下面的约束条件的前提下：

 

条件 1

只要你在 RSS 无线阅读器 J2ME 版本的 每一副本上明显和恰当地出版版权声明，保持此许可证的声明和没有担保的声明完整无损，并和程序一起给每个其他的程序接受者一份许可证的副本，你就可以用任何媒体复制和发布你收到的原始的程序的源代码。你可以为转让副本的实际行动收取一定费用。你也有权选择提供担保以换取一定的费用。

 

条件 2

你可以修改 RSS 无线阅读器 J2ME 版本 程序的一个或几个副本或程序的任何部分，以此形成基于程序的作品。只要你同时满足下面的所有条件，你就可以按前面第一款的要求复制和发布这一经过修改的程序或作品。   a ） 你必须在修改的文件中附有明确的说明：你修改了这一文件及具体的修改日期。   b ） 你必须使你发布或出版的作品（它包含程序的全部或一部分，或包含由程序的全部或部分衍生的作品）允许第三方作为整体按许可证条款免费使用。   c ） 如果修改的程序在运行时以交互方式读取命令，你必须使它在开始进入常规的交互使用方式时打印或显示声明：包括适当的版权声明和没有担保的声明（或者你提供担保的声明）；用户可以按此许可证条款重新发布程序的说明；并告诉用户如何看到这一许可证的副本。（例外的情况：如果原始程序以交互方式工作，它并不打印这样的声明，你的基于程序的作品也就不用打印声明）。

 

这样，您就可以自由使用并传播本源代码，当然请您原封不动地保留原作者信息。

 

 

3 资源

我的 RssReader 资源：

1 ：《[J2ME]RSSOwlMidlet(RSS无线阅读器)开源说明》

2 ：《[J2ME]RSSOwlMidlet(RSS无线阅读器)设计说明》

3 ：下载源代码：http://www.cnblogs.com/Files/zhengyun_ustc/RSSOwlMidlet-src.rar

4 ：下载midlet：jad: RSSOwlMidlet.jad jar:RSSOwlMidlet.jar包可能有点偏大，您可以进行混淆来缩小) (jar

 

网络资源：

1 ： How to create a J2ME MIDP RSS Reader application with NetBeans 4.0 作者 Tommi Laukkanen

2 ： J2ME手机电话本 作者 garrey

3 ： 探索J2ME：对记录进行排序

4 ： kxml2 官方站点： http://kxml.sourceforge.net/

5 ： Xmlpull 官方站点： http://www.xmlpull.org/

6 ：实例教您 KXML ： J2ME 中 XML 语法分析的利器