java数据库连接池都有哪些配置参数？都在这里了！

在工作中经常要和各种连接池组件打交道，各种参数眼花撩乱，再也不想因为连接池配置光顾度娘了。今天总结的主要是几大常用的数据库连接池配置，redis连接池准备ing。内容主要来自各官方文档。

Druid

官方文档：https://github.com/alibaba/dr...

• 连接池类：com.alibaba.druid.pool.DruidDataSource

配置	缺省值	说明	性能优化	备注
name	null	配置这个属性的意义在于，如果存在多个数据源，监控的时候可以通过名字来区分开来。如果没有配置，将会生成一个名字，格式是："DataSource-" + System.identityHashCode(this). 另外配置此属性至少在1.0.5版本中是不起作用的，强行设置name会出错。详情-点此处。	/	/
url	null	连接数据库的url，不同数据库不一样。例如： mysql : jdbc:mysql://10.20.153.104:3306/druid2 oracle : jdbc:oracle:thin:@10.20.149.85:1521:ocnauto	/	/
username	null	连接数据库的用户名	/	/
password	null	连接数据库的密码。如果你不希望密码直接写在配置文件中，可以使用ConfigFilter。详细看这里	/	/
driverClassName	根据url自动识别	这一项可配可不配，如果不配置druid会根据url自动识别dbType，然后选择相应的driverClassName	/	/
initialSize		初始化时建立物理连接的个数。初始化发生在显示调用init方法，或者第一次getConnection时	可以配置和maxActive相同数量	/
maxActive	8	最大连接池数量	/	/
maxIdle	8	已经不再使用，配置了也没效果	/	/
minIdle	null	最小连接池数量	建议配置和maxActive相同数量	/
maxWait	null	获取连接时最大等待时间，单位毫秒。配置了maxWait之后，缺省启用公平锁，并发效率会有所下降，如果需要可以通过配置useUnfairLock属性为true使用非公平锁。	/	/
dataSouce.setUseUnfairLock(true)	配置了maxWait之后，缺省启用公平锁，并发效率会有所下降	/	/
poolPreparedStatements	false	是否缓存preparedStatement，也就是PSCache。PSCache对支持游标的数据库性能提升巨大，比如说oracle。在mysql下建议关闭。	oracle下可以配置	/
maxPoolPreparedStatementPerConnectionSize	-1	要启用PSCache，必须配置大于0，当大于0时，poolPreparedStatements自动触发修改为true。在Druid中，不会存在Oracle下PSCache占用内存过多的问题，可以把这个数值配置大一些，比如说100	oracle下可以配置	/
validationQuery	null	用来检测连接是否有效的sql，要求是一个查询语句，常用select 'x'。如果validationQuery为null，testOnBorrow、testOnReturn、testWhileIdle都不会起作用。	/	/
validationQueryTimeout	null	单位：秒，检测连接是否有效的超时时间。底层调用jdbc Statement对象的void setQueryTimeout(int seconds)方法	/	/
testOnBorrow	true	申请连接时执行validationQuery检测连接是否有效，做了这个配置会降低性能。	不建议配置	/
testOnReturn	false	归还连接时执行validationQuery检测连接是否有效，做了这个配置会降低性能。	不建议配置	/
testWhileIdle	false	建议配置为true，不影响性能，并且保证安全性。申请连接的时候检测，如果空闲时间大于timeBetweenEvictionRunsMillis，执行validationQuery检测连接是否有效。	建议取代testOnBorrow和testOnReturn，其会影响获取db连接时的性能	配合testWhileIdle=true 和timeBetweenEvictionRunsMillis来优化，无需在每次借用和归还连接时检测连接可用性，而是定期在连接空闲时进行检测，减少性能损耗
keepAlive	false （1.0.28）	连接池中的minIdle数量以内的连接，空闲时间超过minEvictableIdleTimeMillis，则会执行keepAlive操作。	/	/
defualtAutoCommit	true	事务自动提交
timeBetweenEvictionRunsMillis	1分钟（1.0.14）	有两个含义： 1) Destroy线程会检测连接的间隔时间，如果连接空闲时间大于等于minEvictableIdleTimeMillis则关闭物理连接。 2) testWhileIdle的判断依据，详细看testWhileIdle属性的说明	/	/
numTestsPerEvictionRun	30分钟（1.0.14）	不再使用，一个DruidDataSource只支持一个EvictionRun	/	/
minEvictableIdleTimeMillis	连接保持空闲而不被驱逐的最小时间	/	/
connectionInitSqls	物理连接初始化的时候执行的sql	/	/
exceptionSorter	根据dbType自动识别	当数据库抛出一些不可恢复的异常时，抛弃连接	/	/
filters	null	属性类型是字符串，通过别名的方式配置扩展插件，常用的插件有： 监控统计用的filter:stat 日志用的filter:log4j 防御sql注入的filter:wall	/	/
proxyFilters	null	类型是List<com.alibaba.druid.filter.Filter>，如果同时配置了filters和proxyFilters，是组合关系，并非替换关系	/	/
removeAbandoned	false	配置removeAbandoned对性能会有一些影响，建议怀疑存在泄漏之后再打开。在上面的配置中，如果连接超过30分钟未关闭，就会被强行回收，并且日志记录连接申请时的调用堆栈。	/	如果开启此配置，默认会打印堆栈信息，对性能影响较大。

