rss

chenhao_yssy

浏览: 32968 次
性别:
来自: 苏州

最近访客更多访客>>

da0128da

woshiicesky

luoxiaoyan3817

wahtung

博主相关

博客

微博

相册

留言

关于我

文章分类

全部博客 (14)

社区版块

存档分类

SUN .net XML CMS HTML

一:什么是RSS
RSS(really simple syndication) :网页内容聚合器。RSS的格式是XML。必须符合XML 1.0规范。
RSS的作用：订阅BLOG,订阅新闻
二:RSS的历史版本:
http://blogs.law.harvard.edu/tech/rssVersionHistory
RSS的版本有很多个，0.90、0.91、0.92、0.93、0.94、1.0 和 2.0。与RSS相对的还有ATOM。
国内主要是RSS2.0,国外主要用ATOM0.3.
由于RSS出现2派，导致混乱场面。其中RSS2.0规范由哈佛大学定义并锁定。
地址:http://blogs.law.harvard.edu/tech/rss
三：RSS 文件形式
 1:例子：
<?xml version="1.0"?>
<rss version="2.0">
 <channel>
 <title>The channel's name goes here</title>
 <link>http://www.urlofthechannel.com/</link>
 <description>This channel is an example channel for an article.
 </description>
 <language>en-us</language>
 <image>
 <title>The image title goes here</title>
 <url>http://www.urlofthechannel.com/images/logo.gif</url>
 <link>http://www.urlofthechannel.com/</link>
 </image>
 <item>
 <title>The Future of content</title>
 <link>http://www.itworld.com/nl/ecom_in_act/11122003/</link>
 <description> The issue of people distributing and reusing
 digital media is a problem for many businesses. It may also be
 a hidden opportunity. Just as open source licensing has opened
 up new possibilities in the world of technology, it promises to do
 the same in the area of creative content.</description>
 </item>
 <item>
 <title>Online Music Services - Better than free?</title>
 <link>http://www.itworld.com/nl/ecom_in_act/08202003/</link>
 <description>More people than ever are downloading music from
 the Internet. Many use person-to-person file sharing programs like
 Kazaa to share and download music in MP3 format, paying nothing.
 This has made it difficult for companies to setup online music
 businesses. How can companies compete against free?</description>
 </item>
</channel>
</rss>
 2:RSS文件由一个 <channel> 元素及其子元素组成。除了频道内容本身之外，<channel>
还以项的形式包含表示频道元数据的元素 —— 比如 <title>、<link> 和 <description>。
项通常是频道的主要部分，包含经常变化的内容。
 3:频道(channel)用<channel>表示
频道一般有三个元素，提供关于频道本身的信息：
<title>：频道或提要的名称。
<link>：与该频道关联的 Web 站点或者站点区域的 URL。
<description>：简要介绍该频道是做什么的。
许多频道子元素都是可选的。常用的 <image> 元素包含三个必需的子元素：
<url>：表示该频道的 GIF、JPEG 或 PNG 图像的 URL。
<title>：图象的描述。当频道以 HTML 呈现时，用作 HTML <image> 标签的 ALT 属性。
<link>：站点的 URL。如果频道以 HTML 呈现，该图像作为到这个站点的链接。
<image> 还有三个可选的子元素：
<width>：数字，表示图象的像素宽度，最大值是 188，默认值为 88。
<height>：数字，表示图象的像素高度。最大值是 400，默认值为 31。
<description>：包含文本，在呈现时可以作为围绕着该图像形成的链接元素的 title 属性。
此外还可以使用许多其他可选的频道元素。多数都是不言自明的：
<language>：en-us
<copyright>：Copyright 2003, James Lewin
<managingEditor>：dan@spam_me.com (Dan Deletekey)
<webMaster>：dan@spam_me.com (Dan Deletekey)
<pubDate>：Sat, 15 Nov 2003 0:00:01 GMT
<lastBuildDate>：Sat, 15 Nov 2003 0:00:01 GMT
<category>：ebusiness
<generator>：Your CMS 2.0
<docs>：http://blogs.law.harvard.edu/tech/rss
<cloud>：允许进程注册为“cloud”，频道更新时通知它，为 RSS 提要实现了一种轻量级的发布-订阅协议。
<ttl>：存活时间是一个数字，表示提要在刷新之前缓冲的分钟数。
<rating>：关于该频道的 PICS 评价。
<textInput>：定义可与频道一起显示的输入框。
<skipHours>：告诉聚集器哪些小时的更新可以忽略。
<skipDays>：告诉聚集器那一天的更新可以忽略。
 4:摘要(feed)用<item>表示,<item>的格式如下：
