根据是想要基于 IBM®
portlet API 还是 JSR 168 portlet API 创建 Faces portlet 资源,必须选择适当的向导来创建 Faces portlet 项目。
将在创建项目过程中添加缺省 Faces portlet。该向导将自动生成相关的 portlet 配置文件、所需的目录结构和对 web.xml 文件的必需更新。
- 从菜单栏中选择以创建包含 IBM portlet 的 portlet 项目。从菜单栏中选择以创建包含 JSR 168 portlet 的 portlet 项目。 用于适当 portlet 项目类型的向导将打开。
- 为下列字段提供相应的值:
- 项目名
- 新 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™ 类的支持
- 如果计划使用模型注释在项目中生成代码,则确保此复选框已选中。
- 单击下一步。
- 单击 Faces portlet 单选按钮。如果想要接受与支持 Faces
的 portlet 项目相关联的缺省值,则单击完成。如果想要定制项目选项,则单击下一步。
- 如果选择了为项目创建 Web 图复选框,将在项目中创建
Web 图(.gph)文件。要创建使用“JSP 标准标记库”标记的 portlet 项目,从 Web
项目功能部件列表中选择 JSP 标准标记库。有关 WebSphere Portal
如何支持使用来自 JSP 标准标记库(JSTL)的标记的更多信息,请参阅 WebSphere Portal 信息中心中的『在门户网站 JSP 中使用 JSTL 标记』。
- 在“Portlet 设置”页中更新或添加任何一般 portlet 设置。单击下一步。
- 在“其它”页中,指定想要对项目中的 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 部署描述符”编辑器指定配置参数。
- 单击完成。 将使用 web.xml 和 portlet.xml 中的适当 Faces portlet 定义创建新的 portlet 项目。