创建 Faces portlet 项目

根据是想要基于 IBM® portlet API 还是 JSR 168 portlet API 创建 Faces portlet 资源,必须选择适当的向导来创建 Faces portlet 项目。
将在创建项目过程中添加缺省 Faces portlet。该向导将自动生成相关的 portlet 配置文件、所需的目录结构和对 web.xml 文件的必需更新。
  1. 从菜单栏中选择文件 > 新建 > Portlet 项目以创建包含 IBM portlet 的 portlet 项目。从菜单栏中选择文件 > 新建 > Portlet 项目(JSR 168)以创建包含 JSR 168 portlet 的 portlet 项目。 用于适当 portlet 项目类型的向导将打开。
  2. 为下列字段提供相应的值:
    项目名
    新 portlet 项目的名称。
    项目位置
    在文件系统中将要创建项目的位置。可以使用浏览来更改文件系统位置。
    创建 portlet
    如果不想在项目中创建初始 portlet 定义,则清除此复选框。在将 portlet WAR 文件导入到项目中时,通常不必创建 portlet。
    要设置项目的 J2EE 设置,或者对项目指定目标运行时服务器,则单击显示高级 >> 按钮,并提供下列任何一个值:
    将模块添加至 EAR 项目
    仅当不打算部署 portlet 时,才取消选择此复选框。
    Servlet 版本
    指定要包括在 portlet 应用程序中的 Servlet 和 JSP 规则的版本。版本 2.3 是缺省值,包括 Servlet 规范级别 2.3 和 JSP 规范级别 1.2。此缺省值应该用于创建面向 WebSphere® Portal 5.0 或 5.1 服务器的 portlet 项目。

    注意,servlet 版本将确定出现在下拉列表中的目标服务器选项。

    目标服务器
    选择 portlet 应用程序将安装至的 WebSphere Portal 版本(WebSphere Portal V5.0 或 V5.1)
    注: 确保您不会不小心选择其中一个 WebSphere Application Server 选项。
    EAR 项目
    企业应用程序项目(EAR 项目)的名称,portlet 项目应该与该项目关联以便部署。将在此项目中添加用于在测试环境中将 portlet 项目部署至 WebSphere Portal 的信息。所有与一个 EAR 项目关联的 portlet 应用程序都将在测试环境中的单个会话上运行。您可以把 portlet 应用程序分为多个 EAR 项目。您应该对相关的其它项目使用相同的 EAR 项目。
    上下文根
    portlet 项目的上下文根。当在测试环境中将 portlet 应用程序部署至 WebSphere Portal 时,它被用作 portlet 应用程序的顶级目录。它一定不能与其它项目的上下文根相同。
    添加对已注释 Java™ 类的支持
    如果计划使用模型注释在项目中生成代码,则确保此复选框已选中。
  3. 单击下一步
  4. 单击 Faces portlet 单选按钮。如果想要接受与支持 Faces 的 portlet 项目相关联的缺省值,则单击完成。如果想要定制项目选项,则单击下一步
  5. 如果选择了为项目创建 Web 图复选框,将在项目中创建 Web 图(.gph)文件。要创建使用“JSP 标准标记库”标记的 portlet 项目,从 Web 项目功能部件列表中选择 JSP 标准标记库。有关 WebSphere Portal 如何支持使用来自 JSP 标准标记库(JSTL)的标记的更多信息,请参阅 WebSphere Portal 信息中心中的『在门户网站 JSP 中使用 JSTL 标记』。
  6. 在“Portlet 设置”页中更新或添加任何一般 portlet 设置。单击下一步
  7. 在“其它”页中,指定想要对项目中的 portlet 启用的任何其它方式。

    选择创建 portlet 子类复选框,使用向导中先前定义的常用类和包名前缀来创建子类 com.ibm.faces.webapp.WPFacesGenericPortlet(如果 portlet 使用 JSR 168 API,则为 com.ibm.faces.webapp.FacesGenericPortlet),并插入调用超级实现的方法存根。可根据您的选择定制 portlet 类。

    缺省情况下,选择了查看方式,但可以取消选择它。对于选择的每种方式(包括“查看”),可以指定除缺省页之外的“初始”页,它是使用项目名称构建的。初始页字段采用相对于 Web Content 文件夹的路径规范(例如,如果您输入 /folder/subfolder/TestView.jsp,则将在 /WebContent/folder/subfolder 目录中创建 TestView.jsp)。将创建当前不存在的文件夹。前导“/”是可选的。

    模型下拉列表中,可以选择 Portlet(对于标准 Faces portlet JSP 文件)或带有客户端数据高速缓存的 Portlet以将 Faces Client 框架功能及 JSP 文件中的相应 taglib 伪指令添加至该项目。

    当完成向导时,将创建指定的初始 JSP 文件并在 portlet.xml 中自动生成相应的 <config-param>(对于 IBM portlet)或 <init-param>(对于 JSR 168 portlet)值。要在创建 portlet 之后添加其它方式,必须使用“Portlet 部署描述符”编辑器指定配置参数。
  8. 单击完成 将使用 web.xml 和 portlet.xml 中的适当 Faces portlet 定义创建新的 portlet 项目。
相关概念
创建 Faces portlet 和项目
Faces portlet 通信
相关任务
创建 Faces portlet
添加和更新现有 IBM portlet 的 Faces portlet 方式
添加和更新现有 JSR 168 portlet 的 Faces portlet 方式
创建 Faces portlet JSP 文件
创建 Faces 应用程序 - 概述
相关参考
Faces 组件参考
Faces 组件的属性
使用条款 | 反馈
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.