☕ 简介

BeeCP-Starter是BeeCP(小蜜蜂连接池)在Springboot的数据源管理工具

[如果您在寻找一款更专业性数据源管理工具，推荐使用Baomidou动态数据源启动器(https://github.com/baomidou/dynamic-datasource-spring-boot-starter)]

⬇️ 下载

Maven坐标

<dependency>
   <groupId>com.github.chris2018998</groupId>
   <artifactId>beecp-spring-boot-starter</artifactId>
   <version>1.8.5</version>
</dependency>

💻 监控画面

监控地址:http://IP:port/xxxx/beecp 可打开监控界面（其中xxxx为项目部署名）

📖 应用标签

标签	备注
@EnableMultiDs	多数据源启用标签
@EnableDsMonitor	连接池监控启用标签，否则监控界面无法打开
@DsId	组合数据源应用时，可指定数据源id

📖 数据源配置项

🔠 dsId

数据源Id,作为BeanId注册进Spring容器，在多源（@EnableMultiDataSource）时可以配置多个，用逗号隔开例如：ds1,ds2

🔢 type

数据源类名，如果不填写则默认为：org.stone.beecp.BeeDataSource,此项配置可用于支持其他数据源

🔠 primary

是否注册为默认数据标记

🔢 jndiName

数据源Jndi名，数据源来自部署容器本身，此项配置与type配置互斥 :sunny: 更多属性项，请参照BeeCP属性清单

📖 监控项配置

🔠 spring.datasource.consoleUserId

监控登陆用户Id，此项不配置则表示无需登陆

🔢 spring.datasource.consolePassword

监控登陆用户口令

🔠 spring.datasource.sql-trace

sql执行监控开关，true则表示打开

🔢 spring.datasource.sql-show

后端是否打印sql的开关

🔠 spring.datasource.sql-trace-max-size

sql监控池的大小（1000以内）

🔢 spring.datasource.sql-trace-timeout

sql处于监控池的最大时间，单位：毫秒

🔠 spring.datasource.sql-exec-slow-time

低效SqL执行的时间阀值，单位：毫秒

🔠 spring.datasource.sql-trace-timeout-scan-period

sql监控池定时扫描间隔时间，在池中时间大于sql-trace-timeout则被清理，单位：毫秒

🔢 spring.datasource.sql-exec-alert-action

sql执行预警触发类名（需要扩展类：org.stone.beecp.springboot.statement.StatementTraceAlert），低效与错误sql触发

👉 参考例子

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)

🚜 单源例子

若不启用@EnableMultiDataSource标签，启动器则自动尝试装载单源，前提系统ClassPath中存在小蜜蜂数据源类，适用于单一数据源的情况,参考配置如下

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

🚜 多源例子

若启用@EnableMultiDataSource标签，则表示工具按多源配置的方式装载数据源，配置个数不限制，但最少一个。

application.properties文件配置

#按单加载的列表，为数据源的名字清单
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