创建 portlet 项目(JSR 168)

可以创建并维护 Portlet 项目(JSR 168)中使用 JSR 168 portlet API 的 portlet 应用程序的资源。可以将 Portlet 项目添加至新的或现有企业应用程序项目。

请参阅下列主题以了解关于创建特殊 portlet 的更多详细信息:
对于 JSR 168 portlet 项目,存在以下局限性:
  • 某些 JSR 168 portlet API 定制标记(<namespace><actionURL> 等)不能在 Faces portlet JSP 文件的 <view> 标记中使用。Faces portlet JSP 文件的“片段”视图中的片段要在 <view> 标记之后插入。
  • 使用 <actionURL> 的“portletMode”属性更改 portlet 属性会导致 Faces portlet 无法存储数据和调用操作。代替办法是使用 Faces 操作中的 ActionResponse#setPortletMode() 来更改 portlet 方式

要创建新的 JSR 168 portlet 项目,遵循下列步骤:

  1. 选择文件 > 新建 > 项目。然后,选择右边的 Portlet 项目(JSR 168)选项,然后单击下一步按钮。 新建 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 时,才取消选择此复选框。
    EAR 项目
    企业应用程序项目(EAR 项目)的名称,portlet 项目应该与该项目关联以便部署。将在此项目中添加用于在测试环境中将 portlet 项目部署至 WebSphere Portal 的信息。所有与一个 EAR 项目关联的 portlet 应用程序都将在测试环境中的单个会话上运行。您可以把 portlet 应用程序分为多个 EAR 项目。您应该对相关的其它项目使用相同的 EAR 项目。
    上下文根
    portlet 项目的上下文根。当在测试环境中将 portlet 应用程序部署至 WebSphere Portal 时,它被用作 portlet 应用程序的顶级目录。它一定不能与其它项目使用的上下文根相同。
    添加对已注释 Java™ 类的支持
    如果计划使用模型注释在项目中生成代码,则确保此复选框已选中。

    如果想要接受与基本 JSR 168 portlet 项目相关联的缺省值,则单击完成。如果想要定制项目选项,或者想要创建支持另一类型的 portlet 的项目,则单击下一步

  3. 选择适用于 portlet 项目的 portlet 类型。 有关 portlet 类型的更多信息,请参阅创建 portlet 和 portlet 项目
    空 portlet
    创建 portlet 应用程序,该应用程序扩展 GenericPortlet 类并且包括最基本的代码。如果您是从头开始创建新的 portlet 应用程序,请参阅定制空的 portlet 项目
    基本 portlet
    创建扩展 PortletAdapter 类的基本 portlet 应用程序。这是完整的应用程序,带有具体 portlet 和具体 portlet 应用程序。它包含扩展 PortletAdapter 类的 portlet 类、用来呈示 portlet 的样本 JSP 文件以及一个样本 Java bean。除这些基本资源之外,当您指定其它向导选项时,可以为 portlet 应用程序经常使用的功能将样本代码添加到项目中。
    Faces portlet
    创建 Faces portlet 应用程序。有关更多的详细信息,请参阅创建 Faces portlet 项目
    Struts portlet
    创建 Struts portlet 应用程序。有关更多的详细信息,请参阅创建 Struts portlet 项目
  4. 选择一个或多个必要的 Web 项目功能。如果要创建基本 portlet 或空的 portlet,则取消选择 Web 图复选框。有关 WebSphere Portal 如何支持使用 JSP 标准标记库(JSTL)中的标记的更多信息,参阅 WebSphere Portal InfoCenter 中的“Using JSTL tags in the portal JSPs”(请参阅 WebSphere Portal Product Documentation)。
  5. 单击下一步
  6. 在“Portlet 设置”页中更新或添加任何一般 portlet 设置,然后单击下一步。(有关这些选项的更多信息,请参阅创建 portlet 项目(IBM API)。) 如果是创建空的 portlet,在单击下一步时将直接跳至向导的“其它”页面。如果单击完成来创建空的 portlet,向导将创建填有适当的文件夹结构以及部署描述符的空项目容器。要完成 portlet 应用程序,您需要定制新的空 portlet 项目。请参阅定制空的 JSR 168 portlet 项目
  7. 在“操作和首选项”页中,定义 portlet 的操作处理和首选项处理。
    添加操作请求处理程序
    此选项实现 processAction 方法以处理操作请求。当接收到与 portlet 操作相关联的 HTTP 请求时,将调用操作请求处理程序。
    添加表单样本
    此选项在视图面板中添加表单样本。
    添加首选项处理
    此选项在视图面板上显示首选项。它还提供编辑面板以修改 portlet 首选项。Portlet 首选项将作为持久数据进行存储并且可能用于个性化首选项。
    添加首选项验证器
    此选项添加首选项验证器类以验证首选项。
  8. 单击下一步
  9. 如果之前选择 WebSphere Portal V5.1 作为目标服务器,则可以添加样本代码以支持在“单点登录”页面上进行凭证保险库处理。这允许用户和管理员安全地存储用于认证的凭证。要获取有关凭证保险库处理的更多信息,请参阅 WebSphere Portal Information Center 中的“Portlet authenticationportlet”。
    添加凭证保险库处理
    选择此选项以支持凭证保险库处理。WebSphere Portal 支持使用凭证保险库,用户和管理员可以在其中安全地存储用于认证的凭证。用来从保险库抽取用户凭证的 portlet 可以使用户无需登录。选择下列其中一种类型的保险库槽。
    使用 portlet 专用凭证保险库槽
    portlet 专用槽存储不在 portlet 之间共享的用户凭证。
    使用共享凭证保险库槽
    共享槽存储在用户的 portlet 之间共享的用户凭证。
    使用管理凭证保险库槽
    管理槽允许每个用户存储他们的机密信息,这些机密信息用于访问管理员定义的资源(例如,Lotus Notes®)。
    使用系统凭证保险库槽
    系统槽存储系统凭证,是所有用户和 portlet 共享实际机密信息的位置。
    槽名称
    定义存储和检索用户凭证的凭证保险库槽的名称。
    显示密码
    选择此选项以在查看方式下在屏幕上显示密码。
    单击下一步
  10. 在“其它”页中,指定想要对项目中的 portlet 启用的任何其它标记和方式。
    • 必须由所有 portlet 应用程序支持的 HTML 标记通常由向导生成。
    • 向导将通过使用 IBM® 扩展 wps.markup 生成 portlet 项目,这将允许 portlet 进一步标记扩展出纯 MIME 类型的区别。有关此 IBM 扩展的更多信息,参阅 Developing portlets using JSR 168 and WebSphere Portal V5.02
    • 总是选择查看方式。
    • 如果在“操作和首选项”页中已选择添加首选项处理选项,则编辑方式会自动添加至生成的 portlet。
  11. 单击完成以创建新的 portlet 项目。
  12. 如果显示确认透视图切换对话框,则单击。如果不希望每次都出现此项提示,则选择不要再显示此消息复选框。
  13. 对有些 portlet 配置参数指定了缺省值。要通过编辑 portlet 部署描述符来重新配置这些值,请参阅定制 JSR 168 portlet。根据所选内容,将生成带有样本 JSP 文件的样本 portlet。要将其它 portlet 添加至 portlet 项目,请参阅创建 portlet。要添加 portlet JSP 文件,请参阅创建 portlet JSP 文件
相关概念
创建 portlet 和 portlet 项目
使用 portlet 部署描述符
标记语言
相关任务
定制 JSR 168 portlet
创建 portlet
创建 portlet JSP 文件
定制空的 JSR 168 portlet 项目

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