Naga Ayachitula (Arun), 资深软件工程师, IBM Corporation
Andrew Bradfield, 高级软件工程师, IBM Corporation
JoAnn Brereton, 资深软件工程师, IBM Corporation

2004 年 11 月

本文是有关如何使用 IBM DB2 Records Manager 进行编程的介绍性文章。在本文中，我们将进行一个登录到 Records Manager 引擎的简单练习。为了实现本文的目的，假设读者已经安装了 Records Manager 引擎和数据库，并且可以正常运行。

简介
IBM® DB2® Records Manager (IRM) 是一种能为用户的业务应用软件提供生命周期管理的 e-Records（电子记录）技术。它已经通过了美国国防部对电子记录管理的 5015.2 标准认证。DB2 Records Manager 非常独特，因为它是通过一个引擎而不是应用程序来实现生命周期管理的。DB2 Records Manager 用于集成业务应用程序软件。IRM 具有独一无二的、专门为嵌入式解决方案优化的引擎设计。IRM 被认为是一种轻型的解决方案，因为引擎的主要作用仅仅是提供生命周期管理保持。各个组织只要使用一个 DB2 Records Manager 系统即可支持多个业务线（line-of-business）应用程序。由于 DB2 Records Manager 是作为一种引擎技术推出的，所以合作伙伴可以保持对集成的全面控制。合作伙伴可以自己决定与应用程序集成程度的高低以及集成的方式。IBM DB2 Records Manager 经过重新设计的基础结构可以提供跨平台支持和可伸缩性。该引擎支持 Java™ Internet Inter-ORB 协议 (IIOP)、Remote Method Invocation (RMI)、简单对象访问协议 (SOAP) 和 Web Services。IBM DB2 Records Manager 使用标准化的 Java2 Enterprise Edition 设计模式。

使用 IBM DB2 Records Manager 编程
如上所述，Records Manager 是一套将包含在业务应用程序中的业务对象。在 Records Manager 中，程序员可以用来处理电子记录的组件是 Enterprise Java Beans 2.0 (EJB 2.0)。程序员可以使用 Java 中的 J2EE™ 开发工具编写 Records Managers 应用程序，也可以使用 SOAP 和/或 WSDL 1.1 进行通信。除 EJB 外观之外，RM 还提供了一个 HostInterface 类，该类可使单独编写的 Web 应用程序利用 Records Manager 引擎。但是，为了简单起见，以及为了提供一个“Hello World”风格的概述，我们将演示如何通过一个简单的 J2EE 应用程序访问 Records Manager。

接口概述
DB2 Records Manager 的主 API 包括一个可以代表 14 种接口的外观设计模式。这些接口可以在 com.ibm.gre.engine.ejb.facade 软件包中找到。每种接口代表 Records Manager 某一特定类的功能。程序员首先可以使用 LoginManagerEJB 获取 ClientControllerEJB。ClientControllerEJB 提供了访问其余 13 种 EJB（即 BatchControllerEJB、ComponentDesignControllerEJB、DefinitionControllerEJB、FilePlanComponentControllerEJB、FilePlanDesignControllerEJB、LifeCycleDesignControllerEJB、LoginManagerEJB、QueryControllerEJB、RecordsOperationsControllerEJB、TemplatesControllerEJB、ToolsControllerEJB 和 UserControllerEJB）的方法。该 API 的完整文档可在 IBM DB2 Records Manager API Reference 中找到，引擎本身的进一步说明可在 DB2 Records Manager Programming Guide 中找到。我们主要讨论 LoginManagerEJB 和 ClientControllerEJB。Records Manager 还包含许多实用工具，用于分析和缓存各种 RM 结构。在该软件包中，还可以找到两个特别有用的类，即 ServiceLocator 和 XMLUtil。ServiceLocator 是一个单独（singleton）类，用于缓存 JNDI。XMLUtil 用于分析从各种外观类返回的 XML 数据。

图 . Records Manager 会话外观组件

所需工具
由于您要建立独立的 J2EE 应用程序，因此必须拥有 J2EE 应用程序客户机。如果您喜欢在集成开发环境之外进行编程，IBM 还提供了一个独立的 Websphere Application Client 5.0。在本演示中，我们将要使用 IBM 独立 Websphere Application Client 以及 Ant 文件来建立和测试应用程序。

您还需要 IBM DB2 Records Manager API，它包含在 IRMAPI.jar 中。该文件通常位于 IBM DB2 Records Manager 的安装目录中。如果您正从某一独立系统编写该解决方案，需要将 IRMAPI.jar 复制到您的开发系统中。

问题定义
我们要编写的应用程序将完成三件事。首先，它将与某一特定的 Records Manager 服务器建立联系。然后它会使用 Records Manager Server Enterprise Java Beans 列出可用的 RM 数据库。最后，它将连接到这些数据库之一。

解决方案
本文以 zip 文件的形式打包提供了完整的解决方案。

