DB2 Alphablox: 使用 WebSphere Studio Application Developer 开发 DB2 Alphablox 应用程序

文档选项 未显示需要 JavaScript 的文档选项 样例代码

级别： 初级

Peter Bendel (peter_bendel@de.ibm.com), Intelligent Miner 架构师, IBM

2005 年 2 月 01 日

IBM® DB2® Alphablox® 是 IBM 开发的新产品，使用户可以为关系数据库（如 DB2）、DB2 中的关系型多维数据集（星型模式）或多维数据库（如 IBM DB2 OLAP Server™）开发自定义的、基于 Web 的分析应用程序。在本文中，您将了解如何使用基于 Elipse 的 WebSphere Studio Application Developer 作为开发环境来开发 DB2 Alphablox 分析应用程序。

简介

DB2 Alphablox 是 IBM 开发的新产品，用于为以下对象开发自定义的、基于 Web 的分析应用程序：

• 关系型数据库，如 DB2。
• DB2 中的关系型多维数据集（星型模式）。
• 或多维数据库，如 IBM DB2 OLAP Server。

使用 JSP 技术，开发人员可以利用 DB2 Alphablox 提供来创建 Blox® 组件的自定义 JSP 标记库来创建 JSP 文件。

可以使用自己选择的工具，甚至使用简单的文本编辑器（如 Notepad）来创建 JSP 文件，但使用功能齐全的集成开发环境（如 WebSphere Studio Application Developer）将更加有效。

• 采用集成的 WebSphere Studio Application Developer 测试环境。
• 使用 WebSphere Studio Application Developer Data 透视图创建关系型 SELECT 语句。
• 使用 WebSphere Studio Application Developer JSP 支持获得 Alphablox 自定义标记库的语法帮助（参见图 1）。
• 使用 WebSphere Studio Application Developer CSS 设计器对基于 DB2 Alphablox CSS 的样式表进行图形化更改。

当 Rational Application Developer (RAD) 可用时，您应该能够应用此处的概念来配置 RAD。RAD 将替代 WebSphere Studio Application Developer 产品，我们将在以后的文章中对其进行讨论。

回页首

WebSphere Studio Application Developer 测试环境的优点

以下是使用 WebSphere Studio Application Developer 测试环境的优点：

• 用于 WebSphere Application Server 及运行在其下的应用程序 Java 类的自包含开发和测试环境。
• JSP 标记和 Java 代码完成。
• 实时调试和代码实现。
• 支持多个同时运行的 WebSphere 服务器版本和实例。
• 提供对分析功能的访问。
• 提供 Universal Test Client，在此可以测试企业 bean 和 Java 类。
• 支持与多个开发客户机共享服务器。

对于 DB2 Alphablox 应用程序的开发人员而言，主要的优点是，当不能立即看到更改的效果时，为 DB2 Alphablox 标记定义多个属性会很麻烦。使用 WebSphere Studio Application Developer 测试环境，您可以在同一开发环境中执行热代码替换、同时查看 JSP 源码和浏览器视图，并且在保存 JSP 页时只需单击鼠标便可刷新浏览器视图。

回页首

本文中用到的软件

本文假定您计划使用 DB2 Alphablox 来开发和部署运行于 WebSphere Application Server JSP 和 Servlet 容器中并从 DB2 UDB 或 DB2 OLAP Server 中检索信息的分析应用程序。

在本文所用的例子中，用到了以下软件：

• DB2 Universal Database (UDB) V8.2
• WebSphere Application Server (WAS) 5.1 或更高版本
• DB2 Alphablox 5.6
• WebSphere Studio Application Developer (WebSphere Studio Application Developer) 5.1.2

安装 WebSphere Studio Application Developer 之前，需要在同一计算机中先安装在 WebSphere Application Server 上运行的 DB2 Alphablox。（有关将 DB2 Alphablox 与 WebSphere 一同使用时所需的 DB2 Alphablox 安装和安装后步骤，请参阅 DB2 Alphablox Installation Guide）。

注意：运行于 WebSphere 之上的 DB2 Alphablox 允许您执行管理 任务，如创建新的 DB2 Alphablox 应用程序和数据源。

