创建并测试 Faces portlet 应用程序

JavaServer Faces(Faces)是一门技术,它允许您构建包含预先构建的用户界面组件(Faces 组件)的 JSP 页。可以在 Web 应用程序或 portlet 中包括包含 Faces 组件的 JSP 页。提供了一个 JSP 定制标记库以支持使用 Faces 组件。

Rational® Developer 使用户能够将 Faces 组件拖至 JSP 页并配置它们以供其 Web 应用程序或 portlet 使用。要创建和测试 JavaServer Faces portlet,遵循下列步骤:
注: 有关更详细的指示信息,使用提供的主题链接。
  1. 创建 Faces portlet 项目。
    1. 选择文件 > 新建 > 项目。然后,选择右边的 Portlet 项目Portlet 项目(JSR 168)选项,然后单击下一步按钮。
    2. 指定项目的名称和位置。 您还可以单击显示高级按钮来更改其它项目级别的设置。
    3. 选择 Faces portlet 单选按钮。
    4. 如果希望执行下列操作,可以单击下一步
      • 包括其它 Web 项目功能,如 JSP 标准标记库(JSTL)。
      • 更改应用程序名称或 portlet 名称。
      • 更改缺省语言环境(语言)和标题。
      • 更改包或类前缀。
      • 将“编辑”、“帮助”或“配置”方式添加至您的 portlet(将自动添加“查看”,但可以取消选择它)。
    5. 单击完成 向导将创建 portlet 项目,并打开 Portlet 部署描述符,并对于“查看”方式打开 JSP 文件(缺省情况下)。如果包括了“编辑”、“帮助”或“配置”方式,则还会为每种方式创建一个 JSP。这些 JSP 的缺省名称分别为 projectNameView.jsp、projectNameEdit.jsp、projectNameHelp.jsp 和 projectNameConfigure.jsp。
  2. 创建 Faces portlet JSP 文件 例如,创建将在您的应用程序中用作输入和输出表单页的其它 JSP 文件。
    1. 在“项目资源管理器”中,从项目的上下文菜单中选择文件 > 新建 > Faces JSP 文件 “新建 Faces JSP 文件”向导将打开。
    2. 为 JSP 文件提供名称,并为您的 portlet 提供适当的模型类型。
    3. (可选)选择配置高级选项复选框来添加标记库,指定编码、内容类型和文档类型信息,并为 JSP 文件生成方法存根。
    4. 单击完成 将创建带有适当标记的 JSP 文件并自动在 Page Designer 编辑窗格中打开它。
  3. 将组件的数据访问权添加至您的 portlet。对于 portlet 中的每个 JSP 文件,在“项目导航器”视图中双击该文件。这将在 Page Designer 中打开 JSP 文件。从“选用板”视图或“页数据”视图上的“数据”抽屉中,将一个组件拖放至您的 portlet JSP 文件。

    缺省情况下,还会将适合于正在添加的数据类型的 Faces 组件添加至 JSP 文件。这些 Faces 组件将绑定至已定义的数据源。例如,通过从“页数据”视图删除 bean 属性,可以将数据表添加至 portlet 页。

    1. 您可以添加一般数据组件,如 Java™ beanWeb Service。如果您要使用 Java bean 或 Web Service,将这些项从“页数据”视图或数据抽屉中拖放到选用板上,并完成适当的向导。
    2. 如果使用了关系记录,则可以将组件表添加至 portlet 页。关系记录中的每个字段在表中表示为一行。每行内包含的组件取决于正在添加的数据类型以及用户要在 portlet 页中如何使用关系记录(即,创建、更新或显示)。 如果您要添加使用 WDO 的关系记录,则您可以使用两个 Faces 组件:
      • 关系记录 - 此组件返回单个关系记录且可以绑定至数据表或其它组件。
      • 关系记录列表 - 此组件返回关系记录列表且可以绑定至数据表或其它组件。
      使用关系记录和关系记录列表的优点是您可以从关系数据库检索、创建、更新或删除信息,并且可以有选择地绑定此信息以对最终用户显示。
      注: 目前,在 Faces portlet 中使用关系记录关系记录列表组件仅适用于原型制作。当您拖放这些组件中的其中一个时,将显示对此操作的警告消息。
  4. 定制 Faces portlet。 您可以将可重用的 UI 组件(如输入字段、命令按钮、超链接、选项卡式面板和媒体播放器)拖放至 portlet JSP 文件。
    注: 在 JSP 编辑环境(Page Designer)中,涉及添加和配置 Faces 组件的大部分开发步骤在标准 Faces 和 Faces portlet 模型中都是相同的。
    1. 如有必要,通过在“项目资源管理器”视图中双击 portlet 中的 JSP 文件来打开这些文件。
    2. 添加 Faces 组件。包括 Faces 组件的抽屉显示在 Page Designer 窗口右边的选用板中。选择一个组件并将它拖至 JSP 文件的“设计”或“源代码”视图中。支持该组件的标记将添加至 JSP 文件。 有关添加特定组件的详细信息,请参阅下列主题:
    3. 配置 Faces 组件。
      • 在 Page Designer 窗口中突出显示该组件。
      • 属性视图中,确保您想修改的组件显示在其中一个“属性”视图中。设置类型随您正在编辑的 Faces 组件的类型而定。有关可以使用组件的“属性”视图来设置的属性的描述,请参阅 Faces 组件的属性
    4. 将脚本化事件添加至 Web 页面。例如,可以在 Faces JSP 页中对 Faces 组件指定操作。
    5. 如果需要,使用开发协作 portletFaces 直接 portlet 消息传递中的指示信息来添加对 portlet 消息传递的支持。您还可以添加人员感知支持(请参阅将人员感知添加至 portlet JSP 文件)以将 portlet 的通信能力扩展到协作环境中的每个成员。
    6. 添加支持文本和图像。在添加并配置 Faces 组件之后,使用 HTML 或其它 JSP 标记来添加任何其它文本和图像
  5. 测试您的 portlet
    1. 在“项目资源管理器”视图中,右键单击 portlet 项目并选择运行 > 在服务器上运行
    2. 选择服务器向导中,选择 WebSphere Portal 测试环境
    3. 单击完成 WebSphere® Portal 测试环境将启动,然后在浏览器窗口中显示您的 portlet。
相关概念
开发协作 portlet
相关任务
将人员感知添加至 portlet JSP 文件
在 portlet JSP 文件中插入图像
对 portlet 进行测试、调试或概要分析
定义服务器以测试 portlet
使用条款 | 反馈
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.