练习 1.1:设置

在开始此教程中的 portlet 和门户网站开发之前,必须执行一系列设置步骤:

  1. 创建项目并导入 portlet 开发所需的资源。
  2. 安装并配置 WebSphere Portal V5.1 测试环境,该测试环境允许您测试正要构建的应用程序。
  3. 配置数据库服务器,该数据库服务器将提供数据以在应用程序中运行。

第一步是将预先构建的 EJB 和 EJB 客户机项目导入到在教程中将使用的 portlet 项目中。您在创建 portlet 项目时所创建的 AuctionPortletEAR 将包含所导入的资源。这些项目提供了后端服务,我们将使用这些后端服务来创建包含在 portlet 项目中的 portlet。

创建新的 portlet 项目

所有 portlet 开发都是在 portlet 项目的上下文中执行的。要为 UserAdmin portlet 创建 portlet 项目,请遵循下列步骤:

  1. 打开 Rational Software Development Platform。
  2. 选择文件 > 新建 > 项目
  3. 选择 Portlet 项目选项。此选项将生成支持 IBM portlet API(与 JSR 168 portlet API 相对)的项目资源。单击下一步
  4. 单击确认启用对话框中的确定。此对话框将验证您想要启用门户网站开发功能。这些功能和一组相应的工具是您的开发环境的元素,它们自动执行许多编程标准和代码生成功能,以用于开发在 WebSphere Portal 上运行的、基于门户网站的 Web 应用程序。
  5. 将项目命名为 AuctionPortlet
    当输入项目的名称时,请注意(如果您单击显示高级 >> 按钮),此项目的模块会自动添加至名称相似的 EAR 项目中。
  6. 注意,WebSphere Portal 版本缺省为 5.1。单击下一步
  7. 选择 Faces Portlet 单选按钮,这是因为在构建 Web 应用程序的用户界面时,此教程中创建的 portlet 将利用 JavaServer Faces 和 portlet 工具提供的速度和灵活性。单击下一步
  8. 再次单击下一步
  9. 在“Portlet 设置”页面中,在 Portlet 名称字段中输入 UserAdmin portlet,而在 Portlet 标题字段中输入 User Admin
  10. 选择更改代码生成选项复选框。在类前缀字段中输入 UserAdminPortlet
  11. 单击下一步
  12. 在“其它”页面中,请注意,查看方式组中的初始页面值为 /UserAdminView.jsp。将在项目中生成此缺省页面,并且此缺省页面将充当 UserAdmin portlet 的主控页面。在将来的练习中,我们将添加更多页面。
  13. 单击完成

    如果提示您切换至“Web 透视图”,则单击

缺省 portlet 查看页面 UserAdminView.jsp 便显示在工作空间的编辑区域中。

导入此样本中使用的资源

要导入 AuctionPortal.zip(它包含预先构建的所有项目资源,这些是创建此教程中描述的接口和数据访问所必需的):

  1. 从菜单栏中选择文件 > 导入。将出现“导入”对话框。
  2. 选择导入源下面,单击项目交换
  3. 单击下一步。将出现导入项目交换内容对话框。
  4. 因为不同的 Rational 产品使用不同的安装目标位置,所以必须离开产品的用户界面以查找包含数据库内容的插件。使用文件搜索工具在本地文件系统的产品安装路径中查找 com.ibm.etools.portal.examples.application_6.0.0.1 插件文件夹。
  5. 单击源 zip 文件旁边的浏览,并浏览至位于以下位置的 AuctionPortal.zip
    x:\com.ibm.etools.portal.examples.application_6.0.0.1/samples
    其中 x: 是计算机上包含 com.ibm.etools.portal.examples.application_6.0.0.1 插件的绝对路径。单击打开
  6. 选择 AuctionEJB50AuctionEJB50Client 复选框。
  7. 单击完成

    该向导将把项目导入到您的工作空间中。

  8. 还必须将所导入的项目作为模块添加至 AuctionPortletEAR 项目。在“项目资源管理器”中,展开“企业应用程序”>“AuctionPortletEAR”并双击部署描述符:AuctionPortletEAR
  9. 选择模块选项卡。
  10. 单击“模块”下面的添加。选择 AuctionEJB50 并单击完成。如果更改目标服务器对话框要求您将模块目标服务器更改为 EAR 目标服务器,则单击
  11. 单击“项目实用程序 JAR”下面的添加。选择 AuctionEJB50Client 并单击完成。如果更改目标服务器对话框要求您将模块目标服务器更改为 EAR 目标服务器,则单击
  12. 保存并关闭部署描述符。