本文指导您如何将 WebSphere Studio Application Developer 配置为用于 DB2 Alphablox 应用程序的集成开发和测试环境。

以下符号用来表示 DB2 Universal Database、WebSphere Application Server 和 DB2 Alphablox 的安装目录：

• <DB2_DRIVER_PATH>, typically C:\Program Files\IBM\SQLLIB\java
• <WAS_HOME>, typically C:\Program Files\WebSphere\AppServer
• <AAS_HOME>, e.g. C:\alphablox\analytics

回页首

新建 DB2 Alphablox 应用程序

启动 WebSphere Application Server 并使用浏览器登录到 DB2 Alphablox 主页 （通常为 http://localhost:9080/AlphabloxAdmin/home）。

如果在 WebSphere Application Server 上安装 DB2 Alphablox，则将在 <AAS_HOME>\installableApps 目录中创建 Enterprise Application Repository (EAR) 文件。

可以使用此 EAR 文件作为在 WebSphere Studio Application Developer 下开发 DB2 Alphablox 应用程序的起点。

回页首

为 DB2 UDB 数据库定义 DB2 Alphablox 数据源

转到 DB2 Alphablox Admin 页中的 Data Sources 选项卡，并创建新数据源，如下图所示。

在本文中，您将使用 DB2 示例数据库。

保存数据源定义后，使用 Test Selected Database 按钮测试 DB2 JDBC 驱动程序的配置。如果成功，将会看到类似下面的信息性对话框：

如果愿意，现在可以从 DB2 Alphablox 中退出并关闭 WebSphere Application Server，以将系统资源保存到计算机中。

回页首

利用 DB2 Alphablox 配置 WebSphere Studio Application Developer 测试环境

在本节中，您将创建 WebSphere Studio Application Developer 测试环境的新实例。这是一个嵌入式 WAS 版本， 它是从 WebSphere Studio Application Developer 内部配置和启动的。您将对其进行配置以运行 DB2 Alphablox 和您将要创建的 DB2 Alphablox 应用程序。

请在开发和调试过程中使用该 WebSphere Application Server 实例。下面的步骤与前面利用 DB2 Alphablox 配置 WebSphere 服务器实例的步骤相似，例如：

• 设置端口号。
• 设置服务器类路径。
• 导入 AlphabloxPlatform EAR 文件。

启动 WebSphere Studio Application Developer。熟悉视图、透视图以及在 IDE 内导航的概念。

创建新的服务器项目，然后创建新的 服务器和服务器配置。

从服务器类型列表中，选择 WebSphere version 5.1 -> Test Environment，然后 按 Next。

在下一页上，指定与 WAS 安装不同的端口（例如，9081），然后按 Finish。

在 Server configuration 视图中，双击新服务器 (AlphabloxServer) 以 打开服务器配置编辑器（打开 .wsi 文件）。

转到右上方框架底部的 Environment 选项卡，将 DB2 Alphablox 文件和 DB2 JDBC JAR 文件添加到 WebSphere Studio Application Developer 测试环境服务器 实例的类路径中。

DB2 Alphablox JAR 文件位于 <AASHOME>\lib 目录中，而 DB2 JDBC JAR 文件位于 <DB2_DRIVER_PATH> 中。

保存服务器配置。可以通过按下 Ctrl-S 或 File -> Save 执行此操作。 保存配置后，服务器配置编辑器的标题栏中的星号 (*) 将消失。

DB2 OLAP Server 数据源的其他步骤

DB2 Alphablox 安装包含几个不同版本的 Essbase 客户机库。需要使您要访问的 DB2 OLAP Server 或 Hyperion Essbase 版本与 DB2 Alphablox 所用的 Essbase 客户机库相匹配。 在 Windows 中，这些库位于 <AAS_HOME>\bin\nt\<essbase_version> 下。 在可以成功访问 DB2 OLAP Server 或 Essbase 数据源之前，必须进行以下修改， 具体取决于开发计算机上是否已存在任何 DB2 OLAP Server（或 Essbase）产品。

计算机上存在 DB2 OLAP Server 产品

