使用JSF、Ajax和Seam开发Portlets（3/3）

    在这个系列文章的第一篇和第二篇中，我解释了什么是portlet bridge？以及如何在一个基本的JSF和基于RichFaces（Ajax）的portlet中安装和使用它，和当前能支持运行JBoss Portlet Bridge的portal服务器的主要区别。最后这篇文章将集中讲述Seam portlet的开发，和最新发布的JBoss Portlet Bridge Beta 4版本的所有特性和优势。对于不太熟悉portlets的读者来说，仔细阅读前面两篇文章会有助于更好的理解本文。

    现在让我们先从Seam portlet的开发入手。

    安装Seam Portlet

    开发工具：

    要仿照本文示例进行开发，就需要下载最新版本的Maven（我用的是2.0.9版本）。

    安装Maven 2.0.9+在机器上设置Maven binaries的path环境变量

    创建项目：

    不同的Maven原型（archetype）对应可以产生不同种类的bridge.直接从命令行运行如下代码，可创建你的Seam portlet项目：

mvn archetype:generate
-DarchetypeGroupId=org.jboss.portletbridge.archetypes
-DarchetypeArtifactId=seam-basic -DarchetypeVersion=1.0.0.B4
-DgroupId=org.my.project -DartifactId=seamproject
-DarchetypeRepository=http://repository.jboss.org/maven2/ -Dversion=1.0.0.B4

    该特定原型是模块化的，这意味着通过其产生的项目将由几个子项目构成。这样做的好处是源码、资源和配置之间的界限更加清晰，维护也更方便。上述命令将产生三个目录，其中，‘web’目录中包含标记文件、图片和WEB-INF xml配置文件；‘ejb’目录中包含所有Seam EJB3源码，以及任何跟持久化和ejb部署相关的xml配置文件信息；最后是‘ear’目录，它主要用来集合项目信息构建ear文件。

    如果你是用上面提到的原型（archetype）命令创建的项目，那么现在你就会有一个‘seamproject’目录。现在到该目录下并运行如下命令：mvn install

    这个命令将会帮助你下载本地Maven库中缺少的任何组件，并编译和构建ear文件。

    运行和部署portlet：

    既然你已经有一个可部署的ear文件，那么再利用下面的命令就可以轻松的将portlet部署到最新版本的JBoss Portal上（已绑定到JBoss应用服务器）了。如果你已经自己下载或创建了本地安装包，就可在bridge文档中找到使用自定义配置的说明了。

    现在转到{seamproject}/ear目录下运行如下命令：

mvn cargo:start -Premote-portal-Dportal-2.7.0.B1

    该命令将花上一段时间（视你的网络情况而定）来下载最新版本的JBoss Application Server和JBoss Portal（软件均位于SourceForge.net网站上）。在继续下一步骤之前你应该能看到与上文画面相似的日志记录。*注意：你也许还会看到日志记录中不断滚屏的WSRP信息，不用担心，这同样是证明你已准备就绪的标志。

    现在来部署你的Seam项目ear文件。新打开一个终端窗口，转到目录{seamproject}/ear下，运行如下命令：

mvn cargo:deploy-Premote-portal -Dportal-2.7.0.B1

    当你在服务器日志中看到ear文件已部署成功时，访问链接http://localhost：8080/portal/portal/default/seamproject，会看到如下页面：

    现在我们已经准备好一个要开发Seam portlet了。当然，应用程序到底怎么写是由开发人员来决定的事情。但是这会帮你摆脱那些琐碎的配置问题，轻松的开始工作。