# BeeCP-Starter
**Repository Path**: Chris2018998/BeeCP-Starter
## Basic Information
- **Project Name**: BeeCP-Starter
- **Description**: BeeCP接池在Springboot的装载器
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 9
- **Forks**: 1
- **Created**: 2021-09-08
- **Last Updated**: 2025-11-16
## Categories & Tags
**Categories**: database-dev
**Tags**: None
## README
BeeCP-Starter是BeeCP(小蜜蜂连接池)的数据源启动器
```xml
com.github.chris2018998
beecp-spring-boot-starter
1.8.20
```
##
:computer: **监控画面**
监控地址:http://IP:port/xxxx/beecp 可打开监控界面（其中xxxx为项目部署名）
##
:book: **应用标签**
| 标签 | 备注 |
|------------------|----------------------|
| @EnableMultiDs | 多数据源启用标签 |
| @EnableDsMonitor | 连接池监控启用标签，否则监控界面无法打开 |
| @DsId | 组合数据源应用时，可指定数据源id |
##
:book: **数据源配置项**
### :capital_abcd: dsId
数据源Id,作为BeanId注册进Spring容器，在多源（@EnableMultiDataSource）时可以配置多个，用逗号隔开例如：ds1,ds2
### :1234: type
数据源类名，如果不填写则默认为：org.stone.beecp.BeeDataSource,此项配置可用于支持其他数据源
#### :capital_abcd: primary
是否注册为默认数据标记
### :1234: jndiName
数据源Jndi名，数据源来自部署容器本身，此项配置与type配置互斥
:sunny: *更多属性项，请参照BeeCP属性清单*
##
:book: **监控项配置**
### :capital_abcd: spring.datasource.consoleUserId
监控登陆用户Id，此项不配置则表示无需登陆
### :1234: spring.datasource.consolePassword
监控登陆用户口令
### :capital_abcd: spring.datasource.sql-trace
sql执行监控开关，true则表示打开
### :1234: spring.datasource.sql-show
后端是否打印sql的开关
### :capital_abcd: spring.datasource.sql-trace-max-size
sql监控池的大小（1000以内）
### :1234: spring.datasource.sql-trace-timeout
sql处于监控池的最大时间，单位：毫秒
### :capital_abcd: spring.datasource.sql-exec-slow-time
低效SqL执行的时间阀值，单位：毫秒
### :capital_abcd: spring.datasource.sql-trace-timeout-scan-period
sql监控池定时扫描间隔时间，在池中时间大于sql-trace-timeout则被清理，单位：毫秒
### :1234: spring.datasource.sql-exec-alert-action
sql执行预警触发类名（需要扩展类：org.stone.beecp.springboot.statement.StatementTraceAlert），低效与错误sql触发
## :point_right: 参考例子
```yml
spring.datasource.sql-trace=true #开启动SQL监控(默认为True)
spring.datasource.sql-show=true #是否打印SQL
spring.datasource.sql-trace-max-size=100 #SQL执行跟踪的个数
spring.datasource.sql-trace-timeout=60000 #SQL执行跟踪最大时间 （毫秒）
spring.datasource.sql-exec-slow-time=5000 #SQL执行时间警告值（毫秒）
spring.datasource.sql-trace-timeout-scan-period=18000 #SQL执行跟踪扫描时间 （毫秒）
spring.datasource.sql-exec-alert-action=xxxxx #SQL执行时间预警值类名（需要扩展类：org.stone.beecp.springboot.statement.StatementTraceAlert)
```
## :tractor: 单源例子
若不启用@EnableMultiDataSource标签，启动器则自动尝试装载单源，前提系统ClassPath中存在小蜜蜂数据源类，适用于单一数据源的情况,参考配置如下
```yml
spring.datasource.type=orgs.stone.beecp.BeeDataSource
spring.datasource.poolName=BeeCP1
spring.datasource.username=root
spring.datasource.password=
spring.datasource.jdbcUrl=jdbc:mysql://localhost:3306/test
spring.datasource.driverClassName=com.mysql.jdbc.Driver
spring.datasource.fairMode=true
spring.datasource.initialSize=10
spring.datasource.maxActive=10
spring.datasource.xxx=value
```
xxx代指数据源的配置属性名,更多属性请参照小蜜蜂连接属性列表
完整参考代码: https://github.com/Chris2018998/BeeCP-Starter/blob/master/doc/SingleDsDemo_JPA.zip
## :tractor: 多源例子
若启用@EnableMultiDataSource标签，则表示工具按多源配置的方式装载数据源，配置个数不限制，但最少一个。
application.properties文件配置
```yml
#按单加载的列表，为数据源的名字清单
spring.datasource.dsId=ds1,ds2,ds3
#第1数据源
spring.datasource.ds1.primary=true
spring.datasource.ds1.poolName=BeeCP1
spring.datasource.ds1.username=root
spring.datasource.ds1.password=root
spring.datasource.ds1.jdbcUrl=jdbc:mysql://localhost:3306/test
spring.datasource.ds1.driverClassName=com.mysql.cj.jdbc.Driver
#第2数据源（容器jndi数据源,不加入监控）
spring.datasource.ds2.jndiName=testDB
#第3数据源(其他类型数据源,不加入监控）
spring.datasource.ds3.poolName=Hikari
#其他数据源类名，类型必须配置
spring.datasource.ds3.type=com.zaxxer.hikari.HikariDataSource
spring.datasource.ds3.username=root
spring.datasource.ds3.password=root
spring.datasource.ds3.jdbcUrl=jdbc:mysql://localhost:3306/test
spring.datasource.ds3.driverClassName=com.mysql.cj.jdbc.Driver
```
完整参考代码：https://github.com/Chris2018998/BeeCP-Starter/blob/master/doc/MutilDsDemo_JPA.zip