使用管理控制台创建连接池时,您是在定义与特定数据库的连接的各个方面。
要创建连接池,必须先安装和集成一个支持 JDBC API 的驱动程序 (JDBC 驱动程序)。请参阅集成 JDBC 驱动程序。
以下信息是创建 JDBC 连接池所必需的。请先收集这些信息,然后再继续:
数据库驱动程序供应商名称
资源类型,如 javax.sql.DataSource
(仅本地事务处理)、java.sql.ConnectionPoolDataSource
(本地事务处理,性能可能会提高)、javax.sql.XADataSource
(全局事务处理) 和 java.sql.Driver
数据源类名
必需的属性,如数据库名称 (URL)、用户名和口令
在导航树中,选择“常见任务”节点。
此时将打开“常见任务”页。
在“常见任务”页上,单击“创建新 JDBC 连接池”按钮。
此时将打开“新建 JDBC 连接池 (第 1 步,共 2 步)”页。
注:
您还可以通过以下方法访问“新建 JDBC 连接池”页:展开“资源”节点和“JDBC”节点,然后选择“连接池”节点。然后,从“连接池”页中,单击“新建”来创建新的连接池。在“池名称”字段中,键入新连接池的名称。
这是必需字段。
从“资源类型”下拉列表中,选择一种资源类型。
选项包括 javax.sql.XADataSource
(全局事务处理)、java.sql.ConnectionPoolDataSource
(本地事务处理,性能可能会提高)、javax.sql.DataSource
(仅本地事务处理) 和 java.sql.Driver
。
指定数据库供应商:
从“数据库驱动程序供应商”下拉列表中,选择数据库供应商。
如果数据库供应商没有出现在列表中,请在“数据库驱动程序供应商”文本字段中键入提供方的名称。
选中“启用自测”复选框可基于数据源或驱动程序实现类名对数据库驱动程序进行自测。
单击“下一步”。
此时将打开“新建 JDBC 连接池 (第 2 步,共 2 步)”页。
在“数据源类名称”字段中,键入实现 DataSource
、ConnectionPoolDataSource
或 XADataSource
API 的特定于提供方的类名称。
如果选择了一种数据源资源类型,则此字段通常会自动填充与您选择的资源类型和数据库供应商关联的类名。如果选择了 java.sql.Driver
资源类型,则此字段将被禁用。
在“驱动程序类名称”字段中,键入实现 java.sql.Driver
API 的特定于提供方的类名称。
如果选择了 java.sql.Driver
资源类型,则通常会使用与您选择的驱动程序和数据库供应商关联的类名自动填充此字段。如果选择了一种数据源资源类型,则此字段将被禁用。
选中“启用试通”复选框,在池创建或重新配置过程中自动对池进行试通操作,以识别任何错误属性值并发出警告。
默认情况下禁用此选项。
在“说明”字段中,键入连接池的简短说明。
在“初始和最小池大小”字段中,键入此池的最小连接数。
该值还确定了首次创建池或 GlassFish Server 启动时,置于池中的连接的数目。默认值为 8。
在“最大池大小”字段中,键入此池的最大连接数。
默认值为 32。
在“池调整大小数量”字段中,键入每个池大小调整批处理中的连接数。
当池根据最大和最小池大小进行相应扩大或缩小时,将以批处理方式调整其大小。此值确定批处理中的连接数目。如果将该值设置得过大,则会延迟连接创建和回收;如果将该值设置得过小,则会降低效率。默认值为 2。
在“空闲超时”字段中,键入连接可在池中保持空闲状态的最长时间 (秒)。
一旦超过此时间,即从池中删除该连接。默认值为 300。
在“最长等待时间”字段中,键入请求连接的应用程序在连接超时之前等待的最长时间 (毫秒)。
默认值为 60,000。
选中“启用非事务处理连接”复选框,以返回非事务处理连接。
默认情况下禁用此选项。
从“事务处理隔离级别”下拉列表中,选择此连接池的事务处理隔离级别。
如果不指定此参数,连接将使用 JDBC 驱动程序提供的默认隔离级别进行操作。默认情况下,未指定此选项。
选中“保证隔离级别”复选框,确保从池中获取的所有连接都具有相同的隔离级别。
例如,如果上次使用连接时通过编程方式 (使用 con.setTransactionIsolation
) 更改了连接的隔离级别,此机制会将状态更改回指定的隔离级别。默认情况下启用此选项。
仅当已指定事务处理隔离级别时,此设置才适用。
在“其他属性”部分中,指定其他属性。
必需属性的示例包括数据库名称 (URL)、用户名和口令。该表通常包含数据库供应商使用的属性。有关某些可用属性的信息,请参阅特定于 JDBC 连接池的属性。
如果您不指定某个属性的值,则在创建完连接池时,该属性将从表中删除。如果您现在不希望设置某个属性的值,但希望将该属性保留在表中以便在以后设置值,请在“值”字段中键入一对空括号:
()
要添加属性,请单击“添加属性”按钮。在显示的空白行中,在“名称”字段中键入属性名称,在“值”字段中键入属性值。
要修改属性,请编辑该属性的“值”字段。
要删除属性,请选中位于您要删除属性的“名称”字段左边的复选框,然后单击“删除属性”按钮。
单击“完成”。