每个摘要通常包含三个元素：
<title>：这是项的名称，在标准应用中被转换成 HTML 中的标题。
<link>：这是该项的 URL。title 通常作为一个链接，指向包含在 <link> 元素中的 URL。
<descriptin>：通常作为 link 中所指向的 URL 的摘要或者补充。
所有的元素都是可选的，但是一个项至少要么包含一个 <title>，要么包含一个 <description>。
项还有其他一些可选的元素：
<author>：作者的 e-mail 地址。
<category>：支持有组织的记录。
<comments>：关于项的注释页的 URL。
<enclosure>：支持和该项有关的媒体对象。
<guid>：唯一与该项联系在一起的永久性链接。
<pubDate>：该项是什么时候发布的。
<source>：该项来自哪个 RSS 频道，当
四:主流java rss lib及其评测:
主要有一下几种:
 1:Rome: http://wiki.java.net/bin/view/Javawsxml/Rome
Rome是 java.net 上的一个开源项目，现在的版本是0.5。为什么叫Rome呢,按它的介绍上的说法，有个“条条大路通罗马”的意思，有些RSS的意味。Rome可能是 sun 公司从自己某个子项目中抽离出来的，package和类的命名就象j2sdk一样感觉规范。功能上支持RSS的所有版本及 Atom 0.3(Atom是和RSS类似的一种内容聚合的方式)。Rome 本身是提供API和功能实现.
 2:rssutils: http://gceclub.sun.com.cn/staticcontent/html/2004-04-22/rss.html
rssutils是一个工具包，sun 的 develope站点上有文章 RSS Utilities: A Tutorial 专门介绍用taglib 显示RSS内容，附带的可以下载这个工具包，但我从网上搜索不到它的出处，自然也无法看到它的源码。但从反编译的代码来看，也是sun公司内部高手所做，设计精巧，代码简练。实现一个handler，用sax的方式解析xml内容，handler内部用反射和javabean的机制构造RSS元素对象并赋值。
 3:rsslib4j: http://sourceforge.net/projects/rsslib4j
rsslib4j 是 sourceforget 上的项目，同样支持所有RSS版本。
 4:rsslibj:http://enigmastation.com/rsslibj/
 5:总结
Rome:
优 - 1）可扩展性好，有前途。2）功能强大，除了用来解析RSS，还可以聚合和构造RSS。
劣 - 1）兼容性待加强，2）绑定jdom。
rssutils:
优 - 1）代码设计精妙，值得学习。2）附带 taglib 实现，直接可在 jsp 中应用。
劣 - 1）没有源码。 2）兼容性有待加强。 3）功能较弱，只能用来解析RSS，没有聚合和构造RSS功能。
rsslib4j:
优 - 1）简单有效，体积小。2）兼容性不错。
劣 - 1）有小bug。2）功能较弱，只能用来解析RSS，没有聚合和构造RSS功能。
rsslibj:
优 - 1）简单有效，体积小,才25K。2）能解析和生成RSS(动态和静态)
劣 - 1）有小bug。2）版本很久没有更新了，陈旧.

