当您初次登录到 developerWorks 时，将会为您创建一份概要信息。您在 developerWorks 概要信息中选择公开的信息将公开显示给其他人，但您可以随时修改这些信息的显示状态。您的姓名（除非选择隐藏）和昵称将和您在 developerWorks 发布的内容一同显示。

所有提交的信息确保安全。

当您初次登录到 developerWorks 时，将会为您创建一份概要信息，您需要指定一个昵称。您的昵称将和您在 developerWorks 发布的内容显示在一起。

昵称长度在 3 至 31 个字符之间。您的昵称在 developerWorks 社区中必须是唯一的，并且出于隐私保护的原因，不能是您的电子邮件地址。

所有提交的信息确保安全。

My developerWorks:

我的通知：

退出

选择语言：

使用 Mashups4JSF 生成和消费 Mashup Feed

以 feed 的形式轻松导出应用程序数据

Hazem Saleh, 高级软件工程师, IBM

Hazem Saleh 有 6 年的 JEE 和开源技术经验。他致力于 Apache MyFaces 方面的工作，是 MyFaces 项目许多组件的发起人，比如 Tomahawk CAPTCHA、Commons ExportActionListener、Media、PasswordStrength 等等。他是 GMaps4JSF（一个集成 Google Maps 和 Java ServerFaces 的集成项目）和 Mashups4JSF（集成 mashup 服务和 JavaServer Faces 的集成项目）的创始人，是《The Definitive Guide to Apache MyFaces and Facelets (Apress)》和其他许多 JSF 文章的作者，并且是 developerworks 的投稿人和 JSF 演讲家。他现在是 IBM Egypt 的资深软件工程师和 Web 2.0 技术的主题专家。

简介：

mashup 应用程序中最常见的用例之一就是以 feed（RSS 或 Atom）的形式导出应用程序的内部数据。在 Mashups4JSF 出现之前，开发人员需要从应用程序 DTO（数据传输对象）中手动生成 feed。现在要感谢 Mashups4JSF，它使得以 feed 形式导出应用程序数据变得更简单。

标记本文！

发布日期： 2011 年 9 月 26 日
级别： 中级
原创语言： 英文
访问情况： 2191 次浏览
评论：

在早先的一篇关于 Mashups4JSF 的文章中（参见参考资料），我们了解了 Mashups4JSF 是什么，如何配置它，以及如何使用它构建一个有用的 mashup 应用程序。我们还了解了如何在 WebSphere Application Server V7.0 上结合使用库和 Apache MyFaces 2.0 以及 IBM JWL (JavaServer Faces Widget Library)。

在本文中，我将解释如何使用 Mashups4JSF feed 生成器服务 (producer service) 以 RSS feed 的形式导出 Web 应用程序数据，以及如何通过 feed 阅读器组件使用这些数据。

浏览新闻应用程序

新闻应用程序是一个 JavaServer Faces (JSF) 2.0 应用程序，它在数据表中展示一个样例新闻集，如图 1 所示，我们希望以 RSS feed 的方式导出这个样例新闻集。

图 1. 新闻样例
新闻应用程序的屏幕截图，包含链接的柱形列表以及它们的标题、作者、类别和描述。

新闻页面的代码非常简单。清单 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 的代码。它包含新闻对象的静态列表。它可以保存来自数据库的真实数据，但是为了简便起见，这里使用了一个静态列表。

清单 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。

清单 3. News DTO

				
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 的形式导出应用程序数据

在详细介绍以 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 注释 feed 类（NewsList 类），并分别使用 @FeedTitle、@FeedDescription、@FeedLink 和 @FeedItems 指定标题、描述、链接和 feed 项。清单 5 显示了应用注释后的 NewsList 类。

清单 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 类。

清单 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 解析为 feed servlet 的参数，并指定 rss 作为输出，如清单 7 所示。

清单 7. 通过将 feed 类解析为 feed servlet 的参数呈现 RSS feed

				
#{request.contextPath}/mashupFeedServlet?feedClass=dto.NewsList&output=rss

图 2 展示了以 RSS feed 的形式导出的 NewsList feed。

图 2. NewsList RSS feed
RSS feed 的屏幕截图，可以在浏览器中查看新闻。

如果希望以 ATOM feed 的形式导出 NewsList，那么需要将 atom 指定为 feed servlet 的输出。

回页首

通过 feed 阅读器使用 RSS feed

除了 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 输出
RSS feed 输出的屏幕截图，包括每个条目的项索引、标题、项链接、作者和类别

结束语

除了各种 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 产品结合使用。