JavaServer Faces(Faces)是一门技术,它允许您构建包含预先构建的用户界面组件(Faces 组件)的 jsp 页面。可以在 Web 应用程序或 portlet 中包括包含
Faces 组件的 jsp 页面。提供了一个 JSP 定制标记库以支持使用 Faces 组件。
Rational
® Developer
使用户能够将 Faces 组件拖至 jsp 页面并配置它们以供其 Web 应用程序或 portlet 使用。要创建和测试 JavaServer Faces portlet,遵循下列步骤:
注: 有关更详细的指示信息,使用提供的主题链接。
- 创建 Faces portlet 项目。
- 选择。然后,选择右边的
Portlet 项目或 Portlet 项目(JSR 168)选项,然后单击下一步按钮。
- 指定项目的名称和位置。 您还可以单击显示高级按钮来更改其它项目级别的设置。
- 选择 Faces portlet 单选按钮。
- 如果希望执行下列操作,可以单击下一步:
- 包括其它 Web 项目功能,如 JSP 标准标记库(JSTL)。
- 更改应用程序名称或 portlet 名称。
- 更改缺省语言环境(语言)和标题。
- 更改包或类前缀。
- 将“编辑”、“帮助”或“配置”方式添加至您的 portlet(将自动添加“查看”,但可以取消选择它)。
- 单击完成。 向导将创建 portlet 项目,并打开 Portlet 部署描述符,并对于“查看”方式打开 JSP 文件(缺省情况下)。如果包括了“编辑”、“帮助”或“配置”方式,则还会为每种方式创建一个 JSP。这些 JSP 的缺省名称分别为 projectNameView.jsp、projectNameEdit.jsp、projectNameHelp.jsp 和 projectNameConfigure.jsp。
- 创建 Faces portlet JSP 文件。 例如,创建将在您的应用程序中用作输入和输出表单页的其它 JSP 文件。
- 在“项目资源管理器”中,从项目的上下文菜单中选择。 “新建 Faces JSP 文件”向导将打开。
- 为 JSP 文件提供名称,并为您的 portlet 提供适当的模型类型。
- (可选)选择配置高级选项复选框来添加标记库,指定编码、内容类型和文档类型信息,并为 JSP 文件生成方法存根。
- 单击完成。 将创建带有适当标记的 JSP 文件并自动在 Page Designer 编辑窗格中打开它。
- 将组件的数据访问权添加至您的 portlet。对于 portlet 中的每个 JSP 文件,在“项目导航器”视图中双击该文件。这将在 Page Designer 中打开 JSP 文件。从“选用板”视图或“页数据”视图上的“数据”抽屉中,将一个组件拖放至您的 portlet JSP 文件。
缺省情况下,还会将适合于正在添加的数据类型的 Faces 组件添加至 JSP 文件。这些 Faces 组件将绑定至已定义的数据源。例如,通过从“页数据”视图删除 bean 属性,可以将数据表添加至 portlet 页。
- 您可以添加一般数据组件,如 Java™ bean 和 Web Service。如果您要使用 Java bean 或 Web Service,将这些项从“页数据”视图或数据抽屉中拖放到选用板上,并完成适当的向导。
- 如果使用了关系记录,则可以将组件表添加至 portlet 页。关系记录中的每个字段在表中表示为一行。每行内包含的组件取决于正在添加的数据类型以及用户要在 portlet 页中如何使用关系记录(即,创建、更新或显示)。 如果您要添加使用 WDO 的关系记录,则您可以使用两个 Faces 组件:
- 关系记录 - 此组件返回单个关系记录且可以绑定至数据表或其它组件。
- 关系记录列表 - 此组件返回关系记录列表且可以绑定至数据表或其它组件。
使用关系记录和关系记录列表的优点是您可以从关系数据库检索、创建、更新或删除信息,并且可以有选择地绑定此信息以对最终用户显示。
注: 目前,在 Faces portlet 中使用关系记录和关系记录列表组件仅适用于原型制作。当您拖放这些组件中的其中一个时,将显示对此操作的警告消息。
- 定制 Faces portlet。 您可以将可重用的 UI 组件(如输入字段、命令按钮、超链接、选项卡式面板和媒体播放器)拖放至 portlet JSP 文件。
注: 在 JSP 编辑环境(Page Designer)中,涉及添加和配置 Faces 组件的大部分开发步骤在标准 Faces 和 Faces portlet 模型中都是相同的。
- 如有必要,通过在“项目资源管理器”视图中双击 portlet 中的 JSP 文件来打开这些文件。
- 添加 Faces 组件。包括 Faces 组件的抽屉显示在 Page Designer 窗口右边的选用板中。选择一个组件并将它拖至 JSP 文件的“设计”或“源代码”视图中。支持该组件的标记将添加至 JSP 文件。 有关添加特定组件的详细信息,请参阅下列主题:
- 配置 Faces 组件。
- 在 Page Designer 窗口中突出显示该组件。
- 在属性视图中,确保您想修改的组件显示在其中一个“属性”视图中。设置类型随您正在编辑的 Faces 组件的类型而定。有关可以使用组件的“属性”视图来设置的属性的描述,请参阅 Faces 组件的属性。
- 将脚本化事件添加至 Web 页面。例如,可以在 Faces jsp 页面中对 Faces 组件指定操作。
- 如果需要,使用开发协作 portlet 或 Faces 直接 portlet 消息传递中的指示信息来添加对
portlet 消息传递的支持。您还可以添加人员感知支持(请参阅将人员感知添加至 portlet JSP 文件)以将
portlet 的通信能力扩展到协作环境中的每个成员。
- 添加支持文本和图像。在添加并配置 Faces 组件之后,使用 HTML 或其它 JSP 标记来添加任何其它文本和图像。
- 测试您的 portlet
- 在“项目资源管理器”视图中,右键单击 portlet
项目并选择。
- 在选择服务器向导中,选择 WebSphere
Portal 测试环境。
- 单击完成。 WebSphere® Portal 测试环境将启动,然后在浏览器窗口中显示您的 portlet。