第 20章. RSS支持

第 20章. RSS支持

20.1. 安装

20.2. 产生提要

20.3. 提要

20.4. 条目

20.5. 链接和进一步的文档

通过YARFRAW库集成RSS提要到Seam现在是容易的。在最新的发布版中对RSS支持现在处于“技术预览”的状态下。

20.1.   安装

为了启用对RSS的支持，将jboss-seam-rss.jar放入你的应用程序WEB-INF/lib目录下。RSS库也有一些依赖库应该被放置在同一目录下。依赖库列表详见章节 40.2.6, “Seam RSS 支持”

Seam RSS支持需要用到Facelets作为视图技术。

20.2.  产生提要

在项目examples/rss中包含了操作RSS支持的例子。它演示了适当的部署打包同时也展示了外露的功能。

一个提要是一个xhtml页面由一个提要和一个嵌套的条目项列表组成。

 

            <r:feed 

               xmlns="http://www.w3.org/1999/xhtml" 

               xmlns:ui="http://java.sun.com/jsf/facelets" 

               xmlns:r="http://jboss.com/products/seam/rss"

               title="#{rss.feed.title}"

               uid="#{rss.feed.uid}"

               subtitle="#{rss.feed.subtitle}"

               updated="#{rss.feed.updated}"

               link="#{rss.feed.link}">

               <ui:repeat value="#{rss.feed.entries}" var="entry">

                  <r:entry

                     uid="#{entry.uid}"

                     title="#{entry.title}"

                     link="#{entry.link}"

                     author="#{entry.author}"

                     summary="#{entry.summary}"

                     published="#{entry.published}"

                     updated="#{entry.updated}"

                  />

               </ui:repeat>

            </r:feed>

 20.3.  提要

提要是顶级的描述信息源的属性的实体。它包含零个或多个嵌套的条目。

<r:feed>

属性    uid —一个可选唯一的提要id。值是一个字符串。    title —提要的题目。值是一个字符串。    subtitle —提要的子标题。值是一个字符串。    updated —提要更新日期是什么时候？值是一个日期。       link —链接到信息源。值是一个字符串。                feedFormat —提要的格式。值是一个字符串，默认值是ATOM1。有效值是RSS10, RSS20, ATOM03 和 ATOM10。 子元素    零个或多个提要条目。 Facets    无

20.4.  条目

条目是提要中的“新闻提要”。

<r:feed>

属性    uid —一个可选唯一的提要id。值是一个字符串。    title —提要的题目。值是一个字符串。    link —链接到项目。值是一个字符串。            author —故事的作者。值是一个字符串。    summary —故事的主体。值是一个字符串。    textFormat —故事正文和标题的格式。值是一个字符串，有效值是“text”和“html”，默认是“html”。    published —故事第一次被发表是什么时候？值是一个日期。    updated —故事被更新是什么时候？值是一个日期。 子元素    无 Facets    无

20.5. 链接和更多的文档

RSS的功能核心是基于YARFRAW库，能在http://yarfraw.sourceforge.net/找到，其大多数的功能和可能的限制都从这里继承。

更多关于ATOM 1.0 格式的细节，请看规范。

更多关于RSS 2.0 格式的细节，请看规范 。