DBCPConnectionPool - ACAL Lynxus 组件文档

DBCPConnectionPool Controller Service

类型全限定名：cn.org.acal.lynxus.dbcp.DBCPConnectionPool

所属 Bundle：cn.org.acal.lynxus:lynxus-dbcp-service-nar:2.11.8

描述

提供数据库连接池服务。可以从池中请求连接并在使用后返回。

标签

dbcpjdbcdatabaseconnectionpoolingstore

属性

下表中，加粗的属性为必填项；其余为可选项。表格同时标注默认值、是否支持表达式语言，以及是否为敏感属性（值会被加密）。

名称	默认值	可选值	描述
Database Connection URL			用于连接数据库的数据库连接 URL。可能包含数据库系统名称、主机、端口、数据库名称和一些参数。数据库连接 URL 的确切语法由您的数据库管理系统指定。支持表达式语言：是（仅使用环境/系统变量求值）
Database Driver Class Name			数据库驱动程序类名支持表达式语言：是（仅使用环境/系统变量求值）
Database Driver Locations			包含驱动程序 JAR 及其依赖项（如果有）的文件/文件夹和/或 URL 的逗号分隔列表。例如“/var/tmp/mariadb-java-client-1.1.7.jar” 支持表达式语言：是（仅使用环境/系统变量求值）
Kerberos User Service		控制器服务 API： `KerberosUserService` cn.org.acal.lynxus-lynxus-standard-services-api-nar-2.11.8	指定应用于 Kerberos 身份验证的 Kerberos 用户Controller Service
Database User			数据库用户名支持表达式语言：是（仅使用环境/系统变量求值）
Password Source	`PASSWORD`	Password — 使用配置的 Password 属性进行数据库身份验证。 Password Provider — 从配置的数据库密码提供程序获取数据库密码。	指定是直接提供数据库密码还是从数据库密码提供程序获取数据库密码。
Password			数据库用户的密码敏感属性：是支持表达式语言：是（仅使用环境/系统变量求值）
Database Password Provider		控制器服务 API： `DatabasePasswordProvider` cn.org.acal.lynxus-lynxus-standard-services-api-nar-2.11.8	按需提供数据库密码的Controller Service。配置后，密码属性将被忽略。
Max Wait Time	`500 millis`		池在没有可用连接时等待连接返回的最大时间，超过此时间将失败；-1 表示无限期等待。支持表达式语言：是（仅使用环境/系统变量求值）
Max Total Connections	`8`		可以同时从此池分配的最大活动连接数，负数表示无限制。支持表达式语言：是（仅使用环境/系统变量求值）
Validation Query			用于在返回连接之前验证连接的验证查询。当连接无效时，它将被丢弃并返回新的有效连接。注意！使用验证可能会有一定的性能损失。支持表达式语言：是（仅使用环境/系统变量求值）
Minimum Idle Connections	`0`		池中可以保持空闲状态的最小连接数，不会创建额外的连接。设置为零以允许没有空闲连接。支持表达式语言：是（仅使用环境/系统变量求值）
Maximum Idle Connections	`8`		池中可以保持空闲状态的最大连接数，不会释放额外的连接。设置为任何负值以允许无限空闲连接。支持表达式语言：是（仅使用环境/系统变量求值）
Maximum Connection Lifetime	`-1`		连接的最大生存时间。超过此时间后，连接将在下一次激活、钝化或验证测试中失败。值为零或更小表示连接具有无限生存时间。支持表达式语言：是（仅使用环境/系统变量求值）
Time Between Eviction Runs	`-1`		空闲连接驱逐线程两次运行之间的休眠时间。当值为非正数时，不会运行空闲连接驱逐线程。支持表达式语言：是（仅使用环境/系统变量求值）
Minimum Evictable Idle Time	`30 mins`		连接在有资格被逐出之前可以在池中闲置的最短时间。支持表达式语言：是（仅使用环境/系统变量求值）
Soft Minimum Evictable Idle Time	`-1`		连接在池中空闲多长时间后有资格被空闲连接驱逐线程驱逐，附加条件是池中至少保留最小数量的空闲连接。当此选项的非软版本设置为正值时，空闲连接驱逐线程会先检查它：当驱逐线程访问空闲连接时，空闲时间首先与之比较（不考虑池中空闲连接的数量），然后再与此软选项比较，包括最小空闲连接约束。支持表达式语言：是（仅使用环境/系统变量求值）

动态属性

动态属性允许用户自定义属性的名称与值。

名称	值	描述
JDBC 属性名称	JDBC 属性值	应用于 JDBC 连接的 JDBC 驱动程序属性名称和值。
SENSITIVE.JDBC 属性名称	JDBC 属性值	以 'SENSITIVE.' 为前缀的 JDBC 驱动程序属性名称作为敏感属性处理。

状态管理

该组件不存储状态。

受限 (Restricted)

该组件不受限。

提供的 Service API

DBCPService (cn.org.acal.lynxus-lynxus-standard-services-api-nar-2.11.8)