iSereis上使用用于Linux的EJB持久性

　　当您在使用基于组件的企业 Java beans（EJB）体系结构编写一个应用程序时，这个应用程序是可扩展的、可处理事务的而且是多用户安全的。您只需一次编写应用程序，然后就可以将它部署到任何一个支持企业 Java beans 规范的服务器平台上。
　　
　　Java 2 企业版应用程序使用 EJB 实现服务器端事务组件，EJB 包括会话 beans 和实体 beans。会话 beans 描述的是事务服务，不在用户间共享。实体 beans 是描述持久数据的多用户、分布式事务处理对象。
　　
　　开始之前
　　遵循“在 iSeries 上安装 Linux”或“在 pSeries 上安装 Linux”中的步骤在 iSeries 上的一个逻辑分区上安装 SuSE Linux Enterprise Server (SLES) 8。
　　
　　遵循“Installing DB2 for Linux on iSeries and pSeries”中的步骤在 iSeries 上安装并启动用于 Linux 的 DB2。您可以自 Windows 中使用虚拟网络处理（Virtual Network Computing，VNC）客户机 vncviewer 访问 iSeries 上的 Linux。请参阅那篇文章中的说明来使用 vncviewer。
　　
　　遵循“在 iSeries 和 pSeries 上安装用于 WebSphere Application Server V5.0 for Linux”中的步骤安装 WebSphere Application Server V5.0.2。启动 server1，如下：
　　图 1. 启动 server1
　　　
　　用您的浏览器访问 http://SLES8WAS:9090/admn（用您的 iSeries 系统的名字代替这个例子中的 SLES8WAS）来启动 WebSphere 管理控制台。
　　图 2. 启动管理控制台
　　　
　　图 3. WebSphere 管理控制台
　　　
　　创建一个 JDBC 提供者
　　安装的应用程序使用 JDBC（Java Database Connectivity）提供者来访问数据库中的数据。下载 jt400.jar 文件 并将其放入一个名为 /opt/jtopen 的目录中。JTOpen 是用于 Java 的 IBM 工具箱的一个开放源代码版本，它的更新频率比得到许可的程序版本更高。
　　
　　在管理控制台中创建一个 JDBC 提供者：
　　在管理控制台拓扑树中，展开 Resources 然后单击 JDBC Providers。
　　在 JDBC Providers 页，指定 Server 作为资源的范围。单击 Apply。
　　单击 New。
　　在 JDBC Providers 域，选择 DB2 UDB for iSeries (Toolbox) driver。
　　单击 Apply。
　　在 classpath 域，将 ${OS400_TOOLBOX_JDBC_DRIVER_PATH}/jt400.jar
　　改为
　　/opt/jtopen/jt400.jar。
　　单击 Apply 或 OK。
　　单击工具栏上的 Save，保存配置。
　　再次单击 Save，用您的改变去更新主仓库（master repository）。
　　图 4. 创建一个 JDBC 提供者
　　　
　　图 5. 创建一个 JDBC 提供者（续）
　　　
　　创建一个 J2C 认证数据条目
　　Java 2 连接器（J2C）认证数据条目定义了您可以在源适配器和 JDBC 之间共享的认证数据。
　　
　　为创建一个 J2C 认证数据条目，需要做：
　　在管理控制台拓扑树中，展开 Security 然后单击 J2C Authentication Data。
　　单击 New。
　　在 Alias 域中指定 johndoe/linuxauth。
　　在 User Id 域中指定您的 iSeries userid。
　　在 Password 域中指定您的 iSeries 口令。
　　单击 OK 或 Apply。（没有对 user ID 和口令进行确认）
　　单击工具栏上的 Save，保存修改。
　　再次单击 Save，用您的改变去更新主仓库。
　　图 6. 创建一个 J2C 认证数据条目
　　　
　　配置一个数据源
　　创建了一个 JDBC 提供者后，就需要为这个提供者配置一个数据源，以使您的应用可以访问数据库中的数据。JDBC 提供者指定 JDBC 驱动程序实现类。为配置一个数据源，需要做：
　　
　　在管理控制台的 JDBC Providers 页上，单击您想为其配置数据源的 DB2 UDB for iSeries (toolbox) JDBC 提供者。
　　在下一页，单击 Data Sources。
　　在 Data Sources 页，单击 New。
　　在 Name 域中指定 Default Datasource。
　　在 JNDI Name 域中指定 DefaultDatasource。
　　注意：HitCount EJB 示例用 Default Datasource 作为 Data Source Name，用 DefaultDatasource 作为 JNDI Name。
　　
　　单击 Container managed persistence 以在容器管理持久性（container managed persistence，CMP）中使用这个数据源。
　　在　Component-managed Authentication Alias 下的列表中选择 johndoe/linuxauth。
　　在　Component-managed Authentication Alias 下的列表中选择 johndoe/linuxauth。
　　单击 Apply。
　　单击 Custom properties。
　　单击 serverName。
　　在 Value 域中，指定您的 iSeries 机器名。
　　单击 Apply。
　　单击 libraries。
　　在 Value 域中，指定 HITCOUNTDB。
　　单击 Apply。
　　单击工具栏上的 Save，保存配置。
　　再次单击 Save，用您的改变更新主仓库。
　　图 7. 配置一个数据源
　　　
　　图 8. 配置一个数据源（续）
　　　
　　测试数据源参数
　　在定义并保存了 Default Datasource 后，您可以使用 Test Connection 函数来确保数据源定义中的参数是正确的。
　　
　　在管理控制台拓扑树中，展开 Resources 并单击 JDBC Providers。选择 DB2 UDB for iSeries (Toolbox) 和 Default Datasource 然后单击 Test connection。如果您的配置是正确的，将在消息区域显示出如下的成功消息：
　　图 9. 成功的连接
　　　
　　运行 HitCount 示例应用程序
　　HitCount 示例应用程序计算一个页面被访问了多少次。这个应用程序包括一个 Java Servlet、一个 JavaServer Pages（JSP）文件和一个企业 bean。
　　
　　HitCount 示例应用程序被安装为 WebSphere Application Server 例子的一部分，已经在 WebSphere Application Server 的默认实例中运行。它通常用来确认您的应用程序服务器是否已经正确设置。这个附带的示例当前通过 Deafault Datasource 使用 Cloudscape 数据库。在 配置一个数据源 步骤中，我们在 DB2 UDB for iSeries (Toolbox) JDBC Providers 下创建了 Default Datasource。
　　
　　创建 HitCount 需要的数据库表
　　您必须创建 HitCount 示例应用程序所需要的底层数据库表。当使用应用程序装配工具将 bean 打包到 EJB 模块中时，已经为每个实体企业 bean 创建了一个数据定义语言（Data Definition Language，DDL）脚本。这个 DDL 脚本称为 Table.ddl，当它打包到 EJB 模块中后存储在企业 bean 的 JAR 文件中。这个 DDL 脚本中包含了为实体 bean 创建底层数据库表所需要的命令。Table.ddl 如下：
　　
　　Table.ddl
　　
　　CREATE COLLECTION HITCOUNTDB;
　　CREATE TABLE HITCOUNTDB/INCREMENT
　　(PRIMARYKEY VARCHAR(250) NOT NULL, THEVALUE INTEGER NOT NULL);
　　
　　运行 Table.ddl 脚本：
　　启动 iSeries Navigator（导航器）。
　　展开您要创建数据库文件的系统的 iSeries 图标。
　　展开 Database，然后在系统数据库上右击。
　　选择 Run SQL Scripts...。
　　选择 File > Open。
　　将类型视图的 Files 改变为 All Files ("*.*")。
　　导航到 Table.ddl 文件。
　　选择 Run > All 来运行脚本中的所有命令。
　　选择 View -> Job Log...，确认数据库表已经成功创建。
　　选择 File > Save，保存文件。
　　退出 Run SQL Scripts 应用程序。
　　退出 iSereis Navigator。
　　对 HitCount 示例应用程序和数据库表来说，最简单的就是将数据库表授权给所有用户。在 iSeries 服务器命令行中运行下面的命令，为所有用户将权限改变为 *ALL：
　　
　　OBJ(HITCOUNTDB) OBJTYPE(*LIB) USER(*PUBLIC) AUT(*ALL)
　　GRTOBJAUT OBJ(HITCOUNTDB/*ALL) OBJTYPE(*ALL) USER(*PUBLIC) AUT(*ALL)
　　运行 HitCount 示例
　　在您的浏览器中访问 http://SLES8WAS:9080/HitCount.jsp（用您的 iSeries 系统的名字代替
　　
　　这个例子中的 SLES8WAS），如下：
　　图 10. 运行 HitCount 示例 - EJB（CMP）
　　　
　　在 Select a method of execution 下选择 Enterprise Java Bean (CMP)，然后单击 Increment，
　　
　　然后您将看到下面的结果：
　　图 11. 运行 HitCount 示例 - EJB（CMP），续