创建 portlet 项目(IBM API)

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

请参阅下列主题以了解关于创建特殊 portlet 的更多详细信息:
为 WebSphere® Portal 5.0 或 5.1 开发的 portlet 应用程序在 WebSphere Portal 4.2 上不受支持。Rational® Developer 确实支持将 portlet 项目从 WebSphere Portal 4.2 迁移至 WebSphere Portal 5.x。有关 portlet 项目迁移过程的详细描述,请参阅 Rational Developer Migration Guide
注: WebSphere Portal 5.0 portlet 需要迁移至 WebSphere Portal 5.1 就能运行。但是,应查看将 WebSphere Portal V5.0 portlet 迁移至 V5.1 中的信息。

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

  1. 选择文件 > 新建 > 项目。然后,选择右边的 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 项目。

    如果要创建空的 portlet 项目并且打算将 WebSphere Portal 4.x portlet WAR 文件导入该 portlet 项目中,则使用 2.2 servlet 版本。版本 2.2 包括 Servlet 规范级别 2.2 和 JSP 规范级别 1.1。如果选择此级别,就无法使用如 Servlet 过滤器和生命周期事件侦听器之类的功能部件。

    注意,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™ 类的支持
    如果计划使用模型注释在项目中生成代码,则确保此复选框已选中。

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

  3. 选择适用于 portlet 项目的 portlet 类型。 有关 portlet 类型的更多信息,请参阅创建 portlet 和 portlet 项目
    空 portlet
    创建 portlet 应用程序,该应用程序扩展 PortletAdapter 类并且包括最基本的代码。如果您是从头开始创建新的 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. 单击下一步
  5. 选择一个或多个必要的 Web 项目功能。如果要创建基本 portlet 或空的 portlet,则取消选择 Web 图复选框。有关 WebSphere Portal 如何支持使用 JSP 标准标记库(JSTL)中的标记的更多信息,参阅 WebSphere Portal Information Center 中的“Using JSTL tags in the portal JSPs”(请参阅 WebSphere Portal Product Documentation)。
  6. 单击下一步
  7. 在“Portlet 设置”页中更新或添加任何一般 portlet 设置:
    应用程序名称
    portlet 应用程序的名称。门户网站管理员用它管理 portlet 应用程序。要在将来更新此 portlet 名称,使用 portlet 部署描述符编辑器并更新每个具体 portlet 应用程序的显示名称
    Portlet 名称
    portlet 的名称。门户网站管理员使用它来管理 portlet。要在将来更新此 portlet 名称,使用 portlet 部署描述符编辑器并更新每个具体 portlet 的显示名称
    缺省语言环境
    选择在无法确定客户机语言环境的情况下使用的缺省语言环境。要添加更多受支持的语言环境,使用 portlet 部署描述符编辑器来在每个具体 portlet 中添加语言环境
    portlet 标题
    缺省语言环境的 Portlet 标题。此标题出现在 portlet 标题栏上。要在将来更新此 portlet 名称,使用 portlet 部署描述符编辑器并更新每个具体 portlet 的标题
    更改代码生成选项
    选择它以更改包前缀和/或类前缀
    包前缀
    Java 包名的前缀。
    类前缀
    Java 类名的前缀。
  8. 如果是创建空的 portlet,在单击下一步时将直接跳至向导的“其它”页面。要完成创建基本 portlet,单击下一步 如果单击完成来创建空的 portlet,向导将创建填有适当的文件夹结构以及部署描述符的空项目容器。要完成 portlet 应用程序,您需要定制新的空 portlet 项目。请参阅定制空的 portlet 项目
  9. (可选)在新的 portlet 项目中添加 portlet 应用程序经常用于事件处理的样本代码。
    Portlet 操作事件
    当接收到与 portlet 操作关联的 HTTP 请求时,ActionEvent 被发送到 portlet。
    添加操作侦听器
    获取实现 ActionListener 接口以处理 ActionEvent 对象的 Java 类。
    添加表单样本
    获取用于查看方式的 JSP 文件,包括用于借助 Java 类处理 ActionEvent 的表单样本。
    协作 portlet
    协作 portlet 提供模型以使用 WebSphere Portal 属性代理声明、发布信息以及相互共享信息。要获取有关协作 portlet 的更多信息,请参阅 WebSphere Portal Information Center 中的“Cooperative portlets”。仅当向导的初始页面中的 Servlet 级别选项为 2.3 或更高时,协作 portlet 选项才可用。由向导生成的协作 portlet 可以在 WebSphere Portal 5.x 服务器上运行。
    启用“单击激活操作”目标
    此操作添加样本 WSDL 文件,以便“单击激活操作”目标可以接收输入属性。如果您在此面板中选择此选项时,在 Portlet 操作事件组中的添加表单样本选项,则生成的 portlet 项目将作为“单击激活操作”接收方启用。否则,必须创建您自己的操作处理程序和表单,然后按您的需要定制 WSDL 文件。
    添加“单击激活操作”发送方 portlet 样本
    此操作添加简单“单击激活操作”发送方 portlet。此 portlet 对于测试接收方功能非常有用,并可用来引用“单击激活操作”源(发送方)portlet 的样本 JSP 文件。
    启用“单击激活操作”源
    此操作为“单击激活操作”源 portlet 的 JSP 文件添加“单击激活操作”标记库伪指令,以便“单击激活操作”源可以发布 JSP 文件的输出属性。要更改将发送的“单击激活操作”操作,应该定制此 jsp 页面以使用 <c2a:encodeProperties> 和 <c2a:encodeProperty> 标记。
    Portlet 消息事件
    如果接收 portlet 与发送 portlet 放置在同一个页面上,消息事件就可从一个 portlet 发送到其它 portlet。
    添加消息侦听器
    获取实现 MessageListener 接口以处理 MessageEvent 对象的 Java 类。
    添加消息发送方 portlet 样本
    获取两个 portlet。一个是消息发送方 portlet,另一个是处理消息事件的 portlet。
    事件日志查看器
    添加事件日志查看器
    添加在查看方式下侦听器所接收事件的功能。要选择此选项,至少需要添加其中一个事件侦听器。
    添加编辑面板以更改最大事件计数
    支持编辑方式。PortletData 对象用于保存用户持久数据,并且添加了用于编辑方式的 JSP 文件。在此编辑方式下,可以更改缺省最大事件计数。
  10. 单击下一步
  11. 添加样本代码以支持在“单点登录”页面上进行凭证保险库处理。这允许用户和管理员安全地存储用于认证的凭证。要获取有关凭证保险库处理的更多信息,请参阅 WebSphere Portal Information Center 中的“Portlet authenticationportlet”。
    添加凭证保险库处理
    选择此选项以支持凭证保险库处理。WebSphere Portal 支持使用凭证保险库,用户和管理员可以在其中安全地存储用于认证的凭证。用来从保险库抽取用户凭证的 portlet 可以使用户无需登录。选择下列其中一种保险库槽类型。
    使用 portlet 专用凭证保险库槽
    portlet 专用槽存储不在 portlet 之间共享的用户凭证。
    使用共享凭证保险库槽
    共享槽存储在用户的 portlet 之间共享的用户凭证。
    使用管理凭证保险库槽
    管理槽允许每个用户存储他们的机密信息,这些机密信息用于访问管理员定义的资源(例如,Lotus Notes®)。
    使用系统凭证保险库槽
    系统槽存储系统凭证,是所有用户和 portlet 共享实际机密信息的位置。
    槽名称
    定义存储和检索用户凭证的凭证保险库槽的名称。
    显示密码
    选择此选项以在查看方式下在屏幕上显示密码。
  12. 单击下一步
  13. 在“其它”页中,指定想要对项目中的 portlet 启用的任何其它标记和方式。由所有 portlet 应用程序必须支持的 HTML 标记通常由向导生成。有关标记语言的更多信息,请参阅标记语言
    添加 chtml 标记支持
    添加对 iMode 移动电话浏览器的标记支持。
    添加 wml 标记支持
    添加对 WAP 移动电话浏览器的标记支持。
    选择要支持的 portlet 方式。向导总是会生成查看方式。所有 portlet 应用程序都必须支持它。
    添加编辑方式
    连同样本编辑面板一起添加对编辑方式的支持。如果您已选择“事件处理”面板中的添加编辑面板以更改最大的编辑数或“单点登录”面板中的添加凭证保险库处理,则此选项禁用。将使用这些选项添加编辑方式。
    添加帮助方式
    连同样本帮助面板一起添加对帮助方式的支持。
    添加配置方式
    连同样本配置面板一起添加对配置方式的支持。
  14. 单击完成以创建新的 portlet 项目。
  15. 如果显示确认透视图切换对话框,则单击。如果不希望每次都出现此项提示,则选择不要再显示此消息复选框。
  16. 对有些 portlet 配置参数指定了缺省值。要通过编辑 portlet 部署描述符来重新配置这些值,请参阅定制 IBM API portlet。根据所选内容,将生成带有样本 JSP 文件的样本 portlet。要将其它 portlet 添加至 portlet 项目,请参阅创建 Portlet。要添加 portlet JSP 文件,请参阅创建 portlet JSP 文件
注: 对于已启用“单击激活操作”的 portlet,“问题”视图中将显示 WS-I 一致性警告消息。在“单击激活操作”WSDL 资源中,可以忽略它们。并且,如果不想显示这些警告消息,则更改 WS-I 一致性首选项上的一致性级别:
  1. 选择窗口 > 首选项 > 工作台 > 功能
  2. 展开 Web Service 开发者,然后确保已选中 Web Service 开发
  3. 单击应用,然后单击确定
  4. 选择窗口 > 首选项 > Web Service > WS-I 一致性
  5. 将一致性级别设置为忽略一致性,然后单击应用并单击确定
相关概念
创建 portlet 和 portlet 项目
使用 portlet 部署描述符
标记语言
开发协作 portlet
相关任务
定制 IBM API portlet
创建 portlet
创建 portlet JSP 文件
定制空的 portlet 项目

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