跳至内容 Java Solaris 社区 Sun 商店 加入 SDN 我的个人档案 加入的益处
 
在 Sun Java Studio Creator 2 中创建 Portlet
作者:Beth Stearns 和 David Botterill  
 
您是否正在为这样的门户 Web 站点开发应用程序:这些门户 Web 站点可以为各种来源的信息提供定制视图?门户中的这类形形色色的信息视图就是由一个个的 Portlet 组成的。一个 Portlet 提供一个 Web 页面片段,而不是完整的页面。门户(Web 站点本身)将这些 Portlet 片段汇集成一个完整的页面。Sun Java Studio Creator 2 集成开发环境为您提供了创建和设计 Portlet 应用程序的可视化工具。

Java Studio Creator 开发环境为 Web 应用程序开发者提供了一流的可视化 Portlet 应用程序设计器工具。IDE 不仅能够让您轻松地设计和开发 Portlet 应用程序,更为重要的是,通过 IDE 创建的所有 Portlet 应用程序均符合 JSR-168 Portlet 规范,这意味着您的 Portlet 符合为 Portlet 与 Portlet 服务器之间的交互所定义的标准。遵守这一标准可以确保您的 Portlet 应用程序能够在任何 Portlet 服务器上使用。这样,您就可以导出 Portlet 应用程序的 Web 应用程序归档 (WAR) 文件,然后将该文件部署到符合 JSR-168 的门户服务器上。无需对导出的 WAR 文件进行任何更改,便可以在 Sun Java System Portal Server 6.1 上使用;其他门户服务器则可能会要求您手动编辑 web.xml 部署描述符。请注意,这些 Portlet 当前即为 JavaServer Faces Portlet。

一个 Portlet 应用程序可包含多个 Portlet(目前,IDE 只支持一个 Portlet 应用程序包含一个 Portlet),而且,如同处理 Web 应用程序一样,您可以针对每个项目部署一个 Portlet 应用程序。符合 JSR-168 规范的 Portlet 可以具有三种类型的页面模式:VIEW、EDIT 和 HELP。目前,IDE 创建了 JavaServer Faces Portlet,并且它在 JavaServer Faces 组件和 Portlet 之间设置的桥仅支持 VIEW 模式。在不久的将来,此桥还将支持 Portlet 的 EDIT 和 HELP 模式。

通过 IDE 创建和设计 Portlet 应用程序与通过 IDE 创建和设计 Web 应用程序非常相似。创建 Portlet 项目分三个步骤。

  1. 选择 Portlet 项目类型。

    创建新的 Web 项目时,“新建项目”向导会提示您选择项目的类型,您可以选择“JSF Web 应用程序”,或选择“JSR-168 JSF Portlet 项目”。

    图 1:选择 Portlet 项目类型
    图 1:选择 Portlet 项目类型
     
  2. 输入 Portlet 项目的名称和位置(请参见图 2)。

    图 2:指定 Portlet 名称和位置
    图 2:指定 Portlet 名称和位置
     
  3. 设置 Portlet 部署描述符。

    您可以更改有关 Portlet 的缺省信息,包括其显示名称、描述和标题(请参见图 3)。正如您随后将看到的那样,您可以随时编辑该部署描述符。

    图 3:设置 Portlet 部署描述符
    图 3:设置 Portlet 部署描述符
     
  4. 向导结束时,会在设计器窗口中打开该 Portlet 页。Portlet 应用程序与 Web 应用程序的显示方式类似。然而,您会注意到一些不同之处。Portlet 页的缺省名称与 Web 应用程序页的缺省名称不同。例如,第一个 Portlet 页的缺省名称是 PortletPage1,而不是 Page1。在设计器窗口标签以及“概要”窗口和“项目”窗口中,您会看到这一名称差异,以及与 Web 页的许多类似之处(请参见图 4)。

    图 4:IDE 中的 Portlet 应用程序
    图 4:IDE 中的 Portlet 应用程序
     

    您在 Web 页上执行的任何操作几乎都可以在 Portlet 页上执行,包括将组件拖放到页面上、在浏览器中预览、编辑其源代码等等。

    正如 Web 应用程序那样,一个 Portlet 应用程序也可以有多个页面。当您在这些页面中导航时,显示 Portlet 内容的门户部分会随着每个页面的不同而有所变化。对于要在门户中初始显示其内容的 Portlet 页,您可以通过以下方式进行设置:在“项目”窗口中右键单击该 Portlet 页节点,然后选择“设置为初始页”>“View 模式页”选项。

    您随时都可以编辑 Portlet 部署描述符。右键单击 Portlet 的项目节点,即可打开 Portlet 部署描述符编辑器。除更改标题和关键字外,Portlet 部署描述符编辑器还可用来添加和更改语言环境、添加新的参数并设置其初始值,以及设置首选项。请参见图 5。

    图 5:Portlet 部署描述符编辑器
    图 5:Portlet 部署描述符编辑器
     

    生成并运行 Portlet 应用程序时,IDE 会将该 Portlet 部署到嵌入式 Portlet 容器(目前是 Apache Pluto)中。运行的 Portlet 应用程序会在浏览器中打开。

 
相关信息