DBCP参数集.docx

由于commons-dbcp所用的连接池出现版本升级，因此commons-dbcp2中的数据库池连接配置也发生了变化，具体的参数配置说明如下：参数 描述 username通过JDBC建立一个连接所需的用户名password通过JDBC建立一个连接所需的密码url通过JDBC建立一个连接所需的URLdriverClassName所使用的JDBC驱动的类全名connectionProperties连接参数是在建立一个新连接时发送给JDBC驱动的字符串的格式必须是[参数名=参数值;]提示：用户名和密码属性是需要明确指出的，所以这两个参数不需要包含在这里 参数 缺省值 描述 defaultAutoCommitJDBC驱动的缺省值通过这个池创建连接的默认自动提交状态。如果不设置，则setAutoCommit?方法将不被调用。defaultReadOnlyJDBC驱动的缺省值通过这个池创建连接的默认只读状态。如果不设置，则setReadOnly??方法将不被调用。（部分驱动不支持只读模式，如：Informix） defaultTransactionIsolationJDBC驱动的缺省值通过这个池创建连接的默认事务策略，设置值为下列中的某一个：?(参考?javadoc) NONEREAD_COMMITTEDREAD_UNCOMMITTEDREPEATABLE_READSERIALIZABLEdefaultCatalog?通过这个池创建连接的默认缺省的catalog?cacheStatetrue如 果设置为true，池化的连接将在第一次读或写，以及随后的写的时候缓存当前的只读状态和自动提交设置。这样就省去了对getter的任何进一步的调用时 对数据库的额外查询。如果直接访问底层连接，只读状态和/或自动提交设置改变缓存值将不会被反映到当前的状态，在这种情况下，应该将该属性设置为 false以禁用缓存。参数 缺省值 描述 initialSize0当这个池被启动时初始化的创建的连接个数，起始生效版本：1.2maxTotal8可以在这个池中同时被分配的有效连接数的最大值，如设置为负数，则不限制maxIdle8可以在池中保持空闲的最大连接数，超出设置值之外的空闲连接将被回收，如设置为负数，则不限制 minIdle0可以在池中保持空闲的最小连接数，超出设置值之外的空闲连接将被创建，如设置为0，则不创建maxWaitMillisindefinitely（如果没有可用连接）池在抛出异常前等待的一个连接被归还的最大毫秒数，设置为-1则等待时间不确定 ?提示: 如果在高负载的系统中将maxIdle的值设置的很低，则你可能会发现在一个新的连接刚刚被创建的时候就立即被关闭了。这是活跃的线程及时关闭连接要比那 些打开连接的线程要快，导致空闲的连接数大于maxIdle。高负载系统中maxIdle的最合适的配置值是多样的，但是缺省值是一个好的开始点。参数 缺省值 描述 validationQuery?在连接池返回连接给调用者前用来进行连接校验的查询sql。如果指定，则这个查询必须是一个至少返回一行数据的SQL SELECT语句。如果没有指定，则连接将通过调用isValid()?方法进行校验。testOnCreatefalse指明对象在创建后是否需要被校验，如果对象校验失败，则触发对象创建的租借尝试将失败。testOnBorrowtrue指明在从池中租借对象时是否要进行校验，如果对象校验失败，则对象将从池子释放，然后我们将尝试租借另一个testOnReturnfalse指明在将对象归还给连接池前是否需要校验。testWhileIdlefalse指明对象是否需要通过对象驱逐者进行校验（如果有的话），假如一个对象校验失败，则对象将被从池中释放。timeBetweenEvictionRunsMillis-1空闲对象驱逐线程运行时的休眠毫秒数，如果设置为非正数，则不运行空闲对象驱逐线程。numTestsPerEvictionRun3在每个空闲对象驱逐线程运行过程中中进行检查的对象个数。（如果有的话）minEvictableIdleTimeMillis1000 * 60 * 30符合对象驱逐对象驱逐条件的对象在池中最小空闲毫秒总数（如果有的话） softMiniEvictableIdleTimeMillis-1符合对象驱逐对象驱逐条件的对象在池中最小空闲毫秒总数，额外的条件是池中至少保留有minIdle所指定的个数的连接。当miniEvictableIdleTimeMillis?被 设置为一个正数，空闲连接驱逐者首先检测miniEvictableIdleTimeMillis，当空闲连接被驱逐者访问时，首先与 miniEvictableIdleTimeMillis?所指定的值进行比较（