test

Sun Java System Application Server 9.1 管理指南

第 3 章 JDBC 资源

本章说明如何配置访问数据库的应用程序所需的 JDBC 资源。本章包括以下几个部分：

JDBC 资源

为了存储、组织和检索数据，大多数应用程序都采用了关系数据库。J2EE 应用程序通过 JDBC API 访问关系数据库。

JDBC 资源（数据源）为应用程序提供了连接数据库的方法。通常，管理员要为部署在域中的应用程序访问的每个数据库创建 JDBC 资源。（但是，可以为一个数据库创建多个 JDBC 资源。）

要创建 JDBC 资源，需要指定标识资源的唯一 JNDI 名称。（请参见“JNDI 名称和资源”部分。）JDBC 资源的 JNDI 名称应在 java:comp/env/jdbc 子上下文中。例如，工资单数据库资源的 JNDI 名称可以为 java:comp/env/jdbc/payrolldb。由于所有资源 JNDI 名称都位于 java:comp/env 子上下文中，因此在管理控制台中指定 JDBC 资源的 JNDI 名称时仅需输入 jdbc/name。例如，对于工资单数据库，可以指定 jdbc/payrolldb。

JDBC 连接池

要创建 JDBC 资源，请指定与其关联的连接池。多个 JDBC 资源可以指定一个连接池。

连接池是用于特定数据库的一组可重复使用的连接。由于每创建一个新的物理连接都会耗费时间，因此服务器维护了可用连接池以提高性能。应用程序请求连接时可以从池中获取一个连接。应用程序关闭连接时，连接将返回到池中。

连接池的属性可能会随数据库供应商的不同而有所不同。有一些属性是通用的，如数据库名称 (URL)、用户名和密码。

另请参见：

JDBC 资源和连接池如何协同工作

为了存储、组织和检索数据，大多数应用程序都采用了关系数据库。J2EE 应用程序通过 JDBC API 访问关系数据库。应用程序必须获得一个连接之后才可以访问数据库。

以下是运行时应用程序连接到数据库时所发生的情况：

  1. 应用程序通过 JNDI API 进行调用获取与数据库关联的 JDBC 资源（数据源）。

    给定资源的 JNDI 名称、命名和目录服务定位 JDBC 资源。每个 JDBC 资源指定一个连接池。

  2. 通过 JDBC 资源，应用程序获得一个数据库连接。

    应用程序服务器秘密地从与该数据库相对应的连接池中检索物理连接。池定义了数据库名称 (URL)、用户名和密码等连接属性。

  3. 由于已将应用程序连接到数据库，所以该应用程序可以读取和修改数据库中的数据以及将数据添加到数据库中。

    应用程序通过对 JDBC API 进行调用来访问数据库。JDBC 驱动程序将应用程序的 JDBC 调用转换为数据库服务器的协议。

  4. 访问数据库完成之后，应用程序将关闭该连接。

    应用程序服务器将连接返回连接池。连接返回连接池之后，下一个应用程序就可以使用该连接。

设置数据库访问

设置数据库访问：

  1. 安装支持的数据库产品。

    有关 Application Server 支持的数据库产品列表，请参见发行说明。

  2. 安装适用于该数据库产品的 JDBC 驱动程序。

  3. 使域的服务器实例可以访问此驱动程序的 JAR 文件。

  4. 创建数据库。

    通常，应用程序供应商提供了用于创建和填充数据库的脚本。

  5. 为数据库创建连接池。

  6. 创建指向连接池的 JDBC 资源。

现在，要将 JDBC 驱动程序集成到管理域中，请执行以下操作之一：

  1. 使通用类加载器可以访问该驱动程序。

    将驱动程序的 JAR 和 ZIP 文件复制到 domain-dir/lib 目录或将其类文件复制到 domain-dir/lib/ext 目录中。

  2. 重新启动域。

  3. 标识驱动程序的 JAR 文件的全限定路径名。

关于 JDBC 连接池

连接池是用于特定数据库的一组可重复使用的连接。使用管理控制台创建池时，管理员实际上是在定义到特定数据库的连接的各个方面。

创建池之前，您必须首先安装并集成 JDBC 驱动程序。设置“创建连接池”页面时，必须输入特定于 JDBC 驱动程序和数据库供应商的特定数据。继续创建之前，请先收集以下信息：

编辑 JDBC 连接池

