“Druid数据库连接池的使用实现”的版本间的差异
Jihongchang(讨论 | 贡献) |
Jihongchang(讨论 | 贡献) |
||
| (未显示同一用户的4个中间版本) | |||
| 第4行: | 第4行: | ||
https://github.com/alibaba/druid/wiki/%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98 | https://github.com/alibaba/druid/wiki/%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98 | ||
| + | |||
| + | |||
| + | === 详细配置参数 === | ||
| + | https://github.com/alibaba/druid/wiki/DruidDataSource%E9%85%8D%E7%BD%AE%E5%B1%9E%E6%80%A7%E5%88%97%E8%A1%A8 | ||
| + | {| class="wikitable" | ||
| + | !配置 | ||
| + | !缺省值 | ||
| + | !说明 | ||
| + | |- | ||
| + | |name | ||
| + | | | ||
| + | |配置这个属性的意义在于,如果存在多个数据源,监控的时候可以通过名字来区分开来。如果没有配置,将会生成一个名字,格式是:"DataSource-" + System.identityHashCode(this). 另外配置此属性至少在1.0.5版本中是不起作用的,强行设置name会出错。详情-点此处。 | ||
| + | |- | ||
| + | |url | ||
| + | | | ||
| + | |连接数据库的url,不同数据库不一样。例如: | ||
| + | mysql : jdbc:mysql://10.20.153.104:3306/druid2 | ||
| + | oracle : jdbc:oracle:thin:@10.20.149.85:1521:ocnauto | ||
| + | |- | ||
| + | |username | ||
| + | | | ||
| + | |连接数据库的用户名 | ||
| + | |- | ||
| + | |password | ||
| + | | | ||
| + | |连接数据库的密码。如果你不希望密码直接写在配置文件中,可以使用ConfigFilter。详细看这里 | ||
| + | |- | ||
| + | |driverClassName | ||
| + | |根据url自动识别 | ||
| + | |这一项可配可不配,如果不配置druid会根据url自动识别dbType,然后选择相应的driverClassName | ||
| + | |- | ||
| + | |initialSize | ||
| + | |0 | ||
| + | |初始化时建立物理连接的个数。初始化发生在显示调用init方法,或者第一次getConnection时 | ||
| + | |- | ||
| + | |maxActive | ||
| + | |8 | ||
| + | |最大连接池数量 | ||
| + | |- | ||
| + | |maxIdle | ||
| + | |8 | ||
| + | |已经不再使用,配置了也没效果 | ||
| + | |- | ||
| + | |minIdle | ||
| + | | | ||
| + | |最小连接池数量 | ||
| + | |- | ||
| + | |maxWait | ||
| + | | | ||
| + | |获取连接时最大等待时间,单位毫秒。配置了maxWait之后,缺省启用公平锁,并发效率会有所下降,如果需要可以通过配置useUnfairLock属性为true使用非公平锁。 | ||
| + | |- | ||
| + | |poolPreparedStatements | ||
| + | |false | ||
| + | |是否缓存preparedStatement,也就是PSCache。PSCache对支持游标的数据库性能提升巨大,比如说oracle。在mysql下建议关闭。 | ||
| + | |- | ||
| + | |maxPoolPreparedStatementPerConnectionSize | ||
| + | | -1 | ||
| + | |要启用PSCache,必须配置大于0,当大于0时,poolPreparedStatements自动触发修改为true。在Druid中,不会存在Oracle下PSCache占用内存过多的问题,可以把这个数值配置大一些,比如说100 | ||
| + | |- | ||
| + | |validationQuery | ||
| + | | | ||
| + | |用来检测连接是否有效的sql,要求是一个查询语句,常用select 'x'。如果validationQuery为null,testOnBorrow、testOnReturn、testWhileIdle都不会起作用。 | ||
| + | |- | ||
| + | |validationQueryTimeout | ||
| + | | | ||
| + | |单位:秒,检测连接是否有效的超时时间。底层调用jdbc Statement对象的void setQueryTimeout(int seconds)方法 | ||
| + | |- | ||
| + | |testOnBorrow | ||
| + | |true | ||
| + | |申请连接时执行validationQuery检测连接是否有效,做了这个配置会降低性能。 | ||
| + | |- | ||
| + | |testOnReturn | ||
| + | |false | ||
| + | |归还连接时执行validationQuery检测连接是否有效,做了这个配置会降低性能。 | ||
| + | |- | ||
| + | |testWhileIdle | ||
| + | |false | ||
| + | |建议配置为true,不影响性能,并且保证安全性。申请连接的时候检测,如果空闲时间大于timeBetweenEvictionRunsMillis,执行validationQuery检测连接是否有效。 | ||
| + | |- | ||
| + | |keepAlive | ||
| + | |false | ||
| + | (1.0.28) | ||
| + | |连接池中的minIdle数量以内的连接,空闲时间超过minEvictableIdleTimeMillis,则会执行keepAlive操作。 | ||
| + | |- | ||
| + | |timeBetweenEvictionRunsMillis | ||
| + | |1分钟(1.0.14) | ||
| + | |有两个含义: | ||
| + | 1) Destroy线程会检测连接的间隔时间,如果连接空闲时间大于等于minEvictableIdleTimeMillis则关闭物理连接。 | ||
| + | 2) testWhileIdle的判断依据,详细看testWhileIdle属性的说明 | ||
| + | |- | ||
| + | |numTestsPerEvictionRun | ||
| + | |30分钟(1.0.14) | ||
| + | |不再使用,一个DruidDataSource只支持一个EvictionRun | ||
| + | |- | ||
| + | |minEvictableIdleTimeMillis | ||
| + | | | ||
| + | |连接保持空闲而不被驱逐的最小时间 | ||
| + | |- | ||
| + | |connectionInitSqls | ||
| + | | | ||
| + | |物理连接初始化的时候执行的sql | ||
| + | |- | ||
| + | |exceptionSorter | ||
| + | |根据dbType自动识别 | ||
| + | |当数据库抛出一些不可恢复的异常时,抛弃连接 | ||
| + | |- | ||
| + | |filters | ||
| + | | | ||
| + | |属性类型是字符串,通过别名的方式配置扩展插件,常用的插件有: | ||
| + | 监控统计用的filter:stat | ||
| + | 日志用的filter:log4j | ||
| + | 防御sql注入的filter:wall | ||
| + | |- | ||
| + | |proxyFilters | ||
| + | | | ||
| + | |类型是List<com.alibaba.druid.filter.Filter>,如果同时配置了filters和proxyFilters,是组合关系,并非替换关系 | ||
| + | |} | ||
| + | |||
| + | |||
| + | === pom.xml 引入依赖 === | ||
| + | <syntaxhighlight lang="xml"> | ||
| + | <dependency> | ||
| + | <groupId>com.alibaba</groupId> | ||
| + | <artifactId>druid</artifactId> | ||
| + | <version>1.1.10</version> | ||
| + | </dependency> | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | |||
| + | |||
| + | === 外部配置文件 === | ||
| + | <syntaxhighlight lang="properties"> | ||
| + | url=jdbc:mysql://localhost:3306/jdbc_test?rewriteBatchedStatements=true | ||
| + | username=root | ||
| + | password=123456 | ||
| + | driverClassName=com.mysql.cj.jdbc.Driver | ||
| + | |||
| + | initialSize=5 | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | |||
| + | |||
| + | === Java 代码实例化 Druid 数据库连接池对象 === | ||
| + | <syntaxhighlight lang="java"> | ||
| + | package io.github.jihch.connection; | ||
| + | |||
| + | import com.alibaba.druid.pool.DruidDataSourceFactory; | ||
| + | |||
| + | import javax.sql.DataSource; | ||
| + | import java.io.InputStream; | ||
| + | import java.sql.Connection; | ||
| + | import java.sql.SQLException; | ||
| + | import java.util.Properties; | ||
| + | |||
| + | public class DruidTest { | ||
| + | |||
| + | private static DataSource source; | ||
| + | |||
| + | static { | ||
| + | Properties pros = new Properties(); | ||
| + | InputStream is = ClassLoader.getSystemClassLoader().getResourceAsStream("druid.properties"); | ||
| + | try { | ||
| + | pros.load(is); | ||
| + | source = DruidDataSourceFactory.createDataSource(pros); | ||
| + | } catch (Exception e) { | ||
| + | e.printStackTrace(); | ||
| + | } | ||
| + | |||
| + | } | ||
| + | |||
| + | public Connection getConnection() throws SQLException { | ||
| + | Connection conn = source.getConnection(); | ||
| + | return conn; | ||
| + | } | ||
| + | |||
| + | } | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | |||
| + | |||
| + | |||
| + | https://github.com/jihch/jdbc_2/blob/main/src/main/resources/druid.properties | ||
| + | |||
| + | https://github.com/jihch/jdbc_2/blob/main/src/main/java/io/github/jihch/connection/DruidTest.java | ||
| + | |||
| + | https://github.com/jihch/jdbc_2/blob/main/src/test/java/io/github/jihch/connection/DruidTestTest.java | ||
| + | |||
| + | https://github.com/jihch/jdbc_2/blob/main/src/main/java/io/github/jihch/betterutil/JDBCUtils.java | ||
| + | |||
| + | https://github.com/jihch/jdbc_2/blob/main/src/test/java/io/github/jihch/betterutil/JDBCUtilsTest.java | ||
2023年1月13日 (五) 12:14的最新版本
https://www.bilibili.com/video/BV1eJ411c7rf?p=50
Druid 是阿里巴巴开源平台上一个数据库连接池实现,它结合了 C3P0、DBCP、Proxool 等数据库连接池的优点,同时加入了日志监控,可以很好地监控数据库连接池连接和 SQL 的执行情况,可以说是针对监控而生的 DB 连接池,可以说是目前最好的连接池之一。
https://github.com/alibaba/druid/wiki/%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98
详细配置参数
| 配置 | 缺省值 | 说明 |
|---|---|---|
| name | 配置这个属性的意义在于,如果存在多个数据源,监控的时候可以通过名字来区分开来。如果没有配置,将会生成一个名字,格式是:"DataSource-" + System.identityHashCode(this). 另外配置此属性至少在1.0.5版本中是不起作用的,强行设置name会出错。详情-点此处。 | |
| url | 连接数据库的url,不同数据库不一样。例如:
mysql : jdbc:mysql://10.20.153.104:3306/druid2 oracle : jdbc:oracle:thin:@10.20.149.85:1521:ocnauto | |
| username | 连接数据库的用户名 | |
| password | 连接数据库的密码。如果你不希望密码直接写在配置文件中,可以使用ConfigFilter。详细看这里 | |
| driverClassName | 根据url自动识别 | 这一项可配可不配,如果不配置druid会根据url自动识别dbType,然后选择相应的driverClassName |
| initialSize | 0 | 初始化时建立物理连接的个数。初始化发生在显示调用init方法,或者第一次getConnection时 |
| maxActive | 8 | 最大连接池数量 |
| maxIdle | 8 | 已经不再使用,配置了也没效果 |
| minIdle | 最小连接池数量 | |
| maxWait | 获取连接时最大等待时间,单位毫秒。配置了maxWait之后,缺省启用公平锁,并发效率会有所下降,如果需要可以通过配置useUnfairLock属性为true使用非公平锁。 | |
| poolPreparedStatements | false | 是否缓存preparedStatement,也就是PSCache。PSCache对支持游标的数据库性能提升巨大,比如说oracle。在mysql下建议关闭。 |
| maxPoolPreparedStatementPerConnectionSize | -1 | 要启用PSCache,必须配置大于0,当大于0时,poolPreparedStatements自动触发修改为true。在Druid中,不会存在Oracle下PSCache占用内存过多的问题,可以把这个数值配置大一些,比如说100 |
| validationQuery | 用来检测连接是否有效的sql,要求是一个查询语句,常用select 'x'。如果validationQuery为null,testOnBorrow、testOnReturn、testWhileIdle都不会起作用。 | |
| validationQueryTimeout | 单位:秒,检测连接是否有效的超时时间。底层调用jdbc Statement对象的void setQueryTimeout(int seconds)方法 | |
| testOnBorrow | true | 申请连接时执行validationQuery检测连接是否有效,做了这个配置会降低性能。 |
| testOnReturn | false | 归还连接时执行validationQuery检测连接是否有效,做了这个配置会降低性能。 |
| testWhileIdle | false | 建议配置为true,不影响性能,并且保证安全性。申请连接的时候检测,如果空闲时间大于timeBetweenEvictionRunsMillis,执行validationQuery检测连接是否有效。 |
| keepAlive | false
(1.0.28) |
连接池中的minIdle数量以内的连接,空闲时间超过minEvictableIdleTimeMillis,则会执行keepAlive操作。 |
| timeBetweenEvictionRunsMillis | 1分钟(1.0.14) | 有两个含义:
1) Destroy线程会检测连接的间隔时间,如果连接空闲时间大于等于minEvictableIdleTimeMillis则关闭物理连接。 2) testWhileIdle的判断依据,详细看testWhileIdle属性的说明 |
| numTestsPerEvictionRun | 30分钟(1.0.14) | 不再使用,一个DruidDataSource只支持一个EvictionRun |
| minEvictableIdleTimeMillis | 连接保持空闲而不被驱逐的最小时间 | |
| connectionInitSqls | 物理连接初始化的时候执行的sql | |
| exceptionSorter | 根据dbType自动识别 | 当数据库抛出一些不可恢复的异常时,抛弃连接 |
| filters | 属性类型是字符串,通过别名的方式配置扩展插件,常用的插件有:
监控统计用的filter:stat 日志用的filter:log4j 防御sql注入的filter:wall | |
| proxyFilters | 类型是List<com.alibaba.druid.filter.Filter>,如果同时配置了filters和proxyFilters,是组合关系,并非替换关系 |
pom.xml 引入依赖
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid</artifactId>
<version>1.1.10</version>
</dependency>
外部配置文件
url=jdbc:mysql://localhost:3306/jdbc_test?rewriteBatchedStatements=true
username=root
password=123456
driverClassName=com.mysql.cj.jdbc.Driver
initialSize=5
Java 代码实例化 Druid 数据库连接池对象
package io.github.jihch.connection;
import com.alibaba.druid.pool.DruidDataSourceFactory;
import javax.sql.DataSource;
import java.io.InputStream;
import java.sql.Connection;
import java.sql.SQLException;
import java.util.Properties;
public class DruidTest {
private static DataSource source;
static {
Properties pros = new Properties();
InputStream is = ClassLoader.getSystemClassLoader().getResourceAsStream("druid.properties");
try {
pros.load(is);
source = DruidDataSourceFactory.createDataSource(pros);
} catch (Exception e) {
e.printStackTrace();
}
}
public Connection getConnection() throws SQLException {
Connection conn = source.getConnection();
return conn;
}
}
https://github.com/jihch/jdbc_2/blob/main/src/main/resources/druid.properties
https://github.com/jihch/jdbc_2/blob/main/src/main/java/io/github/jihch/connection/DruidTest.java
https://github.com/jihch/jdbc_2/blob/main/src/main/java/io/github/jihch/betterutil/JDBCUtils.java