Hikari

官方文档：https://github.com/brettwoold...

• 连接池类：com.zaxxer.hikari.HikariDataSource

配置	缺省值	说明	性能优化
autoCommit	true	自动提交从池中返回的连接	/
connectionTimeout	30000ms	等待来自池的连接的最大毫秒数	/
idleTimeout	600000ms	连接允许在池中闲置的最长时间【一个连接idle状态的最大时长（毫秒），超时则被释放（retired），缺省:10分钟】	/
maxLifetime	1800000ms	池中连接最长生命周期	/
keepaliveTime	0 (disabled)	控制 HikariCP 尝试保持连接活动的频率，以防止它被数据库或网络基础设施超时。该值必须小于该 maxLifetime值。“keepalive”只会发生在空闲连接上。当针对给定连接进行“保持连接”的时间到了时，该连接将从池中删除、“ping”，然后返回到池中。'ping' 是其中之一：调用 JDBC4isValid()方法，或执行 connectionTestQuery. 通常，池外的持续时间应该以个位数毫秒甚至亚毫秒为单位进行测量，因此应该几乎没有或没有明显的性能影响。最小允许值为 30000 毫秒（30 秒）， 默认值：0（禁用）	/
connectionTestQuery	null	如果您的驱动程序支持JDBC4，我们强烈建议您不要设置此属性	建议不设置
minimumIdle	10	池中维护的最小空闲连接数【官方推荐不设置此值，默认同最大连接数相同】	官方推荐不设置此值，默认同最大连接数相同
maximumPoolSize	10	池中最大连接数，包括闲置和使用中的连接	/
metricRegistry	null	该属性允许您指定一个 Codahale / Dropwizard MetricRegistry 的实例，供池使用以记录各种指标	/
healthCheckRegistry	null	该属性允许您指定池使用的Codahale / Dropwizard HealthCheckRegistry的实例来报告当前健康信息	/
poolName	HikariPool-1	连接池的用户定义名称，主要出现在日志记录和JMX管理控制台中以识别池和池配置	/
initializationFailTimeout	1	如果池无法成功初始化连接，则此属性控制池是否将 fail fast	/
isolateInternalQueries	false	是否在其自己的事务中隔离内部池查询，例如连接活动测试	/
allowPoolSuspension	false	控制池是否可以通过JMX暂停和恢复	/
readOnly	false	从池中获取的连接是否默认处于只读模式	/
registerMbeans	false	是否注册JMX管理Bean（MBeans）	/
catalog	null	为支持 catalog 概念的数据库设置默认 catalog	/
connectionInitSql	null	该属性设置一个SQL语句，在将每个新连接创建后，将其添加到池中之前执行该语句。	/
driverClassName	null	HikariCP将尝试通过仅基于jdbcUrl的DriverManager解析驱动程序，但对于一些较旧的驱动程序，还必须指定driverClassName	/
transactionIsolation	null	控制从池返回的连接的默认事务隔离级别	/
validationTimeout	5000	连接将被测试活动的最大时间量	/
leakDetectionThreshold		记录消息之前连接可能离开池的时间量，表示可能的连接泄漏	/
dataSource	null	这个属性允许你直接设置数据源的实例被池包装，而不是让HikariCP通过反射来构造它	/
schema	null	该属性为支持模式概念的数据库设置默认模式	/
threadFactory	null	此属性允许您设置将用于创建池使用的所有线程的java.util.concurrent.ThreadFactory的实例。	/
scheduledExecutor	null	此属性允许您设置将用于各种内部计划任务的java.util.concurrent.ScheduledExecutorService实例	/

