在早先的一篇关于 Mashups4JSF 的文章中(参见 参考资料),我们了解了 Mashups4JSF 是什么,如何配置它,以及如何使用它构建一个有用的 mashup 应用程序。我们还了解了如何在 WebSphere Application Server V7.0 上结合使用库和 Apache MyFaces 2.0 以及 IBM JWL (JavaServer Faces Widget Library)。
mashup 应用程序中最常见的用例之一就是以 feed(RSS 或 Atom)的形式导出应用程序的内部数据。在 Mashups4JSF 出现之前,开发人员需要从应用程序 DTO(数据传输对象)中手动生成 feed。现在要感谢 Mashups4JSF,它使得以 feed 形式导出应用程序数据变得更简单。
在本文中,我将解释如何使用 Mashups4JSF feed 生成器服务 (producer service) 以 RSS feed 的形式导出 Web 应用程序数据,以及如何通过 feed 阅读器组件使用这些数据。
新闻应用程序是一个 JavaServer Faces (JSF) 2.0 应用程序,它在数据表中展示一个样例新闻集,如 图 1 所示,我们希望以 RSS feed 的方式导出这个样例新闻集。
新闻页面的代码非常简单。清单 1 展示了 news.xhtml 页面中的新闻 dataTable 的 XHTML 代码。
清单 1. news.xhtml 页面中的新闻 dataTable
<h:dataTable id="newsTable" value="#{newsList.news}" var="varnews" styleClass="standardTable" headerClass="standardTable_Header" footerClass="standardTable_Footer" rowClasses="standardTable_Row1, standardTable_Row2" columnClasses="standardTable_Column"> <h:column id="titleColumn"> <f:facet name="header"> <h:outputText value="#{messages.application_label_title}" id="titleText"> </h:outputText> </f:facet> <h:outputLink value="#{varnews.link}"> <h:outputText id="title" value="#{varnews.title}"> </h:outputText> </h:outputLink> </h:column> <h:column id="authorColumn"> <f:facet name="header"> <h:outputText value="#{messages.application_label_author}" id="authorText"> </h:outputText> </f:facet> <h:outputText id="author" value="#{varnews.author}"> </h:outputText> </h:column> <h:column id="categoryColumn"> <f:facet name="header"> <h:outputText value="#{messages.application_label_category}" id="categoryText"> </h:outputText> </f:facet> <h:outputText id="category" value="#{varnews.category}"> </h:outputText> </h:column> <h:column id="descColumn"> <f:facet name="header"> <h:outputText value="#{messages.application_label_description}" id="descText"> </h:outputText> </f:facet> <h:outputText id="desc" value="#{varnews.desc}"> </h:outputText> </h:column> </h:dataTable> |
newsTable
通过表达式 #{newsList.news}
与 NewsList
DTO 绑定。清单 2 展示了 NewsList
DTO 的代码。它包含新闻对象的静态列表。它可以保存来自数据库的真实数据,但是为了简便起见,这里使用了一个静态列表。
@ManagedBean public class NewsList { static List <News> news = new ArrayList<News>(); // Sample news list static { for (int i = 0; i < 10; ++i) { news.add(new News( "Title" + i, "Description" + i, "http://www.google.com/search?q=" + i, "Category" + i, "Author" + i)); } } public List<News> getNews() { return news; } } |
News
类是一个非常简单的 bean。它仅包含以下属性:
- Title
- Description
- Link
- Category
- Author
参见 清单 3。
public class News { private String title; private String desc; private String link; private String category; private String author; ... public String getTitle() { return title; } public void setTitle(String title) { this.title = title; } public String getDesc() { return desc; } public void setDesc(String desc) { this.desc = desc; } public String getLink() { return link; } public void setLink(String link) { this.link = link; } public String getCategory() { return category; } public void setCategory(String category) { this.category = category; } public String getAuthor() { return author; } public void setAuthor(String author) { this.author = author; } } |
现在,让我们看看如何以 RSS feed 的形式导出 NewsList
数据。
在详细介绍以 RSS feed 的形式导出新闻列表之前,您可能需要了解如何为 JSP 2.0 应用程序配置 Mashups4JSF 库,此前的一篇 Mashups4JSF 文章(参见 参考资料)介绍了这方面的内容。在使用 Mashups4JSF feed servlet 时,确保下载了 Mashups4JSF 0.0.3 的最新的稳定快照(参见 参考资料)。
要使用 Mashups4JSF 以 RSS feed 的形式导出 NewsList
数据,我们需要在 JSF 应用程序中执行下列步骤。
在您的应用程序的 web.xml 中注册 Mashups4JSF 的 MashupFeedServlet
,如 清单 4 所示。
清单 4. 注册 Mashups4JSF feed servlet
<servlet> <servlet-name>mashupFeedServlet</servlet-name> <servlet-class>com.googlecode.mashups.servlets.MashupFeedServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>mashupFeedServlet</servlet-name> <url-pattern>/mashupFeedServlet</url-pattern> </servlet-mapping> |
使用 @Feed
注释 feed 类(NewsList
类),并分别使用 @FeedTitle
、@FeedDescription
、@FeedLink
和 @FeedItems
指定标题、描述、链接和 feed 项。清单 5 显示了应用注释后的 NewsList
类。
@ManagedBean @Feed public class NewsList { static List <News> news = new ArrayList<News>(); // Sample news list static { for (int i = 0; i < 10; ++i) { news.add(new News( "Title" + i, "Description" + i, "http://www.google.com/search?q=" + i, "Category" + i, "Author" + i)); } } @FeedItems public List<News> getNews() { return news; } @FeedTitle public String getTitle() { return TITLE; } @FeedDescription public String getDescription() { return DESCRIPTION; } @FeedLink public String getLink() { return LINK; } private final String TITLE = "News List"; private final String DESCRIPTION = "News List Description"; private final String LINK = "http://somenewschannel.com"; } |
使用 @ItemFeed
注释 feed 项类(News
类),并分别使用 @ItemTitle
、@ItemDescription
、@ItemLink
, @ItemCategory
和@ItemAuthor
指定 feed 项的标题、描述、链接、类别和作者。 清单 6 显示了应用注释后的 News
类。
@FeedItem public class News { private String title; private String desc; private String link; private String category; private String author; ... @ItemTitle public String getTitle() { return title; } public void setTitle(String title) { this.title = title; } @ItemDescription public String getDesc() { return desc; } public void setDesc(String desc) { this.desc = desc; } @ItemLink public String getLink() { return link; } public void setLink(String link) { this.link = link; } @ItemCategory public String getCategory() { return category; } public void setCategory(String category) { this.category = category; } @ItemAuthor public String getAuthor() { return author; } public void setAuthor(String author) { this.author = author; } } |
对 feed 和 feed 项类进行注释后,基本上已经完成了全部工作。接下来要做的就是呈现 feed,实现方式是将 feed 解析为 feed servlet 的参数,并指定 rss
作为输出,如 清单 7 所示。
清单 7. 通过将 feed 类解析为 feed servlet 的参数呈现 RSS feed
#{request.contextPath}/mashupFeedServlet?feedClass=dto.NewsList&output=rss |
图 2 展示了以 RSS feed 的形式导出的 NewsList
feed。
如果希望以 ATOM feed 的形式导出 NewsList,那么需要将 atom
指定为 feed servlet 的输出。
除了 RSS 和 ATOM feed 导出外,Mashups4JSF 还允许在 JSF 应用程序内部使用任何 RSS、ATOM 或 JSON feed。因此,让我们来看看如何通过 rssFeedReader
组件使用我们刚刚为 NewsList
数据创建的 RSS feed。
清单 8 展示了如何在 consumer.xhtml 页面中通过 rssFeedReader
组件使用 RSS feed。
清单 8. consumer.xhtml 页面中的 rssFeedReader 组件
<mashup:rssFeedReader feedURL="http://#{facesContext.externalContext.request.remoteHost}: #{facesContext.externalContext.request.localPort} #{facesContext.externalContext.request.contextPath} /mashupFeedServlet?feedClass=dto.NewsList&output=rss" maximumCount="5" channelVar="channel" itemVar="item" itemIndex="itemIndex"> <f:facet name="channel"> <h4>#{messages.application_channel_desc}#{channel.description}</h4> </f:facet> <f:facet name="item"> <b>#{messages.application_item_index} </b>#{itemIndex}<br /> <b>#{messages.application_item_title} </b>#{item.title}<br /> <b>#{messages.application_item_link} </b> <h:outputLink value="#{item.link}"> #{item.link} </h:outputLink><br /> <b>#{messages.application_item_author} </b>#{item.author}<br /> <b>#{messages.application_item_category} </b> #{item.categories[0].name}<br /><br /> </f:facet> </mashup:rssFeedReader> |
如清单 8 所示,我们指定了以下内容:
- RSS feed URL,
- 用于访问 RSS 通道信息的 channel 变量(例如,
description
), - item 变量,将访问所有 RSS feed 项(如
title
、link
和author
),以及 - 项索引。
在 channel 部分中,我们可以指定希望为 RSS 通道显示的属性,而在 item 部分中,我们可以指定希望为每个 feed 项显示的属性。
图 3 展示了 NewsList
feed 的 rssFeedReader
输出。
图 3. NewsList RSS feed 的 rssFeedReader 输出
除了各种 mashup 组件和服务之外,Mashups4JSF 还抽象化了为 JSF 应用程序导出和导入 mashup feed 的方式。在 Mashups4JSF 出现之前,开发人员需要从应用程序 DTO(数据传输对象)中手动生成 feed。现在要感谢 Mashups4JSF,它使得以 feed 的形式导出应用程序数据变得更简单。在本文中,我们学习了如何使用 Mashups4JSF Feed Servlet 以 RSS feed 的形式表示 JSF 应用程序数据。我们还了解了如何通过 rssFeedReader 组件使用这些 feed。
学习
-
- Mashups4JSF 简介:使 Mashups 更加简单(Hazem Saleh,developerWorks,2010 年 7 月):了解 Mashups4JSF 架构和库配置。在 WebSphere Application Server 7.0 上使用 Mashups4JSF 和 IBM JWL (JSF Widget Library) 创建具有少量代码的 mashup 应用程序。
- Apache MyFaces Project 主页:了解有关 Apache Software Foundation 这一项目的更多信息。
- Mashups4JSF 主页:访问 Mashups4JSF 库,它允许在 Java™ 和 JSF 应用程序中轻松地构建 mashup。
- Mashups 和 JavaServer™ Faces Integration Library:观看 Mashups4JSF 演示。
- 感兴趣的活动:了解即将到来的、面向 IBM 开源开发人员的会议、展览和网络广播。
- 随时关注 developerWorks 技术活动和网络广播。
- 访问 developerWorks Open source 专区获得丰富的 how-to 信息、工具和项目更新以及最受欢迎的文章和教程,帮助您用开放源码技术进行开发,并将它们与 IBM 产品结合使用。
- Mashups4JSF 简介:使 Mashups 更加简单(Hazem Saleh,developerWorks,2010 年 7 月):了解 Mashups4JSF 架构和库配置。在 WebSphere Application Server 7.0 上使用 Mashups4JSF 和 IBM JWL (JSF Widget Library) 创建具有少量代码的 mashup 应用程序。