如果具有任何 DB2 OLAP Server 产品（例如，DB2 OLAP Server、DB2 Administrative Services 或 Excel 插件），那么您需要安装与当前安装的其他 Essbase 库版本相对应的 Essbase 客户机运行时 库（可进行独立安装）。如果已经安装了 Essbase 运行时库， 您将有一个包含 DLL 文件的 Hyperion/Api/Redist 目录，其中包括 essgapin.dll 文件。安装 Essbase 客户机储库后，必须使用以下语句预先设置 PATH 环境变量：
%ARBORPATH%; %ARBORPATH%\Api\Redist; <AAS_HOME>\bin\nt\<essbase_version>;
其中，<essbase_version> 是计算机中安装的 Essbase 库的版本（例如， 为 Essbase v6.5 或 DB2 OLAP Server v8.1 选择 65，为 Essbase v7.0 选择 70，为 Essbase v7.1 或 DB2 OLAP Server v8.2 选择 71）。

计算机中不存在 DB2 OLAP Server 产品

如果您的开发计算机中没有 DB2 OLAP Server 或 Hyperion Essbase 产品， 那么您必须创建 ARBORPATH 环境变量，并修改 PATH 环境变量。

创建 ARBORPATH 环境变量，并将其值设置如下：

<AAS_HOME>\bin\nt\<essbase_version>

其中，<essbase_version> 是 Essbase 版本（例如，为 v6.5 选择 65，为 v7.0 选 择 70，为 v7.1 选择 71）。

接下来，将以下参数预先设置为现有值，以编辑 PATH 环境变量：

%ARBORPATH%; %ARBORPATH%\Redist;

在根据需要进行上述更改后，需要重新启动 WebSphere Studio Application Developer，以 使更改生效。

回页首

导入 AlphabloxPlatform EAR 文件

要运行 DB2 Alphablox 应用程序，需要将 AlphabloxPlatform EAR 文件 部署到测试环境服务器实例中。

不能像进行 WAS 安装那样，您无法使用 WebSphere Administrative Console 将 EAR 文件部署到 WebSphere Studio Application Developer 测试环境中。 相反，必须将 EAR 文件导入到 WebSphere Studio Application Developer 工作空间中。

选择 File -> Import，打开 Import 向导。

AlphabloxPlatform.ear 文件位于 <AAS_HOME>\installableApps 目录中。

在 Import 向导的下一页上，选择 Optimized 然后按 Finish。

回页首

将 AlphabloxPlatform EAR 项目添加到服务器配置中

要将 EAR 文件从 WebSphere Studio Application Developer 工作空间部署到 WebSphere Studio Application Developer 测试环境 服务器，请右击 Server configuration 视图中的服务器列表，然后从弹出菜单中选择 Add and remove projects。

在向导中，选择 AlphabloxPlatform 并按 Finish。

可以忽略以下错误消息：
IWAE0017E The module AlphabloxAdmin has a wrong default extension
该消息可能出现在 WebSphere Studio Application Developer 任务列表中（请参阅下面的 常见问题 一节）。

回页首

测试服务器配置

现在可以启动服务器，并检查 DB2 Alphablox 平台是否可以 成功启动了。

在 Server Configuration 视图中，右击服务器并按 Start。 将 Console 视图最大化，并查看服务器的启动情况。

控制台应该类似于以下屏幕快照，应该不包含任何错误，并至少显示这些行：
Server <servername> open for e-business
和
DB2 Alphablox (AlphabloxServer) started

如果一切工作正常，请再次停止服务器。现在可以准备开发应用程序了。

回页首

导入应用程序 EAR 文件

到目前为止，您只是在 WebSphere 实例上安装了 DB2 Alphablox 框架。

现在您已做好准备，可以在框架上开发自己的 Web 应用程序了。 作为自己的 Web 应用程序的起点，您将把 DB2 Alphablox 应用程序（在前面“新建 DB2 Alphablox 应用程序”一节中创建的） EAR 文件导入到开发环境，即 WebSphere Studio Application Developer 工作空间中。

选择 File -> Import，打开 Import 向导。