DBCP

官方文档：https://commons.apache.org/pr...

• 连接池类：org.apache.commons.dbcp2.BasicDataSource

配置	缺省值	说明	性能优化	备注
username	null	传递给JDBC驱动的用于建立连接的用户名	/	/
password	null	传递给JDBC驱动的用于建立连接的密码	/	/
url	null	传递给JDBC驱动的用于建立连接的URL	/	/
driverClassName	null	使用的JDBC驱动的完整有效的java 类名	/	/
connectionProperties	null	当建立新连接时被发送给JDBC驱动的连接参数	/	/
defaultAutoCommit	true	连接池创建的连接的默认的auto-commit状态	/	/
defaultReadOnly	driver default	连接池创建的连接的默认的read-only状态. 如果没有设置则setReadOnly方法将不会被调用. (某些驱动不支持只读模式,比如:Informix)	/	/
defaultCatalog	null	连接池创建的连接的默认的catalog	/	/
defaultTransactionIsolation	driver default	连接池创建的连接的默认的TransactionIsolation状态. 下面列表当中的某一个: (参考javadoc)	/	/
initialSize	0	初始化连接:连接池启动时创建的初始化连接数量,1.2版本后支持	/	/
maxActive	8	最大活动连接:连接池在同一时间能够分配的最大活动连接的数量, 如果设置为非正数则表示不限制	/	/
maxIdle	8	最大空闲连接:连接池中容许保持空闲状态的最大连接数量,超过的空闲连接将被释放,如果设置为负数表示不限制	/	/
minIdle	0	最小空闲连接:连接池中容许保持空闲状态的最小连接数量,低于这个数量将创建新的连接,如果设置为0则不创建	/	/
maxWait	无限	最大等待时间:当没有可用连接时,连接池等待连接被归还的最大时间(以毫秒计数), 超过时间则抛出异常,如果设置为-1表示无限等待	/	/
validationQuery	null	SQL查询,用来验证从连接池取出的连接,在将连接返回给调用者之前.如果指定,则查询必须是一个SQL SELECT并且必须返回至少一行记录	/	/
testOnBorrow	true	指明是否在从池中取出连接前进行检验,如果检验失败,则从池中去除连接并尝试取出另一个.注意: 设置为true后如果要生效,validationQuery参数必须设置为非空字符串	/	/
testOnReturn	false	指明是否在归还到池中前进行检验注意: 设置为true后如果要生效,validationQuery参数必须设置为非空字符串	/	/
testWhileIdle	false	指明连接是否被空闲连接回收器(如果有)进行检验.如果检测失败,则连接将被从池中去除.注意: 设置为true后如果要生效,validationQuery参数必须设置为非空字符串	建议使用此设置，代替testOnBorrow	/
timeBetweenEvictionRunsMillis	-1	在空闲连接回收器线程运行期间休眠的时间值,以毫秒为单位. 如果设置为非正数,则不运行空闲连接回收器线程	/	/
numTestsPerEvictionRun	3	在每次空闲连接回收器线程(如果有)运行时检查的连接数量	/	/
minEvictableIdleTimeMillis	1000 60 30	连接在池中保持空闲而不被空闲连接回收器线程(如果有)回收的最小时间值，单位毫秒	/	/
poolPreparedStatements	false	开启池的prepared statement 池功能，当开启时, 将为每个连接创建一个statement池,并且被下面方法创建的PreparedStatements将被缓存起来:	/	/
maxOpenPreparedStatements	0	statement池能够同时分配的打开的statements的最大数量, 如果设置为0表示不限制	/	/
removeAbandoned	false	标记是否删除泄露的连接,如果他们超过了removeAbandonedTimout的限制.如果设置为true, 连接被认为是被泄露并且可以被删除,如果空闲时间超过removeAbandonedTimeout.设置为true可以为写法糟糕的没有关闭连接的程序修复数据库连接.	/	如果开启”removeAbandoned”,那么连接在被认为泄露时可能被池回收. 这个机制在(getNumIdle() < 2) and (getNumActive() > getMaxActive() - 3)时被触发.举例当maxActive=20, 活动连接为18,空闲连接为1时可以触发”removeAbandoned”.但是活动连接只有在没有被使用的时间超过”removeAbandonedTimeout”时才被删除,默认300秒.
removeAbandonedTimeout	300	泄露的连接可以被删除的超时值, 单位秒	/	/
logAbandoned	false	标记当Statement或连接被泄露时是否打印程序的stack traces日志。被泄露的Statements和连接的日志添加在每个连接打开或者生成新的Statement,因为需要生成stack trace。	会导致线程爬栈	/