安装并配置 WebSphere Portal V5.1 测试环境

虽然可从产品启动板安装 WebSphere Portal V5.0 测试环境,但是此教程中的资源要在 WebSphere Portal 5.1 上运行。必须按产品《安装指南》中所述安装 WebSphere Portal 5.1 测试环境。安装要求您使用随 Rational 工具提供的 WebSphere Portal 介质。

在安装了这一版本的测试环境之后,还必须配置它以在您的工作空间中运行:

  1. 从菜单栏中选择窗口 > 首选项
  2. 展开服务器部分,然后单击已安装运行时
  3. 单击 WebSphere Portal V5.1 存根,选择该复选框并单击编辑
  4. 将名称更改为 WebSphere Portal V5.1 并使用您在安装测试环境时指定的 WebSphere Portal 5.1 测试环境安装目录覆盖 WebSphere Portal 位置WebSphere Application Server 位置值。
  5. 单击完成
  6. 在“首选项”对话框中单击确定

完成了上述步骤之后,WebSphere Portal V5.1 测试环境就可用于测试、调试和概要分析了。

接下来,必须配置包含此教程中应用程序要使用的数据的数据库服务器。

创建并配置包含样本应用程序数据库的服务器

在此练习中,必须导入并配置 Cloudscape 数据库以便为 AuctionPortal 应用程序提供数据。

  1. 显示“服务器”视图。该视图紧靠着“属性”视图和“快速编辑”视图。
  2. 从该视图的弹出菜单中,选择新建 > 服务器
  3. 从服务器类型列表中,选择 WebSphere Portal V5.1 测试环境
  4. 单击完成
  5. 双击“服务器”视图中的 WebSphere Portal V5.1 测试环境
  6. 选择服务器编辑器中的数据源选项卡。
  7. 服务器设置部分中,单击添加以将列表添加至 JDBC 提供程序列表。
  8. 在“创建 JDBC 提供程序”向导的第一个页面中,选择 Cloudscape 作为数据库类型,选择 Cloudscape JDBC 提供程序作为 JDBC 提供程序类型
  9. 单击下一步
  10. 名称字段中,输入 Cloudscape JDBC 提供程序
  11. 单击完成
  12. 单击在上面选择的 JDBC 提供程序中定义的数据源列表旁边的添加按钮。
  13. 在“创建数据源”向导的第一个页面中,选择 Cloudscape JDBC 提供程序并单击下一步
  14. 名称字段中,输入 Auction
  15. JNDI 名称字段中,输入 jdbc/auction
  16. 单击下一步
  17. 资源属性列表中,选择数据库名称
  18. 因为不同的 Rational 产品使用不同的安装目标位置,所以必须离开产品的用户界面以查找包含数据库内容的插件。使用文件搜索工具在本地文件系统的产品安装路径中查找 com.ibm.etools.auction.sampledb_6.0.0 插件文件夹。
  19. 返回到“创建数据源”向导,并在字段中输入以下路径:
    x:\com.ibm.etools.auction.sampledb_6.0.0\db\AUCTION60
    其中 x: 是计算机上包含 com.ibm.etools.auction.sampledb_6.0.0 插件的绝对路径。
  20. 单击完成
  21. 保存并关闭服务器配置文件。

现在,当您测试 AuctionPortlet 项目中的 portlet 时,由于您在“模块 1”中已经开发了它们,因此将能够访问 AUCTION60 数据库中的数据。

关于在此教程中使用的文件

现在,可以浏览 AuctionEJB50 和 AuctionEJB50Client 项目中的文件,这些文件中包含 portlet 页面的数据源和逻辑。在“项目资源管理器”视图中,当您展开各个文件夹时,其内容应该为如下所示:
“导航器”视图中的 AuctionPortletEJB

此项目中的资源将用来为此教程中将创建的 portlet 创建用户界面,并且提供对样本 Cloudscape 数据库中数据的访问权。UserFacade 和 ListingFacade 是两个 EJB 会话 bean,它们将提供一些方法,被从在此教程中创建的 portlet 调用。RegistrationData 和 ItemData 是两个数据访问 bean,用于在 portlet 与 Cloudscape 数据库之间通过使用实体 bean 来传送数据。EJB 项目将为实体 bean 提供数据库映射。

现在,您可以开始练习 1.2:准备 portlet 开发和定义应用程序流了。

反馈
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.