练习 1.1:设置
在开始此教程中的 portlet 和门户网站开发之前,必须执行一系列设置步骤:
- 创建项目并导入 portlet 开发所需的资源。
- 安装并配置 WebSphere Portal V5.1 测试环境,该测试环境允许您测试正要构建的应用程序。
- 配置数据库服务器,该数据库服务器将提供数据以在应用程序中运行。
第一步是将预先构建的 EJB 和 EJB 客户机项目导入到在教程中将使用的 portlet 项目中。您在创建 portlet 项目时所创建的 AuctionPortletEAR 将包含所导入的资源。这些项目提供了后端服务,我们将使用这些后端服务来创建包含在 portlet 项目中的 portlet。
创建新的 portlet 项目
所有 portlet 开发都是在 portlet 项目的上下文中执行的。要为 UserAdmin portlet 创建 portlet 项目,请遵循下列步骤:
- 打开 Rational Developer。
- 选择文件 > 新建 > 项目。
- 选择 Portlet 项目选项。此选项将生成支持 IBM portlet API(与 JSR 168 portlet API 相对)的项目资源。单击下一步。
- 单击确认启用对话框中的确定。此对话框将验证您想要启用门户网站开发功能。这些功能和一组相应的工具是您的开发环境的元素,它们自动执行许多编程标准和代码生成功能,以用于开发在 WebSphere Portal 上运行的、基于门户网站的 Web 应用程序。
- 将项目命名为 AuctionPortlet。
当输入项目的名称时,请注意(如果您单击显示高级 >> 按钮),此项目的模块会自动添加至名称相似的 EAR 项目中。
- 注意,WebSphere Portal 版本缺省为 5.1。单击下一步。
- 选择 Faces Portlet 单选按钮,这是因为在构建 Web 应用程序的用户界面时,此教程中创建的 portlet 将利用 JavaServer Faces 和 portlet 工具提供的速度和灵活性。单击下一步。
- 再次单击下一步。
- 在“Portlet 设置”页面中,在 Portlet 名称字段中输入 UserAdmin portlet,而在 Portlet 标题字段中输入 User Admin。
- 选择更改代码生成选项复选框。在类前缀字段中输入 UserAdminPortlet。
- 单击下一步。
- 在“其它”页面中,请注意,查看方式组中的初始页面值为 /UserAdminView.jsp。将在项目中生成此缺省页面,并且此缺省页面将充当 UserAdmin portlet 的主控页面。在将来的练习中,我们将添加更多页面。
- 单击完成。
如果提示您切换至“Web 透视图”,则单击是。
缺省 portlet 查看页面 UserAdminView.jsp 便显示在工作空间的编辑区域中。
导入此样本中使用的资源
要导入 AuctionPortal.zip(它包含预先构建的所有项目资源,这些是创建此教程中描述的接口和数据访问所必需的):
- 从菜单栏中选择文件 > 导入。将出现“导入”对话框。
- 在选择导入源下面,单击项目交换。
- 单击下一步。将出现导入项目交换内容对话框。
- 因为不同的 Rational 产品使用不同的安装目标位置,所以必须离开产品的用户界面以查找包含数据库内容的插件。使用文件搜索工具在本地文件系统的产品安装路径中查找 com.ibm.etools.portal.examples.application_6.0.0.1 插件文件夹。
- 单击源 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 插件的绝对路径。单击打开。
- 选择 AuctionEJB50 和 AuctionEJB50Client 复选框。
- 单击完成。
该向导将把项目导入到您的工作空间中。
- 还必须将所导入的项目作为模块添加至 AuctionPortletEAR 项目。在“项目资源管理器”中,展开“企业应用程序”>“AuctionPortletEAR”并双击部署描述符:AuctionPortletEAR。
- 选择模块选项卡。
- 单击“模块”下面的添加。选择 AuctionEJB50 并单击完成。如果更改目标服务器对话框要求您将模块目标服务器更改为 EAR 目标服务器,则单击是。
- 单击“项目实用程序 JAR”下面的添加。选择 AuctionEJB50Client 并单击完成。如果更改目标服务器对话框要求您将模块目标服务器更改为 EAR 目标服务器,则单击是。
- 保存并关闭部署描述符。
安装并配置 WebSphere Portal V5.1 测试环境
虽然 WebSphere Portal V5.0 测试环境可从产品启动板安装,但是在此教程中的资源要在
WebSphere Portal 5.1 上运行。必须按产品《安装指南》中所述安装 WebSphere Portal 5.1 测试环境。安装要求您使用随
Rational Developer 提供的 WebSphere Portal 介质。
在安装了这一版本的测试环境之后,还必须配置它以在您的工作空间中运行:
- 从菜单栏中选择窗口 > 首选项。
- 展开服务器部分,然后单击已安装运行时。
- 单击 WebSphere Portal V5.1 存根,选择该复选框并单击编辑。
- 将名称更改为 WebSphere Portal V5.1 并使用您在安装测试环境时指定的 WebSphere Portal 5.1 测试环境安装目录覆盖 WebSphere Portal 位置和 WebSphere Application Server 位置值。
- 单击完成。
- 在“首选项”对话框中单击确定。
完成了上述步骤之后,WebSphere Portal V5.1 测试环境就可用于测试、调试和概要分析了。
接下来,必须配置包含此教程中应用程序要使用的数据的数据库服务器。
创建并配置包含样本应用程序数据库的服务器
在此练习中,必须导入并配置 Cloudscape 数据库以便为 AuctionPortal 应用程序提供数据。
- 显示“服务器”视图。该视图紧靠着“属性”视图和“快速编辑”视图。
- 从该视图的弹出菜单中,选择新建 > 服务器。
- 从服务器类型列表中,选择 WebSphere Portal V5.1 测试环境。
- 单击完成。
- 双击“服务器”视图中的 WebSphere Portal V5.1 测试环境。
- 选择服务器编辑器中的数据源选项卡。
- 在服务器设置部分中,单击添加以将列表添加至 JDBC 提供程序列表。
- 在“创建 JDBC 提供程序”向导的第一个页面中,选择 Cloudscape 作为数据库类型,选择 Cloudscape JDBC 提供程序作为 JDBC 提供程序类型。
- 单击下一步。
- 在名称字段中,输入 Cloudscape JDBC 提供程序。
- 单击完成。
- 单击在上面选择的 JDBC 提供程序中定义的数据源列表旁边的添加按钮。
- 在“创建数据源”向导的第一个页面中,选择 Cloudscape JDBC 提供程序并单击下一步。
- 在名称字段中,输入 Auction。
- 在 JNDI 名称字段中,输入 jdbc/auction。
- 单击下一步。
- 从资源属性列表中,选择数据库名称。
- 因为不同的 Rational 产品使用不同的安装目标位置,所以必须离开产品的用户界面以查找包含数据库内容的插件。使用文件搜索工具在本地文件系统的产品安装路径中查找 com.ibm.etools.auction.sampledb_6.0.0 插件文件夹。
- 返回到“创建数据源”向导,并在值字段中输入以下路径:
x:\com.ibm.etools.auction.sampledb_6.0.0\db\AUCTION60
其中 x: 是计算机上包含 com.ibm.etools.auction.sampledb_6.0.0 插件的绝对路径。
- 单击完成。
- 保存并关闭服务器配置文件。
现在,当您测试 AuctionPortlet 项目中的 portlet 时,由于您在“模块 1”中已经开发了它们,因此将能够访问 AUCTION60 数据库中的数据。
关于在此教程中使用的文件
现在,可以浏览 AuctionEJB50 和 AuctionEJB50Client 项目中的文件,这些文件中包含 portlet 页面的数据源和逻辑。在“项目资源管理器”视图中,当您展开各个文件夹时,其内容应该为如下所示:

此项目中的资源将用来为此教程中将创建的 portlet 创建用户界面,并且提供对样本 Cloudscape 数据库中数据的访问权。UserFacade 和 ListingFacade 是两个 EJB 会话 bean,它们将提供一些方法,被从在此教程中创建的 portlet 调用。RegistrationData 和 ItemData 是两个数据访问 Bean,用于在 portlet 与 Cloudscape 数据库之间通过使用实体 bean 来传送数据。EJB 项目将为实体 bean 提供数据库映射。
现在,您可以开始练习 1.2:准备 portlet 开发和定义应用程序流了。