从 <AAS_HOME>\installableApps 目录中选择应用程序 EAR 文件（例如 MyApps.ear）。

既然您想要开发该应用程序，此时请在 EAR Import 向导中选择 Expanded, extract project contents for development。

按 Finish。

这一步在工作空间中创建两个新项目，一个企业应用程序项目 (EAR) 和一个 Web 应用程序项目 (WAR)。使用 Web 应用程序项目来添加 HTML 和 JSP 页。所有的静态内容（包括 HTML 页、图像和 JSP 文件） 都应该在 Web 应用程序项目的 WebContent 文件夹下面创建。

回页首

开始开发应用程序

带有 GridBlox 的第一个分析视图

要验证安装并熟悉开发环境，您可以创建一个 GridBlox 来从 DB2 示例数据库中提供数据。 GridBlox 是一个表形网格，可以以行-列的格式显示关系型或多维数据，类似于电子表格。

切换到 Web 透视图，在 Web 项目中选择 WebContent 文件夹，并 在 WebSphere Studio Application Developer 工具栏中按 New JSP 图标（或使用 File -> New -> JSP File）：

在 New JSP File 向导中，指定文件名（例如 MyGridBlox.jsp），选中 Advanced 复选框，然后按 Next。

在标记库页中，按 Add 并根据需要选择 DB2 Alphablox 标记库。 在本例中，您只需要 Blox 标记库（在 blox.tld 中指定）。

按 OK，再按 Finish，关闭向导。

新的 JSP 文件将在 JSP 编辑器中打开，您便可以添加 DB2 Alphablox 标记。

以下清单展示了一个 GridBlox，它显示来自 DB2 示例数据库中 EMPLOYEE 表的行：

				
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML>
<HEAD>
<%@ taglib uri="bloxtld" prefix="blox" %>
<%@ page 
language="java"
contentType="text/html; charset=ISO-8859-1"
pageEncoding="ISO-8859-1"
%>
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<META name="GENERATOR" content="IBM WebSphere Studio">
<TITLE>GridBlox.jsp</TITLE>
<blox:header></blox:header>
</HEAD>
<BODY>
<P>All employees' salary</P>
<blox:grid id="MyGrid">
	<blox:data dataSourceName="SAMPLE" 
		query="SELECT LASTNAME,SALARY FROM EMPLOYEE"></blox:data>
</blox:grid>
</BODY>
</HTML></html>

不是使用复制-粘贴在环境中创建这个例子，而是手工键入 Alphablox 自定义标记，以熟悉 WebSphere Studio Application Developer JSP 编辑器关于 DB2 Alphablox 自定义标记的语法帮助。

不要忘了在 <HEAD> 部分中添加 <blox:header/> 标记。

要添加新标记，请输入 <blox: 并按 Crtl-Space。

当 JSP 设计器列出可用标记时，请选择 grid 选项。

将光标定位在单词 grid 后，添加一个空格，然后再按 Crtl-Space。 出现可用标记属性列表时，选择 id 然后为 Blox 组件指定惟一的名称。

完成源代码，如以上清单所示。

带有 ReportBlox 的第一个分析视图

如果您用过 ReportBlox（关系报表）组件，那么您可以使用以下示例， 而无需从头开始。

打开 Web 透视图，在 Navigator 视图 中，在 Web 应用程序项目的 WebContent 文件夹下创建一些 JSP 和 HTML 文件。

在本文的“下载”部分，您将看到 sources.zip 文件。 它包括三个示例文件可以帮助您入门。您可以将这些示例文件导入到应用程序的 WebContent 文件夹中：

• index.html
• Simple.jsp
• Error.jsp

回页首

测试应用程序

下一步是启动配置的 WebSphere Studio Application Developer 测试环境服务器实例，然后运行您的 JSP 文件。

在 Navigator 视图中右击 index.html 文件，并选择 Run on server。 在 Server selection 对话框中，选择您已经为 DB2 Alphablox 配置的现有服务器。

下面的屏幕快照展示了运行于 WebSphere Studio Application Developer 测试环境的 index.html 页， 该页显示于 WebSphere Studio Application Developer 的内部浏览器中。