五:选择ROME作为RSS实现工具
在官网http://wiki.java.net/bin/view/Javawsxml/Rome下载rome-0.8.jar,
rome用到了jdom1.0,下载地址:http://www.jdom.org
rome支持:rss_0.9
   rss_0.91
   rss_0.92
   rss_0.93
   rss_0.94
   rss_1.0
   rss_2.0
   atom_0.3
   atom_1.0
生成RSS类新需要在程序中指定，如：rss_2.0
六:包结构
com.sun.syndication.feed 提供RSS and Atom beans的父类
com.sun.syndication.feed.atom 提供实现Atom feeds核心元素的beans
com.sun.syndication.feed.module 提供处理聚合modules的beans
com.sun.syndication.feed.rss 提供实现Rss feeds核心元素的beans
com.sun.syndication.feed.synd 我们主要用的就是这个包，SyndFeed and SyndEntryImpl
com.sun.syndication.io  提供对读取和分析feeds的输入和输出
七:实例：

1:读取远端url的rss,然后输出到控制台:
/**
* 关键代码：
* SyndFeedInput input = new SyndFeedInput();
* SyndFeed feed = input.build(new XmlReader(feedUrl));
*/

package com.sun.syndication.samples;

import com.sun.syndication.feed.synd.SyndFeed;
import com.sun.syndication.io.SyndFeedInput;
import com.sun.syndication.io.XmlReader;
import java.net.URL;

/**
* It Reads and prints any RSS/Atom feed type.
*/
public class FeedReader {

    public static void main(String[] args) {
        boolean ok = false;
        if (args.length==0) {
            try {
                URL feedUrl = new URL("http://seu.org.cn/bbs/rss.php");
  //SyndFeedInput:从远程读到xml结构的内容转成SyndFeedImpl实例
                SyndFeedInput input = new SyndFeedInput();
  //rome按SyndFeed类型生成rss和atom的实例,
  //SyndFeed是rss和atom实现类SyndFeedImpl的接口
                SyndFeed feed = input.build(new XmlReader(feedUrl));
  //打印到控制台
                System.out.println(feed);
                ok = true;
            }
            catch (Exception ex) {
                ex.printStackTrace();
                System.out.println("ERROR: "+ex.getMessage());
            }
        }

        if (!ok) {
            System.out.println();
            System.out.println("FeedReader reads and prints any RSS/Atom feed type.");
            System.out.println("The first parameter must be the URL of the feed to read.");
            System.out.println();
        }
    }
}
2:将多个远程RSS在本地聚集成一个RSS
package com.sun.syndication.samples;

import java.net.URL;
import java.io.InputStreamReader;
import java.io.PrintWriter;
import java.util.List;
import java.util.ArrayList;

import com.sun.syndication.feed.synd.SyndFeed;
import com.sun.syndication.feed.synd.SyndFeedImpl;
import com.sun.syndication.io.SyndFeedOutput;
import com.sun.syndication.io.SyndFeedInput;
import com.sun.syndication.io.XmlReader;

/**
* It aggregates a list of RSS/Atom feeds (they can be of different types)
* into a single feed of the specified type.
* 
* @author Alejandro Abdelnur
*
*/
public class FeedAggregator {

    public static void main(String[] args) {
        boolean ok = false;
        if (args.length>=2) {
            try {
                String outputType = args[0];

SyndFeed feed = new SyndFeedImpl();
feed.setFeedType(outputType);

      &nbs;         feed.setTitle("Aggregated Feed");
                feed.setDescription("Anonymous Aggregated Feed");
                feed.setAuthor("anonymous");
                feed.setLink("http://www.anonymous.com");

List entries = new ArrayList();
feed.setEntries(entries);

for (int i=1;i<args.length;i++) {
URL inputUrl = new URL(args[i]);

SyndFeedInput input = new SyndFeedInput();
SyndFeed inFeed = input.build(new XmlReader(inputUrl));

entries.addAll(inFeed.getEntries());

}

SyndFeedOutput output = new SyndFeedOutput();
output.output(feed,new PrintWriter(System.out));

                ok = true;
            }
            catch (Exception ex) {
                System.out.println("ERROR: "+ex.getMessage());
            }
        }

        if (!ok) {
            System.out.println();
            System.out.println("FeedAggregator aggregates different feeds into a single one.");
            System.out.println("The first parameter must be the feed type for the aggregated feed.");
            System.out.println(" [valid values are: rss_0.9, rss_0.91U, rss_0.91N, rss_0.92, rss_0.93, ]");
            System.out.println(" [                  rss_0.94, rss_1.0, rss_2.0 & atom_0.3 ]");
            System.out.println("The second to last parameters are the URLs of feeds to aggregate.");
            System.out.println();
        }
    }

}
3:将动态生成的RSS存盘，形成静态RSS
package com.sun.syndication.samples;