C3P0

官方文档：https://www.mchange.com/proje...

• 连接池类：com.mchange.v2.resourcepool.BasicResourcePool

配置	缺省值	说明	性能优化
acquireIncrement	3	当连接池中的连接耗尽的时，c3p0一次同时创建的连接数	/
acquireRetryAttempts	30	定义在从数据库获取新连接失败后重复尝试的次数	/
acquireRetryDelay	1000	两次连接中间隔时间，单位毫秒	/
autoCommitOnClose	false	连接关闭时默认将所有未提交的操作回滚	/
automaticTestTable	null	c3p0将建一张名为Test的空表，并使用其自带的查询语句进行测试。如果定义了这个参数那么属性preferredTestQuery将被忽略。你不能在这张Test表上进行任何操作，它将只供c3p0测试使用	/
breakAfterAcquireFailure	false	获取连接失败将会引起所有等待连接池来获取连接的线程抛出异常。但是数据源仍有效保留，并在下次调用getConnection()的时候继续尝试获取连接。如果设为true，那么在尝试获取连接失败后该数据源将申明已断开并永久关闭	/
checkoutTimeout	0	当连接池用完时客户端调用getConnection()后等待获取新连接的时间，超时后将抛出SQLException,如设为0则无限期等待	/
connectionTesterClassName	com.mchange.v2.c3p0.impl.DefaultConnectionTester	通过实现ConnectionTester或QueryConnectionTester的类来测试连接。类名需制定全路径	/
forceIgnoreUnresolvedTransactions	false	如果您希望 c3p0 将事务管理留给您，并且既不提交也不回滚（也不修改 Connection autoCommit的状态），您可以将forceIgnoreUnresolvedTransactions设置为 true	作者强烈建议不使用的一个属性
idleConnectionTestPeriod	0	每xxx秒检查所有连接池中的空闲连接	/
initialPoolSize	3	初始化池的连接数，取值应在minPoolSize与maxPoolSize之间	/
maxIdleTime	0	最大空闲时间,xxx秒内未使用则连接被丢弃。若为0则永不丢弃	/
minPoolSize	3	连接池中保留的最小连接数	/
maxPoolSize	15	连接池中保留的最大连接数	/
maxStatements	0	JDBC的标准参数，用以控制数据源内加载的PreparedStatements数量。但由于预缓存的statements属于单个connection而不是整个连接池。所以设置这个参数需要考虑到多方面的因素。如果maxStatements与maxStatementsPerConnection均为0，则缓存被关闭	/
maxStatementsPerConnection	0	maxStatementsPerConnection定义了连接池内单个连接所拥有的最大缓存statements数	/
numHelperThreads	3	帮助配置数据源线程池的行为。默认情况下，每个数据源只有三个关联的辅助线程，负责诸如连接测试工作	/
overrideDefaultUser	null	当用户调用getConnection()时使root用户成为去获取连接的用户。主要用于连接池连接非c3p0的数据源时	/
password	null	密码	/
user	null	/	/
preferredTestQuery	null	定义所有连接测试都执行的测试语句。在使用连接测试的情况下这个一显著提高测试速度。注意：测试的表必须在初始数据源的时候就存在	/
testConnectionOnCheckout	false	因性能消耗大请只在需要的时候使用它。如果设为true那么在每个connection提交的时候都将校验其有效性。	建议使用idleConnectionTestPeriod或automaticTestTable等方法来提升连接测试的性能