当单击 simple report using DB2 SAMPLE database 时，将出现以下视图。

DB2 Alphablox 运行时期望在部署的 EAR 文件目录中找到 Web 部署描述符 (web.xml)。

部署到 WebSphere Studio Application Developer 测试环境时，该文件将不会如期望那样被 DB2 Alphablox 复制到 EAR 目录。

这可能导致以下运行时错误：

Error 500: 11/9/04 9:57:57 AM [ERROR -10201] Server_MyPresentBlox: The blox 
MyPresentBlox encountered internal error: 
com.alphablox.server.adapter.WASAdapterException: 
java.io.FileNotFoundException: c:\WebSphere Studio Application Developer_Alphablox_Workspace\MyApp\MyApp\WEB-
INF\web.xml (The system cannot find the file specified)

您可以解决这个问题，方法是手工将 Web 部署描述符 (web.xml) 从 Web 项目的 WEB-INF 文件夹复制到错误消息中给定的位置。

如果您得到不同的错误页，请查看 WebSphere Studio Application Developer 服务器控制台视图了解错误消息。

回页首

热代码替换

要修改应用程序，您可以切换到 JSP 编辑器视图 进行更改，再切换回 浏览器视图，然后按 Refresh 按钮。您应该可以立即 看到修改的结果。

回页首

常见问题

导入 DB2 AlphabloxPlatform EAR 文件时出现的错误

当导入包括 AlphabloxServer 和 AlphabloxAdmin 模块的 AlphabloxPlatform EAR 文件时，Task 视图中可能会 出现以下错误消息：

可以忽略这些错误。

为 JSP 文件显示的找不到类错误

如果出现如下屏幕中显示的 JspTranslate 错误：

则需要将 DB2 Alphablox JAR 文件添加到 Web 项目的编译类路径。

右击 Web 项目的根文件夹并从弹出菜单中选择 Properties。

打开 Java Build Path 属性，按 Add External JARs，然后从 <AASHOME>\lib 目录中选择 aasserver.jar（如果使用 ReportBlox 组件，则还要选择 aasreporting.jar）。

按 OK 两次。

重新编译 Web 项目时，编译错误应该消失。

运行应用程序时找不到 web.xml

DB2 Alphablox 运行时期望在部署的 EAR 文件目录中找到 Web 部署描述符 (web.xml)。

部署到 WebSphere Studio Application Developer 测试环境时，该文件并未如期望那样被 DB2 Alphablox 复制到 EAR 目录中。

这可能导致以下运行时错误：

Error 500: 11/9/04 9:57:57 AM [ERROR -10201] Server_MyPresentBlox: The blox 
MyPresentBlox encountered internal error: 
com.alphablox.server.adapter.WASAdapterException: 
java.io.FileNotFoundException: c:\WebSphere Studio Application Developer_Alphablox_Workspace\MyApp\MyApp\WEB-
INF\web.xml (The system cannot find the file specified)

您可以解决此问题，方法是手工将 Web 部署描述符 (web.xml) 从 Web 项目的 WEB-INF 文件夹复制到错误消息中给定的位置。

发布失败

尝试 发布 或启动服务器时，您收到：

在 Server configuration 视图 中单击您的服务器，然后在下面显示的 Warning 对话框 中选择 Yes。

保存修改的服务器配置，并关闭服务器配置编辑器。

注意：如果您修改了多个应用程序，该错误可能会出现多次。

在 Blox 属性中的更改未反应到应用程序中

与多数 JSP 标记一样，Blox 标记仅被处理一次，即在第一次遇到时。 此时，程序将其作为 Java bean 处理。该标记被实例化，然后使用 bloxName 属性的值（如果程序依赖于该标记）或 id 属性值 存储在 Session 对象中。 如果您使用除 Blox 标记之外的方法创建程序，那么切勿将 Blox 的范围设置为会话之外的任何东西。 如果您希望每次重载页面时都重新执行查询，可以通过 scriptlet 实现。另外，可以使用：
<% session.removeAttribute( "<bloxName>" ); %>, 但是只要会话存在，该方法便存在内存泄漏的负面影响 （新的 Blox 将继续被创建，而不会被销毁）。