该解决方案包含以下组成部分：

1. HelloIRM.java 类文件，该文件的静态主函数将完成与 IBM DB2 Records Manager 的握手并登录到 IBM DB2 Records Manager。

2. application.xml 和 application-client.xml 文件，这两个文件提供到 J2EE 应用程序客户机接口的关联。

3. manifest 文件，用于将 IBM DB2 Records Manager 工具包 IRMAPI.jar 添加到应用程序，并将 HelloIRM 命名为主函数的提供程序。

4. build.xml Ant 文件，用于编译和运行演示。

我们先来学习该解决方案（HelloIRM.java 文件）的主要部分。HelloIRM.java 通过进行以下操作来完成与 IBM DB2 Records Manager 的连接。

1. 首先，HelloIRM.java 连接到 JNDI 服务器。

2. 然后联系 JNDI 服务器，以提供 LoginManager 工厂。

3. LoginManager 工厂 (LoginManagerHome) 又用于创建 LoginManager。

4.(a) Login Manager 用于列出 IBM DB2 Records Manager 的可用数据源。

4.(b) 最后，我们使用 Login Manager 登录到想要使用的数据源。

程序清单

第 1 步
第 1 步通过使用 Records Manager 自己的 ServiceLocator 单独类来完成，该类可以在 com.ibm.gre.engine.util 软件包中找到。将使用静态函数 ServiceLocator.createInstance(String, String) 实例化 ServiceLocator，如下所示：

对于该项目的其余部分，我们假设已经安装了 IBM DB2 Records Manager，并分配了常用端口 2809，该端口通常用于 CORBA 命名服务 (corbaloc)。

第 2 步
在第 2 步中，以下代码用于按照名称在 IRM Server 上定位 Login Manager 工厂 (LoginManagerHome)。

第 3 步
在第 3 步中，LoginManager 工厂 (LoginManagerEJBHome) 用于创建实际的 LoginManagerEJB。

LoginManager 和 LoginManagerHome 均可在 com.ibm.gre.engine.ejb.facade 软件包中找到。

第 4 步
步骤 4(a) 和 4(b) 是基本步骤。我们首先使用 LoginManager 列出该 IBM DB2 Records Manager 服务器上可用的数据源。然后尝试使用 LoginManager 的 integrationLogin 方法登录到某一特定的数据源。

请注意 XMLUtil 类的使用。XMLUtil 是由 IBM DB2 Records Manager API 提供的类，是 com.ibm.gre.engine.util 软件包的一部分。该类对于分析从 LoginManagerEJB 和 IRM API 的其他 EJB 外观类返回的消息非常有用。获取数据源以后，可以使用最常用的数据源或客户机命令行上提供的数据源、使用 LoginManagerEJB.login 函数进行连接。这将返回 ClientControllerEJB，可以用于探索 IBM DB2 Records Manager 领域的其余部分。

最后，我们将展示一些基本的 J2EE 记帐。由于应用程序客户机以 EAR 文件的形式打包，因此 application.xml 文件必须包含指向将要创建的单个应用程序 JAR 文件的基本信息。

application.xml

同样，application-client.xml 文件也相当简单。

application-client.xml

运行示例程序
最后，需要提供 IRMAPI.jar 作为 EAR 文件的一部分。为方便起见，可以将它放在已打包的 EAR 文件中的根目录中。还需要提供主函数的父类的名称才能运行应用程序客户机。完整的 MANIFEST.MF 文件如下所示：

Manifest.mf

所提供的 build.xml Ant 文件需要对最上面的几项进行一些修改，才能运行应用程序客户机。您必须提供自己的 WebSphere Application Client 位置，以及已经安装且正在运行的 IBM DB2 Records Manager 引擎的名称、端口和数据源。所有这些属性均可在 build.xml Ant 文件的顶部找到。Ant 本身就是开放源代码的软件，可从以下网址下载： http://ant.apache.org。

一旦您将上述属性更改为与自己的环境相匹配，即可通过在 HelloIRM 应用程序的顶级目录中发布不带参数的“ant”命令，对应用程序进行编译。

要运行应用程序，请发布“ant run”命令。结果应该如下所示：

输出

结束语
IBM DB2 Records Manager API 向程序员提供了多种用于访问 Records Manager 的丰富功能的方法。尤其是，使用 IBM DB2 Records Manager EJB 接口的外观设计非常简单。有了包含客户机的 J2EE、各种实用程序功能和 IRM API 的外观软件包，程序员就可以迅速开始探索 IBM DB2 Records Manager 领域了。

IBM、DB2 和 WebSphere 是 IBM 公司在美国和/或其他国家的商标。

Java 和所有基于 Java 的商标均为 Sun Microsystems, Inc. 在美国和/或其他国家的商标。

其他公司名称、产品和服务的名称可能是其他公司的商标或服务标志。

© 版权所有 IBM 公司 2004。

保留所有权利。