Tomcat JDBC

官方文档：https://tomcat.apache.org/tom...

• 连接池类：org.apache.tomcat.jdbc.pool.DataSource

配置	缺省值	说明	性能优化
defaultAutoCommit	null	（布尔值）连接池所创建的连接默认自动提交状态。如果未设置，则默认采用 JDBC 驱动的缺省值（如果未设置，则不会调用 setAutoCommit 方法）。
defaultReadOnly	null	（布尔值）连接池所创建的连接默认只读状态。如果未设置，将不会调用 setReadOnly 方法。（有些驱动并不支持只读模式，比如：informix）
defaultTransactionIsolation	null	（字符串）连接池所创建的连接的默认事务隔离状态。取值范围为：（参考 javadoc） NONE 、 READ_COMMITTED 、 READ_UNCOMMITTED 、 REPEATABLE_READ 、 SERIALIZABLE；如果未设置该值，则不会调用任何方法，默认为 JDBC 驱动。
defaultCatalog		（字符串）连接池所创建的连接的默认catalog。
driverClassName		（字符串）所要使用的 JDBC 驱动的完全限定的 Java 类名。该驱动必须能从与 tomcat-jdbc.jar 同样的类加载器访问
username		（字符串）传入 JDBC 驱动以便建立连接的连接用户名。注意，DataSource.getConnection(username,password) 方法默认不会使用传入该方法内的凭证，但会使用这里的配置信息。可参看 alternateUsernameAllowed 了解更多详情。
password		（字符串）传入 JDBC 驱动以便建立连接的连接密码。注意，DataSource.getConnection(username,password) 方法默认不会使用传入该方法内的凭证，但会使用这里的配置信息。可参看 alternateUsernameAllowed 了解更多详情。
maxActive	100	整形值）池同时能分配的活跃连接的最大数目。默认为 100。
maxIdle	100	(整型值）池始终都应保留的连接的最大数目。默认为 maxActive:100。会周期性检查空闲连接（如果启用该功能），留滞时间超过 minEvictableIdleTimeMillis 的空闲连接将会被释放。（请参考 testWhileIdle）
minIdle	10	(整型值）池始终都应保留的连接的最小数目。如果验证查询失败，则连接池会缩减该值。默认值取自 initialSize:10（请参考 testWhileIdle）。
initialSize	10	（整型值）连接器启动时创建的初始连接数。默认为 10。
maxWait	30000	（整型值）在抛出异常之前，连接池等待（没有可用连接时）返回连接的最长时间，以毫秒计。默认为 30000（30 秒）
testOnBorrow	false	（布尔值）默认值为 false。从池中借出对象之前，是否对其进行验证。如果对象验证失败，将其从池中清除，再接着去借下一个。注意：为了让 true 值生效，validationQuery 参数必须为非空字符串。为了实现更高效的验证，可以采用 validationInterval。
testOnReturn	false	（布尔值）默认值为 false。将对象返回池之前，是否对齐进行验证。注意：为了让 true 值生效，validationQuery 参数必须为非空字符串。
testWhileIdle	false	（布尔值）是否通过空闲对象清除者（如果存在的话）验证对象。如果对象验证失败，则将其从池中清除。注意：为了让 true 值生效，validationQuery 参数必须为非空字符串。该属性默认值为 false，为了运行池的清除/测试线程，必须设置该值。（另请参阅 timeBetweenEvictionRunsMillis）
validationQuery	null	（字符串）在将池中连接返回给调用者之前，用于验证这些连接的 SQL 查询。如果指定该值，则该查询不必返回任何数据，只是不抛出 SQLException 异常。默认为 null。实例值为：SELECT 1（MySQL） select 1 from dual（Oracle） SELECT 1（MySQL Server）。
validationQueryTimeout	-1	（整型值）连接验证失败前的超时时间（以秒计）。通过在执行 validationQuery 的语句上调用 java.sql.Statement.setQueryTimeout(seconds) 来实现。池本身并不会让查询超时，完全是由 JDBC 来强制实现。若该值小于或等于 0，则禁用该功能。默认为 -1。
validatorClassName	null	（字符串）实现 org.apache.tomcat.jdbc.pool.Validator 接口并提供了一个无参（可能是隐式的）构造函数的类名。如果指定该值，将通过该类来创建一个 Validator 实例来验证连接，代替任何验证查询。默认为 null，范例值为：com.mycompany.project.SimpleValidator。
timeBetweenEvictionRunsMillis	5000	（整型值）空闲连接验证/清除线程运行之间的休眠时间（以毫秒计）。不能低于 1 秒。该值决定了我们检查空闲连接、废弃连接的频率，以及验证空闲连接的频率。默认为 5000（5 秒）
numTestsPerEvictionRun		（整型值）Tomcat JDBC 连接池没有用到这个属性。
minEvictableIdleTimeMillis	60000	（整型值）在被确定应被清除之前，对象在池中保持空闲状态的最短时间（以毫秒计）。默认为 60000（60 秒）
accessToUnderlyingConnectionAllowed		（布尔值）没有用到的属性。可以在归入池内的连接上调用 unwrap来访问。参阅 javax.sql.DataSource 接口的相关介绍，或者通过反射调用 getConnection，或者将对象映射为 javax.sql.PooledConnection。
removeAbandoned	false	（布尔值）该值为标志（Flag）值，表示如果连接时间超出了 removeAbandonedTimeout，则将清除废弃连接。如果该值被设置为 true，则如果连接时间大于 removeAbandonedTimeout，该连接会被认为是废弃连接，应予以清除。若应用关闭连接失败时，将该值设为 true 能够恢复该应用的数据库连接。另请参阅 logAbandoned。默认值为 false。
removeAbandonedTimeout	60	（整型值）在废弃连接（仍在使用）可以被清除之前的超时秒数。默认为 60（60 秒）。应把该值设定为应用可能具有的运行时间最长的查询。
logAbandoned	false	（布尔值）标志能够针对丢弃连接的应用代码，进行堆栈跟踪记录。由于生成堆栈跟踪，对废弃连接的日志记录会增加每一个借取连接的开销。默认为 false
connectionProperties	null	（字符串）在建立新连接时，发送给 JDBC 驱动的连接属性。字符串格式必须为：[propertyName=property;]*。注意：user 与 password 属性会显式传入，因此这里并不需要包括它们。默认为 null。
poolPreparedStatements		（布尔值）未使用的属性
maxOpenPreparedStatements		（整型值）未使用的属性
initSQL	null	字符串值。当连接第一次创建时，运行的自定义查询
jdbcInterceptors		字符串。继承自类 org.apache.tomcat.jdbc.pool.JdbcInterceptor 的子类类名列表，由分号分隔。这些拦截器将会插入到 java.sql.Connection 对象的操作队列中。 预定义的拦截器有：org.apache.tomcat.jdbc.pool.interceptor ConnectionState——记录自动提交、只读、catalog以及事务隔离级别等状态。org.apache.tomcat.jdbc.pool.interceptor，StatementFinalizer——记录打开的语句，并当连接返回池后关闭它们。有关更多预定义拦截器的详尽描述，可参阅JDBC 拦截器
validationInterval	30000	长整型值。为避免过度验证而设定的频率时间值（以秒计）。最多以这种频率运行验证。如果连接应该进行验证，但却没能在此间隔时间内得到验证，则会重新对其进行验证。默认为 30000（30 秒）
jmxEnabled	true	布尔值。是否利用 JMX 注册连接池
fairQueue	true	布尔值。假如想用真正的 FIFO 方式公平对待 getConnection 调用，则取值为 true。对空闲连接列表将采用 org.apache.tomcat.jdbc.pool.FairBlockingQueue 实现。默认值为 true。如果想使用异步连接获取功能，则必须使用该标志。设置该标志可保证线程能够按照连接抵达顺序来接收连接。在性能测试时，锁及锁等待的实现方式有很大差异。当 fairQueue=true 时，根据所运行的操作系统，存在一个决策过程。假如系统运行在 Linux 操作系统（属性 os.name = linux）上，为了禁止这个 Linux 专有行为，但仍想使用公平队列，那么只需在连接池类加载之前，将 org.apache.tomcat.jdbc.pool.FairBlockingQueue.ignoreOS=true 添加到系统属性上。
abandonWhenPercentageFull	0	整型值。除非使用中连接的数目超过 abandonWhenPercentageFull 中定义的百分比，否则不会关闭并报告已废弃的连接（因为超时）。取值范围为 0-100。默认值为 0，意味着只要达到 removeAbandonedTimeout，就应关闭连接。
maxAge	0	长整型值。连接保持时间（以毫秒计）。当连接要返回池中时，连接池会检查是否达到 now - time-when-connected > maxAge 的条件，如果条件达成，则关闭该连接，不再将其返回池中。默认值为 0，意味着连接将保持开放状态，在将连接返回池中时，不会执行任何年龄检查。
useEquals	true	布尔值。如果想让 ProxyConnection 类使用 String.equals，则将该值设为 true；若想在对比方法名称时使用 ==，则应将其设为 false。该属性不能用于任何已添加的拦截器中，因为那些拦截器都是分别配置的。默认值为 true。
suspectTimeout	0	整型值。超时时间（以秒计）。默认值为 0。类似于 removeAbandonedTimeout，但不会把连接当做废弃连接从而有可能关闭连接。如果 logAbandoned 设为 true，它只会记录下警告。如果该值小于或等于 0，则不会执行任何怀疑式检查。如果超时值大于 0，而连接还没有被废弃，或者废弃检查被禁用时，才会执行怀疑式检查。如果某个连接被怀疑到，则记录下 WARN 信息并发送一个 JMX 通知。
rollbackOnReturn	false	布尔值。如果 autoCommit==false，那么当连接返回池中时，池会在连接上调用回滚方法，从而终止事务。默认值为 false。
commitOnReturn	false	布尔值。如果 autoCommit==false，那么当连接返回池中时，池会在连接上调用提交方法，从而完成事务；如果 rollbackOnReturn==true，则忽略该属性。默认值为 false。
alternateUsernameAllowed	false	布尔值。出于性能考虑，JDBC 连接池默认会忽略 DataSource.getConnection(username,password)调用，只返回之前池化的具有全局配置属性 username 和 password的连接。但经过配置，连接池还可以允许使用不同的凭证来请求每一个连接。为了启用这项在DataSource.getConnection(username,password)调用中描述的功能，只需将 alternateUsernameAllowed 设为 true。如果你请求一个连接，凭证为 user 1/password 1，而连接之前使用的是 user 2/password 2 凭证，那么连接将被关闭，重新利用请求的凭证来开启。按照这种方式，池的容量始终以全局级别管理，而不是限于模式（schema）级别。默认值为 false。该属性作为一个改进方案，被添加到了 bug 50025 中。
dataSource	null	（javax.sql.DataSource）将数据源注入连接池，从而使池利用数据源来获取连接，而不是利用 java.sql.Driver 接口来建立连接。它非常适于使用数据源（而非连接字符串）来池化 XA 连接或者已建立的连接时。默认值为 null。
dataSourceJNDI	null	字符串。在 JNDI 中查找的数据源的 JNDI 名称，随后将用于建立数据库连接。参看 datasource 属性的介绍。默认值为 null。
useDisposableConnectionFacade	true	布尔值。如果希望在连接上放上一个门面对象，从而使连接在关闭后无法重用，则要将值设为 true。这能防止线程继续引用一个已被关闭的连接，并继续在连接上查询。默认值为 true。
logValidationErrors	false	布尔值。设为 true 时，能将验证阶段的错误记录到日志文件中，错误会被记录为 SEVERE。考虑到了向后兼容性，默认值为 false。
propagateInterruptState	false	布尔值。传播已中断的线程（还没有清除中断状态）的中断状态。考虑到了向后兼容性，默认值为 false。
ignoreExceptionOnPreLoad	false	布尔值。在初始化池时，是否忽略连接创建错误。取值为 true时表示忽略；设为 false 时，抛出异常，从而宣告池初始化失败。默认值为 false。

---

markdown编辑这么长的表格真心心累😟