“编辑 JDBC 连接池”页面使您可以更改现有池的所有设置（池的名称除外）。

  1. 更改常规设置。

    常规设置的值取决于安装的特定 JDBC 驱动程序。这些设置是 Java 编程语言中的类名或接口名称。

    参数 

    说明 

    数据源类名称 

    实现 DataSource 和/或 XADataSource API 的特定于供应商的类名。该类位于 JDBC 驱动程序中。

    资源类型 

    选项包括 javax.sql.DataSource（仅本地事务） 、javax.sql.XADataSource（全局事务）和 java.sql.ConnectionPoolDataSource（本地事务，性能可能会提高）。

  2. 更改池设置。

    一组物理数据库连接保存在池中。应用程序请求连接时，将从池中删除该连接；而应用程序释放该连接之后，连接将返回到池中。

    参数 

    说明 

    初始和最小池大小 

    池中连接的最小数目。该值还确定了首次创建池或应用程序服务器启动时被置于池中的连接的数目。 

    最大池大小 

    池中连接的最大数目。 

    池调整大小数量 

    当池分别向最大池大小增加和向最小池大小减小时，将在批处理中调整其大小。此值确定批处理中的连接数目。如果将该值设置得过大，则会延迟连接创建和回收；如果将该值设置得过小，则会降低效率。 

    空闲超时 

    连接在池中保持空闲的最长时间（以秒为单位）。一旦超过此时间，即从池中删除该连接。 

    最长等待时间 

    在达到连接超时之前，请求连接的应用程序所等待的时间。由于默认等待时间过长，应用程序可能会出现无限期挂起的情况。 

  3. 更改连接验证设置。

    （可选）应用程序服务器可以在将连接传送给应用程序之前验证连接。如果由于网络出现故障或数据库服务器崩溃造成数据库不可用，此验证将允许应用程序服务器自动重新建立数据库连接。连接验证会带来额外开销，并会导致性能稍有下降。

    参数 

    说明 

    连接验证 

    选中“需要”复选框以启用连接验证。 

    验证方法 

    应用程序服务器可以使用三种方法来验证数据库连接：自动提交、元数据和表。 

    自动提交和元数据－应用服务器通过调用 con.getAutoCommit() 和 con.getMetaData() 方法来验证连接。

    注 –

    由于许多 JDBC 驱动程序高速缓存了这些调用的结果，因此这两种方法无法始终提供可靠的验证。请与驱动程序供应商进行核实，以确定这些调用是否被高速缓存。

    表－应用程序将查询指定的数据库表。表必须存在并且可以访问，但不要求表的行数。请不要使用包含许多行的现有表或经常访问的表。 

    表名 

    如果从“验证方法”组合框中选择了表，请在此指定数据库表的名称。 

    一旦失败 

    如果选中标有“关闭所有连接”的复选框，则单个连接失败时，应用程序服务器将关闭池中的所有连接，然后重新建立这些连接。如果未选中此复选框，则仅当要使用各个连接时才会重新建立连接。 

    允许非组件调用方 

    如果要启用池以供非组件调用方（如 Servlet 过滤器和生命周期模块）使用，请单击此复选框。 

  4. 更改事务隔离设置。

    由于许多用户通常可以并行访问一个数据库，因此可能出现一个事务在更新数据而另一个事务尝试读取同一数据的情况。事务的隔离级别定义了正在更新的数据对于其他事务的可见程度。有关隔离级别的详细资料，请参见数据库供应商的文档。

    参数 

    说明 

    非事务连接 

    如果希望 Application Server 返回所有非事务连接，请单击此复选框。 

    事务隔离 

    使您可以为该池的连接选择事务隔离级别。如果不指定此参数，连接将使用 JDBC 驱动程序提供的默认隔离级别进行操作。 

    保证隔离级别 

    该项仅在指定了隔离级别的情况下才适用。如果选中“保证”复选框，则从池中获取的所有连接都具有相同的隔离级别。例如，如果上次使用连接时通过编程方式（使用 con.setTransactionIsolation）更改了连接的隔离级别，此机制会将状态更改回指定的隔离级别。

  5. 更改属性。

    在“其他属性”表中，可以指定数据库名称 (URL)、用户名和密码等属性。由于随数据库供应商的不同，属性也会有所不同，因此请参考供应商的文档以了解有关详细信息。

编辑 JDBC 连接池高级属性

