Sun Java System Application Server Enterprise Edition 8.2 管理指南

第 3 章 JDBC 资源

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

本章包括以下几个部分：

创建 JDBC 资源

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

JDBC 资源（数据源）为应用程序提供了连接数据库的方法。创建 JDBC 资源之前，请先创建 JDBC 连接池。

要创建 JDBC 资源，需要指定标识资源的唯一 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 资源”。指定资源设置，如下所示：

JNDI 名称：指定唯一名称。JNDI 名称在分布式计算环境中组织和查找组件的方式与图书馆中卡片目录组织和表示书籍位置的方式类似。因此，JNDI 名称成为访问 JDBC 资源的一种重要方法。按照约定，该名称应以 jdbc/ 字符串开头。例如：jdbc/payrolldb。请不要忘记正斜杠。
池名称：选择要与新 JDBC 资源关联的连接池。
说明：键入资源的简短说明。
状态：如果要使资源不可用，请取消选中“已启用”复选框。默认情况下，创建资源之后立即可以使用资源（已启用）。

要使用命令行实用程序创建 JDBC 资源，请使用 create-jdbc-resource 命令。

创建 JDBC 连接池

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

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

创建连接池时，您实际上是在定义特定数据库连接的各个方面。创建连接池之前，您必须首先安装并集成 JDBC 驱动程序。连接池的属性可能会随数据库供应商的不同而有所不同。有一些属性是通用的，如数据库名称 (URL)、用户名和密码。

必须输入某些特定于 JDBC 驱动程序和数据库供应商的数据。继续创建之前，请先收集以下信息：

数据库供应商名称
资源类型，如 javax.sql.DataSource（仅本地事务）和 javax.sql.XADataSource（全局事务）
数据源类名：如果 JDBC 驱动程序具有资源类型和数据库的数据源类，则“数据源类名”字段的值是必需的。
必需的属性，如数据库名称 (URL)、用户名和密码

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

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

数据库供应商名称
资源类型，如 javax.sql.DataSource（仅本地事务）和 javax.sql.XADataSource（全局事务）
数据源类名
必需的属性，如数据库名称 (URL)、用户名和密码

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

参数	说明
`数据源类名`	实现 `DataSource` 和/或 `XADataSource` API 的特定于供应商的类名。该类位于 JDBC 驱动程序中。
`资源类型`	选项包括 `javax.sql.DataSource`（仅本地事务）、`javax.sql.XADataSource`（全局事务）和 `java.sql.ConnectionPoolDataSource`（本地事务，性能可能会提高）。

此外，还必须定义一组位于池中的物理数据库连接。应用程序请求连接时，将从池中删除该连接；而应用程序释放该连接之后，连接将返回到池中。

参数	说明
初始和最小池大小	池中连接的最小数目。该值还确定了首次创建池或应用服务器启动时被置于池中的连接的数目。
最大池大小	池中连接的最大数目。
池大小调整数量	当池向最小池大小方向收缩时，将成批调整大小。此值确定批处理中的连接数目。如果将该值设置得过大，会延迟连接回收；如果将该值设置得过小，则会降低效率。
空闲超时	连接在池中保持空闲的最长时间（以秒为单位）。一旦超过此时间，即从池中删除该连接。
最长等待时间	在达到连接超时之前，请求连接的应用程序所等待的时间。由于默认等待时间过长，应用程序可能会出现无限期挂起的情况。

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

参数	说明
连接验证	选中“需要”复选框以启用连接验证。
验证方法	应用服务器可以使用三种方法来验证数据库连接：自动提交、元数据和表。自动提交和元数据－应用服务器通过调用 `con.getAutoCommit()` 和 `con.getMetaData()` 方法来验证连接。但是，由于许多 JDBC 驱动程序高速缓存了这些调用的结果，因此这两种方法无法始终提供可靠的验证。请与驱动程序供应商进行核实，以确定这些调用是否被高速缓存。表－应用程序将查询指定的数据库表。表必须存在并且可以访问，但不要求表的行数。请不要使用包含许多行的现有表或经常访问的表。
表的名称	如果从“验证方法”组合框中选择了表，请在此指定数据库表的名称。
一旦失败	如果选中标有“关闭所有连接”的复选框，则单个连接失败时，应用服务器将关闭池中的所有连接，然后重新建立这些连接。如果未选中此复选框，则仅当要使用各个连接时才会重新建立连接。

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

参数	说明
事务隔离	使您可以为该池的连接选择事务隔离级别。如果不指定此参数，连接将使用 JDBC 驱动程序提供的默认隔离级别进行操作。
保证隔离级别	该项仅在指定了隔离级别的情况下才适用。如果选中“保证”复选框，则从池中获取的所有连接都具有相同的隔离级别。例如，如果上次使用连接时通过编程方式（使用 `con.setTransactionIsolation`）更改了连接的隔离级别，此机制会将状态更改回指定的隔离级别。

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

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

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

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

给定资源的 JNDI 名称、命名和目录服务定位 JDBC 资源。每个 JDBC 资源指定一个连接池。
通过 JDBC 资源，应用程序获得一个数据库连接。

应用服务器秘密地从与该数据库相对应的连接池中检索物理连接。池定义了数据库名称 (URL)、用户名和密码等连接属性。
由于已将应用程序连接到数据库，所以该应用程序可以读取和修改数据库中的数据以及将数据添加到数据库中。

应用程序通过对 JDBC API 进行调用来访问数据库。JDBC 驱动程序将应用程序的 JDBC 调用转换为数据库服务器的协议。
访问数据库完成之后，应用程序将关闭该连接。

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

设置数据库访问

要设置数据库访问，您必须首先安装支持的数据库产品。有关 Application Server 支持的数据库产品列表，请参见发行说明。然后，必须为数据库产品安装 JDBC 驱动程序，并使域的服务器实例能够访问该驱动程序的 JAR 文件。接下来，创建数据库、数据库的连接池以及指向连接池的 JDBC 资源。

安装 JDBC 驱动程序之后，必须对其进行集成，以便该驱动程序可将应用程序的 JDBC 调用转换为数据库服务器的协议。要将 JDBC 驱动程序集成到管理域中，请执行以下操作之一：

使通用类加载器可以访问该驱动程序。
1. 将驱动程序的 JAR 文件和 ZIP 文件复制到 domain-dir/lib 目录或将其类文件复制到 domain-dir/lib/ext 目录。
2. 重新启动该域。
使系统类加载器可以访问驱动程序。
1. 在管理控制台中，针对所需的配置选择 JVM 设置。
2. 标识驱动程序的 JAR 文件的全限定路径名。
3. 保存设置并重新启动服务器。

持久性管理器资源

向后兼容需要此功能。要在 Application Server 7 版上运行，使用容器管理的持久性 Bean（一种 EJB 组件）的应用程序需要持久性管理器资源。建议改为使用 JDBC 资源。

要使用管理控制台创建持久性管理器资源，请选择“资源”节点。“持久性管理器”节点 >“持久性管理器”页面。要使用命令行实用程序，请使用 create-persistence-resource 命令。