JavaServer Faces Rss 栏组件用于生成必要的 HTML 标记和样式表来呈现实际的 RSS Feed 的内容,这些内容是在后台通过 AJAX 请求获得的。可以使用 <%@taglib prefix="ui" uri="http://java.sun.com/blueprints/ui" %> 声明来访问 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>
属性 | 描述 | 必需 | 缺省 |
---|---|---|---|
url | 指定 RSS Feed 的 URL | 是 | N/A |
itemCount | 指定在 RSS 栏上显示的 RSS 中的条目数 | 否 | 所有条目 |
title | 指定此 RSS 栏的标题 | 否 | <channel> 中的标题 |
backgroundImage | 指定此 RSS 栏是否需要背景图像。仅接受 no 或 default | 否 | 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 的数据后,该实例将被放在用户的会话中。