返回主页。

如何使用 Rss 栏组件

作者:Yutaka Yoshida
状态:在 Early Access 版本阶段

RSS 栏标记

JavaServer Faces Rss 栏组件用于生成必要的 HTML 标记和样式表来呈现实际的 RSS Feed 的内容,这些内容是在后台通过 AJAX 请求获得的。可以使用 <%@taglib prefix="ui" uri="http://java.sun.com/blueprints/ui" %> 声明来访问 Rss 栏组件的标记库。

使用 JSF Rss 栏组件的示例如下所示:

     <ui:rssBar url="https://blueprints.dev.java.net/servlets/ProjectRSS?type=news"
         itemCount="4"
         title="News from BlurPrints"
         backgroundImage="default"
         fontSize="14"
         speed="3000"
         color="#00ffff"
         hoverColor="="#ff00ff">
     </ui:rssBar>

上面的组件标记名称为 rssBar,它将以下属性添加到传统 HTML 表单组件的属性中:

属性 描述 必需 缺省
url 指定 RSS Feed 的 URL N/A
itemCount 指定在 RSS 栏上显示的 RSS 中的条目 所有条目
title 指定此 RSS 栏的标题 <channel> 中的标题
backgroundImage 指定此 RSS 栏是否需要背景图像。仅接受 nodefault no
fontSize 指定字符的字体大小(以像素为单位) 14
speed 指定条目的切换速度(以毫秒为单位) 2000
color 指定字符的颜色 #000033
hoverColor 指定将鼠标放在上面时的字符颜色 #663300

部署描述符配置

由于 XmlHttpRequest 无法从与原始域不同的域中检索资源,因此,RssBar 组件使用 http 客户端来访问 RSS Feed。在这种情况下必须使用代理,需要在 web.xml 部署描述符中进行以下配置。


    <context-param>
        <param-name>proxyHost</param-name>
        <param-value>YOUR_PROXY_SERVER</param-value>
    </context-param>
    <context-param>
        <param-name>proxyPort</param-name>
        <param-value>YOUR_PROXY_PORT</param-value>
    </context-param>

RssBar JSF 组件利用 Dojo 和 Apache Shale Remoting 的第三方库来提供 JavaScript AJAX 功能和机制以访问动态资源。在对 com.sun.javaee.blueprints.components.ui.rss.RssFeedHandler 进行实例化以缓存来自 RSS Feed 的数据后,该实例将被放在用户的会话中。


返回主页。

© Sun Microsystems 2006。Java BluePrints Solutions Catalog 中的所有内容受版权保护,未经 Sun Microsystems 的明确书面许可,不得在其他产品中发布。