创建 Struts portlet 项目

根据是想要基于 IBM® portlet API 还是 JSR 168 portlet API 创建 Struts portlet 资源,必须选择适当的向导来创建 Struts portlet 项目。

将在创建项目过程中添加缺省的支持 Struts 的 portlet 和 Web 图文件(可选)。该向导将自动生成 Struts portlet 配置文件以及 web.xml 文件和 portlet.xml 文件的必要更新,并将所有 SPF 标记库和 JAR 文件添加至所需目录结构的项目中。

要创建 Struts portlet 项目:

  1. 从菜单栏中选择文件 > 新建 > Portlet 项目,以创建包含 IBM API portlet 的 Portlet 项目。从菜单栏中选择文件 > 新建 > Portlet 项目(JSR 168),以创建包含 JSR 168 API portlet 的 portlet 项目。 用于适当 portlet 项目类型的向导将打开。
  2. 为下列字段提供相应的值:
    项目名
    新 portlet 项目的名称。
    项目位置
    在文件系统中将要创建项目的位置。可以使用浏览来更改文件系统位置。
    WebSphere® Portal 版本
    为 Portlet 项目选择适当的 WebSphere Portal 版本。您所作的选择将为开发环境设置适当的 servlet 和相应的目标服务器。
    创建 portlet
    如果不想在项目中创建初始 portlet 定义,则清除此复选框。在将 portlet WAR 文件导入到项目中时,通常不必创建 portlet。
    要设置项目的 J2EE 设置,或者对项目指定目标运行时服务器,则单击显示高级 >> 按钮,并提供下列任何一个值。
    注: 通过选择上面所说的 WebSphere Portal 版本值,就会为 Servlet 版本目标服务器设置适当的值。建议不要编辑这两个字段。
    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 项目
    仅当不打算部署 portlet 时,才取消选择此复选框。建议将其保留为已选中状态,否则您将无法部署 portlet。
    EAR 项目
    企业应用程序项目(EAR 项目)的名称,portlet 项目应该与该项目关联以便部署。将在此项目中添加用于在测试环境中将 portlet 项目部署至 WebSphere Portal 的信息。所有与一个 EAR 项目关联的 portlet 应用程序都将在测试环境中的单个会话上运行。您可以把 portlet 应用程序分为多个 EAR 项目。您应该对相关的其它项目使用相同的 EAR 项目。
    上下文根
    portlet 项目的上下文根。当在测试环境中将 portlet 应用程序部署至 WebSphere Portal 时,它被用作 portlet 应用程序的顶级目录。它一定不能与其它项目使用的上下文根相同。
    添加对已注释 Java™ 类的支持
    如果计划使用模型注释在项目中生成代码,则确保此复选框已选中。
  3. 单击下一步
  4. 单击 Struts portlet 单选按钮。如果想要接受与支持 Struts 的 portlet 项目相关联的缺省值,则单击完成。如果想要定制项目选项,则单击下一步
  5. Web 项目功能列表中的 Web 图在缺省情况下是选中的。这将为项目创建 Web 图(.gph)文件。 Web 图文件允许您直观地设计基于 Struts 的应用程序或 Faces 应用程序的应用程序流。在您已通过添加 Web 页面、操作、连接和其它应用程序元素来设计应用程序之后,您可以实现元素并生成以 Web 图为模型的文件。
  6. 要创建使用“JSP 标准标记库”标记的 portlet 项目,从 Web 项目功能部件列表中选择 JSP 标准标记库。有关 WebSphere Portal 如何支持使用 JSP 标准标记库(JSTL)中的标记的更多信息,请参阅 WebSphere Portal Information Center 中的“Using JSTL tags in the portal JSPs”。
  7. 单击下一步
  8. 在“Portlet 设置”页中提供适当的一般设置。单击下一步
  9. 在“Struts Portlet 设置”页中更新任何特定于 Struts portlet 的设置。缺省情况下,该向导将创建资源束。将使用指定的项目名称构建 Java 包名缺省值。
  10. 单击下一步
  11. 在“其它”页中,指定想要对项目中的 portlet 启用的任何其它标记和方式。
    1. Struts portlet 一直都支持 html 标记。您可以将压缩 HTML(chtml)或 WML 1.3(wml)标记支持添加至项目。Rational® Developer 当前支持这些标记。
    2. 为您要对 portlet 启用的任何其它方式选择适当的复选框。缺省情况下,始终提供查看方式。
  12. 单击完成 将使用 web.xml 和 portlet.xml 中的 Struts portlet 定义创建新的 portlet 项目。
相关概念
Struts portlet 应用程序
创建 Struts portlet 和项目
基于 Struts 的 Web 应用程序 - 概述
用于应用程序开发的 Struts 工具
Web 图和 Web 图编辑器
相关任务
创建 Struts portlet
创建 Struts portlet JSP 文件
创建架构良好的、使用 Struts 的 Web 应用程序
为新的应用程序创建 Web 图
相关参考
Struts 1.1 与 SPF 标记库类之间的差别

(C) Copyright IBM Corporation 2002, 2005. All Rights Reserved.