为帮助诊断连接泄漏和改进易用性，Application Server 9.1 提供了几个新属性以便在创建连接池时对其进行配置。

  1. 打开“高级”选项卡并指定以下属性。

    属性 

    说明 

    名称 

    要编辑其属性的 JDBC 连接池的名称。但是，您不能更改池名称。 

    语句超时 

    在该时间后将终止运行时间异常长的查询（以秒为单位）。Application Server 将在所创建的语句上设置 "QueryTimeout"。默认值 -1 表示未启用该属性。 

    包装 JDBC 对象 

    设置为 true 时，应用程序将获取 Statement、PreparedStatement、CallableStatement、ResultSet、DatabaseMetaData 的包装 jdbc 对象。默认值为 false。 

  2. 指定下表中所述的连接设置。

    属性 

    说明 

    最多验证一次 

    经过该时间后最多对连接验证一次（以秒为单位）。这将有助于减少连接的验证请求次数。默认值 0 表示未启用连接验证。 

    泄漏超时 

    用于跟踪连接池中连接泄漏的时间量（以秒为单位）。默认值 0 表示禁用了连接泄漏跟踪。如果启用了连接泄漏跟踪，则可以在“监视资源”选项卡中获取有关连接泄漏次数的统计信息。要查看此选项卡，请转到“应用服务器”>“监视”>“资源”。 

    泄漏回收 

    如果启用此选项，则泄漏的连接将在泄漏连接跟踪完成后恢复到池中。 

    创建重试尝试次数 

    在创建新连接的过程中出现故障时将进行的尝试次数。默认值 0 表示将不进行再次创建连接的尝试。 

    重试时间间隔 

    指定创建连接的两次尝试之间的时间间隔（以秒为单位）。默认值为 10 秒。仅当“创建重试尝试次数”的值大于 0 时才使用此属性。 

    延迟连接登记 

    仅当在方法中实际使用某个资源时，才启用此选项将该资源登记到事务。 

    延迟关联 

    对连接执行操作时，延迟关联连接。此外，当事务完成且组件方法结束时，将对它们取消关联，这将有助于物理连接的重复使用。默认值为 false。 

    与线程关联 

    启用此选项可将连接与线程关联，以便该线程需要连接时，它可以重复使用已经与自己关联的连接，因此不会产生从池中获取连接的开销。默认值为 false。 

    匹配连接 

    使用此选项可打开/关闭池的连接匹配。如果管理员知道池中的连接始终都是同构的，因此资源适配器不需要匹配从池中选取的连接，则可以将其设置为 false。默认值为 false。 

    最大连接使用次数 

    指定池应该重复使用连接的次数。连接在重复使用指定的次数后将被关闭。这是很有用的，例如用来避免语句泄漏。默认值 0 表示将不重复使用连接。 

关于 JDBC 资源

JDBC 资源（数据源）为应用程序提供了连接数据库的方法。

创建 JDBC 资源之前，请先创建 JDBC 连接池。

创建 JDBC 资源时，必须指定以下内容：

  1. JNDI 名称。按照约定，该名称应以 jdbc/ 字符串开头。例如：jdbc/payrolldb。请不要忘记正斜杠。

  2. 选择要与新 JDBC 资源关联的连接池。

  3. 指定资源的设置。

  4. 指定具有可用资源的目标（群集和独立服务器实例）。

特定 JDBC 驱动程序的配置

Application Server 9.1 旨在支持连接到任何数据库管理系统（使用对应的 JDBC 驱动程序）。支持以下 JDBC 驱动程序和数据库组合。已经对 Application Server 9.1 测试了这些组合，并且查明这些组合是与 J2EE 兼容的。它们也受 CMP 的支持。

有关当前支持的 JDBC 驱动程序的最新列表，请参见《Sun Java System Application Server 9.1 发行说明》。

其他 JDBC 驱动程序可用于 Application Server 9.1，但是尚未完成这些驱动程序的 J2EE 兼容性测试。虽然 Sun 未提供对这些驱动程序的产品支持，但是 Sun 提供了将这些驱动程序用于 Application Server 9.1 的有限支持。

有关如何集成 JDBC 驱动程序以及如何使用管理控制台或命令行界面实现配置的详细信息，请参见《Sun Java System Application Server 9.1 管理指南》。

注 –