下面的 DB2 Alphablox 技术说明可能让新开发人员感兴趣：

• 10 things every DB2 Alphablox developer should know
• Dynamic DB2 Alphablox query execution both with and without page refreshes

回页首

DB2 Alphablox 样式表

可以使用 WebSphere Studio Application Developer 的 CSS 设计器对应用于 BLOX 组件的 样式表进行图形化更改。

DB2 Alphablox Relational Reporting 随附了一些位于 <AAS_HOME>\ system\AlphabloxPlatform\AlphabloxServer\report 目录中的默认样式表。

要在您的报表中使用这些样式表，请使用以下语法：

<HEAD>
<link rel="stylesheet" href="/AlphabloxServer/report/coleman.css" />

要修改这些样式表，建议您在 Web 应用程序中创建样式表的本地副本。 这确保您升级 DB2 Alphablox 时，应用程序的样式不会改变。

在 Web 应用程序的 WebContent 文件夹下创建“styles”文件夹，并将要在应用程序中使用的 .css 文件导入该文件夹中。

现在您可以打开 CSS 设计器来修改样式表。

要使用修改的样式表而不是 DB2 Alphablox 随附的标准样式表，请修改您的 JSP 文件以使其指向自定义的样式表，例如：

<HEAD>
<link rel="stylesheet" href="styles/coleman.css" />

回页首

使用 Data 透视图查询编译器

DB2 Alphablox ReportBlox 组件要求您以 sqlData 标记提供 SQL 查询：

<bloxreport:report id="basic">
	<bloxreport:sqlData 
		query="select * from employee" >
		<bloxreport:dataSourceConnection 
			dataSourceName="SAMPLE" />
	</bloxreport:sqlData>
</bloxreport:report>

可以使用 WebSphere Studio Application Developer Data 透视图交互构建 SQL 查询字符串：

打开 Data perspective。创建新的 Simple Project。 在 DB Servers视图中右击，并选择 Create a new connection。

现在您可以浏览数据库并从 DB Servers 视图展示示例内容了。

要创建新的 SQL 语句，必须先将 DB 模式导入到简单项目中：

现在可以创建新的 SQL 语句了。

可以从 Eclipse 工作台中测试和精炼 SQL 语句，直到满足需要，然后将 SQL 语句文本剪切 并粘贴到报表 JSP 文件中。

回页首

部署应用程序

注意：在部署应用程序之前，请记得从 JSP 文件中删除下面这一行：
<% session.removeAttribute("simple"); %>

在产品 WebSphere 服务器上部署应用程序：

将完成的应用程序导出为 EAR 文件。

注意： DB2 Alphablox 必须安装在 WebSphere Application Server 上（通过按照 DB2 Alphablox Installation Guide 的 “Post-installation steps for WebSphere”一节中的说明部署 Alphablox EAR 文件）。

按照 WebSphere Application Server 文档中的记录，使用 WebSphere Administrative Console 部署 EAR 文件。

回页首

下载

	关于下载方法的信息

参考资料

• 您可以参阅本文在 developerWorks 全球站点上的 英文原文 。
  
  
• DB2 Alphablox 主页
  
  
• 10 things every DB2 Alphablox developer should know
  
  
• Dynamic DB2 Alphablox query execution both with and without page refreshes
  

关于作者

		在过去 10 年多的时间里，Peter 在 IBM Software Group 的不同项目中担任开发职位，其中包括信息检索、工作流软件、普适计算（pervasive computing ）和门户解决方案。他在 IBM 数据管理产品和面向对象程序设计方面具有丰富经验。他现在在德国 Böblingen 的 IBM 软件实验室工作。 现在，Peter 是 IBM 的数据挖掘家族 Intelligent Miner™ 方面的架构师。 他致力于简化将挖掘技术集成到业务应用程序和自定义分析应用程序（如使用 IBM DB2 Alphablox 开发的应用程序）中。

对本文的评价

太差！ (1) 需提高 (2) 一般；尚可 (3) 好文章 (4) 真棒！(5) 建议？

回页首