import com.sun.syndication.feed.synd.*;
import com.sun.syndication.io.SyndFeedOutput;

import java.io.FileWriter;
import java.io.Writer;
import java.text.DateFormat;
import java.text.SimpleDateFormat;
import java.util.ArrayList;
import java.util.List;

/**
* It creates a feed and writes it to a file.
* 
* @author Alejandro Abdelnur
*
*/
public class FeedWriter {

private static final String DATE_FORMAT = "yyyy-MM-dd";

    public static void main(String[] args) {
        boolean ok = false;
        if (args.length==0) {
            try {
                String feedType = "rss_2.0";//指定rss类型
                String fileName = "F:\\ss.xml";//静态rss存放目录

DateFormat dateParser = new SimpleDateFormat(DATE_FORMAT);

  //feed是通过SyndFeedImpl的实例
                SyndFeed feed = new SyndFeedImpl();
                feed.setFeedType(feedType);

                feed.setTitle("Sample Feed (created with Rome)");
                feed.setLink("http://rome.dev.java.net");
                feed.setDescription("This feed has been created using Rome (Java syndication utilities");

  //entries就是item集合
                List entries = new ArrayList();
  //一个entry就是一个item
                SyndEntry entry;
                SyndContent description;

  //第一个item
                entry = new SyndEntryImpl();
                entry.setTitle("Rome v1.0");
                entry.setLink("http://wiki.java.net/bin/view/Javawsxml/Rome01");
                entry.setPublishedDate(dateParser.parse("2004-06-08"));
                description = new SyndContentImpl();
                description.setType("text/plain");
                description.setValue("Initial release of Rome");
                entry.setDescription(description);
                entries.add(entry);

//第二个item
 entry = new SyndEntryImpl();
 &nbs; entry.setTitle("Rome v2.0");
 entry.setLink("http://wiki.java.net/bin/view/Javawsxml/Rome02");
 entry.setPublishedDate(dateParser.parse("2004-06-16"));
 description = new SyndContentImpl();
 description.setType("text/xml");
 description.setValue("Bug fixes, <xml>XML</xml> minor API changes and some new features");
 entry.setDescription(description);
 entries.add(entry);

//第三个item
 entry = new SyndEntryImpl();
 entry.setTitle("Rome v3.0");
 entry.setLink("http://wiki.java.net/bin/view/Javawsxml/Rome03");
 entry.setPublishedDate(dateParser.parse("2004-07-27"));
 description = new SyndContentImpl();
 description.setType("text/html");
 description.setValue("More Bug fixes, mor API changes, some new features and some Unit testing"+
 "For details check the <a href=\"Changes">http://wiki.java.net/bin/view/Javawsxml/RomeChangesLog#RomeV03\">Changes Log</a>");
 entry.setDescription(description);

 //将所有item存入entries
 entries.add(entry);

 //将entries加入channel
 feed.setEntries(entries);

                Writer writer = new FileWriter(fileName);
                SyndFeedOutput output = new SyndFeedOutput();
  //存盘,形成静态rss
                output.output(feed,writer);
                writer.close();

System.out.println("The feed has been written to the file ["+fileName+"]");
System.out.println(feed);