日期:2014-05-16  浏览次数:20433 次

数据库链接池(DBCP)配置参考

????? 链接池不但能提高数据库的访问效率,也能有效地控制自己使用的资源,如果链接泄露也能及时发现问题。下面将Tomcat中使用的DBCP配置参数列出,仅供参考。

username 传递给JDBC驱动的用于建立连接的用户名
password 传递给JDBC驱动的用于建立连接的密码
url 传递给JDBC驱动的用于建立连接的URL
driverClassName 使用的JDBC驱动的完整有效的java 类名
connectionProperties 当建立新连接时被发送给JDBC驱动的连接参数,格式必须是 [propertyName=property;]*

注意:参数user/password将被明确传递,所以不需要包括在这里。

defaultAutoCommit true 连接池创建的连接的默认的auto-commit状态
defaultReadOnly? 驱动默认 连接池创建的连接的默认的read-only状态. 如果没有设置则setReadOnly方法将不会被调用. (某些驱动不支持只读模式,比如:Informix)
defaultTransactionIsolation 驱动默认

连接池创建的连接的默认的TransactionIsolation状态. 下面列表当中的某一个: (参考javadoc)

????●?NONE
?? ?●?READ_COMMITTED
?? ?●?READ_UNCOMMITTED
?? ?●?REPEATABLE_READ
?? ?●?SERIALIZABLE
defaultCatalog ? 连接池创建的连接的默认的catalog

?

initialSize 0 初始化连接:连接池启动时创建的初始化连接数量,1.2版本后支持
maxActive 8 最大活动连接:连接池在同一时间能够分配的最大活动连接的数量, 如果设置为非正数则表示不限制
maxIdle 8 最大空闲连接:连接池中容许保持空闲状态的最大连接数量,超过的空闲连接将被释放,如果设置为负数表示不限制
minIdle 0 最小空闲连接:连接池中容许保持空闲状态的最小连接数量,低于这个数量将创建新的连接,如果设置为0则不创建
maxWait 无限 最大等待时间:当没有可用连接时,连接池等待连接被归还的最大时间(以毫秒计数),超过时间则抛出异常,如果设置为-1表示无限等待

?

validationQuery ? SQL查询,用来验证从连接池取出的连接,在将连接返回给调用者之前.如果指定,则查询必须是一个SQL SELECT并且必须返回至少一行记录
testOnBorrow true 指明是否在从池中取出连接前进行检验,如果检验失败,则从池中去除连接并尝试取出另一个.注意: 设置为true后如果要生效,validationQuery参数必须设置为非空字符串
testOnReturn false 指明是否在归还到池中前进行检验注意: 设置为true后如果要生效,validationQuery参数必须设置为非空字符串
testWhileIdle false 指明连接是否被空闲连接回收器(如果有)进行检验.如果检测失败,则连接将被从池中去除.注意: 设置为true后如果要生效,validationQuery参数必须设置为非空字符串
timeBetweenEvictionRunsMillis -1 在空闲连接回收器线程运行期间休眠的时间值,以毫秒为单位. 如果设置为非正数,则不运行空闲连接回收器线程
numTestsPerEvictionRun 3 在每次空闲连接回收器线程(如果有)运行时检查的连接数量
minEvictableIdleTimeMillis 1000 * 60 * 30 连接在池中保持空闲而不被空闲连接回收器线程(如果有)回收的最小时间值,单位毫秒

?

poolPreparedStatements false 开启池的prepared statement 池功能
maxOpenPreparedStatements 无限制 statement池能够同时分配的打开的statements的最大数量, 如果设置为0表示不限制

?这里可以开启PreparedStatements池. 当开启时, 将为每个连接创建一个statement池,并且被下面方法创建的PreparedStatements将被缓存起来:

?? ?● public PreparedStatement prepareStatement(String sql)
?? ?● public PreparedStatement prepareStatement(String sql, int resultSetType, int resultSetConcurrency)

注意: 确认连接还有剩余资源可以留给其他statement。

accessToUnderlyingConnectionAllowed? false 控制PoolGuard是否容许获取底层连接

如果容许则可以使用下面的方式来获取底层连接:

?? ?Connection conn = ds.getConnection();
?? ?Connection dconn = ((DelegatingConnection)conn).getInnermostDelegate();
?? ?...
?? ?conn.close();

默认false不开启, 这是一个有潜在危险的功能, 不适当的编码会造成伤害.(关闭底层连接或者在守护连接已经关闭的情况下继续使用它).请谨慎使用,