如果运行 capture-schema 命令的 Oracle 数据库用户不拥有该模式，则该用户需要 ANALYZE ANY TABLE 权限。这些权限由数据库管理员授予用户。有关 capture-schema 的信息，请参见《Sun Java System Application Server 9.1 Reference Manual》。

Derby 类型 4 驱动程序

默认情况下 Application Server 附带有 Derby JDBC 驱动程序，但 Solaris 捆绑安装（该安装不包含 Derby）除外。因此，除非具有 Solaris 捆绑安装，否则无需将此 JDBC 驱动程序与 Application Server 集成。

Derby 驱动程序的 JAR 文件是 derbyclient.jar。

使用以下设置配置连接池：

用于 DB2 数据库的 Sun Java System JDBC 驱动程序

此驱动程序的 JAR 文件是 smbase.jar、smdb2.jar 和 smutil.jar。使用以下设置配置连接池：

用于 Oracle 8.1.7 和 9.x 数据库的 Sun Java System JDBC 驱动程序

此驱动程序的 JAR 文件是 smbase.jar、smoracle.jar 和 smutil.jar。使用以下设置配置连接池：

用于 Microsoft SQL Server 数据库的 Sun Java System JDBC 驱动程序

此驱动程序的 JAR 文件是 smbase.jar、smsqlserver.jar 和 smutil.jar。使用以下设置配置连接池：

用于 Sybase 数据库的 Sun Java System JDBC 驱动程序

此驱动程序的 JAR 文件是 smbase.jar、smsybase.jar 和 smutil.jar。使用以下设置配置连接池：

IBM DB2 8.1 类型 2 驱动程序

DB2 驱动程序的 JAR 文件是 db2jcc.jar、db2jcc_license_cu.jar 和 db2java.zip。对环境变量进行如下设置：

LD_LIBRARY_PATH=/usr/db2user/sqllib/lib:${j2ee.home}/lib
DB2DIR=/opt/IBM/db2/V8.1
DB2INSTANCE=db2user
INSTHOME=/usr/db2user
VWSPATH=/usr/db2user/sqllib
THREADS_FLAG=native

使用以下设置配置连接池：

用于 Sybase ASE 12.5 数据库的 JConnect 类型 4 驱动程序

Sybase 驱动程序的 JAR 文件是 jconn2.jar。使用以下设置配置连接池：

MM MySQL 类型 4 驱动程序（非 XA）

MySQL 驱动程序的 JAR 文件是 mysql-connector-java-version-bin-g.jar，例如 mysql-connector-java-3.1.12-bin-g.jar。使用以下设置配置连接池：

MM MySQL 类型 4 驱动程序（仅限 XA）

MySQL 驱动程序的 JAR 文件是 mysql-connector-java-version-bin-g.jar，例如 mysql-connector-java-3.1.12-bin-g.jar。使用以下设置配置连接池：

用于 Oracle 8.1.7 和 9.x 数据库的 Inet Oraxo JDBC 驱动程序

Inet Oracle 驱动程序的 JAR 文件是 Oranxo.jar。使用以下设置配置连接池：

用于 Microsoft SQL Server 数据库的 Inet Merlia JDBC 驱动程序

Microsoft SQL Server 驱动程序的 JAR 文件是 Merlia.jar 。使用以下设置配置连接池：

用于 Sybase 数据库的 Inet Sybelux JDBC 驱动程序

Inet Sybase 驱动程序的 JAR 文件是 Sybelux.jar。使用以下设置配置连接池：

用于 Oracle 8.1.7 和 9.x 数据库的 Oracle 瘦类型 4 驱动程序

Oracle 驱动程序的 JAR 文件是 ojdbc14.jar。使用以下设置配置连接池：

用于 Oracle 8.1.7 和 9.x 数据库的 OCI Oracle 类型 2 驱动程序

OCI Oracle 驱动程序的 JAR 文件是 ojdbc14.jar。请确保可通过 LD_LIBRARY_PATH 使用共享库且设置了 ORACLE_HOME 属性。使用以下设置配置连接池：

IBM Informix 类型 4 驱动程序

使用以下设置配置连接池：

CloudScape 5.1 类型 4 驱动程序

CloudScape 驱动程序的 JAR 文件是 db2j.jar、db2jtools.jar、db2jcview.jar、jh.jar 、db2jcc.jar 和 db2jnet.jar。使用以下设置配置连接池：