欢迎访问个人博客,同步更新: 枫山别院mysql
源代码版本2.4.5-SNAPSHOTsql
使用HikariConfig初始化 HikariCP
在《HikariCP源码分析之初始化分析一》中,咱们解析了 HikariCP 的两种初始化方式,其中提到了使用HikariConfig
的方式:数据库
HikariConfig config = new HikariConfig(); config.setJdbcUrl("jdbc:mysql://localhost:3306/test"); config.setUsername("root"); config.setPassword("123"); //设置数据库独有的属性 config.addDataSourceProperty("cachePrepStmts", "true"); //使用HikariConfig构造HikariDataSource HikariDataSource dataSource = new HikariDataSource(config); //从链接池获取链接 Connection connection = dataSource.getConnection();
这种方式是官方推荐的使用方式,会对性能有必定的提高。HikariConfig
其实就是 HikariCP 的配置类,咱们前面介绍过的HikariDataSource
继承了HikariConfig
,因此咱们也可使用HikariDataSource
直接初始化 HikariCP,可是这种方式性能比用HikariConfig
稍差。源码分析
重要的配置
咱们今天分析下 HikariCP 中的配置,几乎全部的配置都在HikariConfig
中,是HikariConfig
的成员变量。咱们看一下:post
/* 能够在运行期经过JMX修改的属性 */ //从链接池获取链接时最大等待时间, 单位毫秒, 默认值 30秒, 至少 250ms private volatile long connectionTimeout; //检测链接是否有效的超时时间,单位毫秒, 默认 5000ms, 最小 250ms, 不能大于connectionTimeout // private volatile long validationTimeout; //链接能够在池中的最大闲置时间, 单位毫秒, 至少 10s, 默认 10 分钟, 0 表示永不超时, 该配置不能大于maxLifetime private volatile long idleTimeout; //链接泄露检测的最大时间, 默认 0, 最低 2000毫秒; 也就是说, 链接从拿出链接池到还回链接池的总时间, 不能超出这个时间,超出的话就断定为泄露 private volatile long leakDetectionThreshold; //链接最大存活时间, 单位毫秒, 最小容许值30000 ms, 默认30分钟, 推荐设置的比数据库的 wait_timeout 小几分钟 private volatile long maxLifetime; //链接池中能够保留链接的最大数量, 好比: 100, 则链接池中的链接不能超过 100 个 private volatile int maxPoolSize; //最小空闲链接数量, 默认 10 个, 也就是说, 链接池中最多能够保留 10 个空闲的链接, 多的会被关闭 private volatile int minIdle; /* 在运行期不能修改的属性 */ //该属性设置一个SQL语句, 从链接池获取链接时, 先执行改 sql, 验证链接是否可用, 例子: select 1 //若是是使用了 JDBC 4 那么不建议配置这个选项, 由于JDBC 4 使用 ping 命令, 更加高效 private String connectionTestQuery; //数据库驱动的dataSource类名, 与jdbcUrl, 必须二选一, 都配置的话, 优先使用该属性, 例子 : org.postgresql.ds.PGSimpleDataSource private String dataSourceClassName; private String dataSourceJndiName; //数据库驱动类, 与dataSourceClassName不共存, 若是配置了这个属性, 那么jdbcUrl不能为空, 例子: com.mysql.jdbc.Driver private String driverClassName; //与dataSourceClassName, 必须二选一, 都配置的话, 忽略该属性, 例子: jdbc:mysql://localhost:3306/simpsons private String jdbcUrl; //必选, 数据库链接密码 private String password; //链接池名称, 默认自动生成, Hikari 将它通常用于记录日志和 JMX 中, 若是有多个 Hikari 链接池, 建议配置一个有意义的名字 private String poolName; private String transactionIsolationName; //必选, 数据库链接用户名 private String username; //自动提交事务, 默认值true private boolean isAutoCommit; //控制从池中获取的链接是不是只读模式, 须要数据库支持只读模式 private boolean isReadOnly; //默认值true,是否快速失败,即在启动期间建立链接来验证关键参数是否有错误,若是不能创建链接,当即抛出错误,方便用户及时发现问题 private boolean isInitializationFailFast; // private boolean isIsolateInternalQueries; //是否自动注册 JMX 相关的 bean, 用于运行时能够修改链接池设置 private boolean isRegisterMbeans; //是否容许JMX 将链接池挂起 private boolean isAllowPoolSuspension; //用户直接指定dataSource实例, 不使用 Hikari 建立的实例 private DataSource dataSource;
上面不是全部的属性,一些不过重要的属性咱们忽略掉。性能
HikariConfig
的配置能够分为两部分:能够在运行期修改的,不能够在运行期修改的。url
运行期可修改
属性名 | 含义 | 备注 |
---|---|---|
connectionTimeout | 从链接池获取链接时最大等待时间 | 默认值 30秒, 至少 250ms |
validationTimeout | 检测链接是否有效的超时时间 | 默认 5000ms, 最小 250ms, 不能大于connectionTimeout |
idleTimeout | 链接能够在池中的最大闲置时间 | 至少 10s, 默认 10 分钟, 0 表示永不超时, 该配置不能大于maxLifetime |
leakDetectionThreshold | 链接泄露检测的最大时间 | 默认 0表示不启用, 最低 2000毫秒 |
maxLifetime | 链接最大存活时间 | 最小容许值30000 ms, 默认30分钟, 推荐设置的比数据库的 wait_timeout 小几分钟 |
maxPoolSize | 链接池中能够保留链接的最大数量 | |
minIdle | 最小空闲链接数量 | 默认 10 个 |
所谓的运行期能够修改的属性,就是可使用 JMX 直接修改,咱们再《HikariCP源码分析之获取链接流程二》中提到了做者推荐的用法,你们能够看一下。日志
运行期不可修改
属性名 | 含义 | 备注 |
---|---|---|
connectionTestQuery | 验证链接是否可用的 sql | 例子: select 1,若是是使用了 JDBC 4 那么不建议配置这个选项, 由于JDBC 4 使用 ping 命令, 更加高效 |
dataSourceClassName | 数据库驱动的dataSource类名 | 与jdbcUrl, 必须二选一, 都配置的话, 优先使用该属性, 例子 : org.postgresql.ds.PGSimpleDataSource |
driverClassName | 数据库驱动类 | 与dataSourceClassName不共存, 若是配置了这个属性, 那么jdbcUrl不能为空, 例子: com.mysql.jdbc.Driver |
jdbcUrl | url | 与dataSourceClassName, 必须二选一, 都配置的话, 忽略该属性, 例子: jdbc:mysql://localhost:3306/simpsons |
password | 数据库链接密码 | |
username | 数据库链接用户名 | |
isRegisterMbeans | 是否自动注册 JMX 相关的 bean | 用于运行时能够修改链接池设置 |
isAllowPoolSuspension | 是否容许JMX 将链接池挂起 |
值得一提的是,若是要用 JMX 修改运行时配置,则必须配置isRegisterMbeans
和isAllowPoolSuspension
。postgresql
其实比较重要的是运行时能够修改的那几个配置,只要搞明白了他们的含义,你们就能够按照本身的状况修改。code