BeeCP-Starter: A Java repository from Emily0539

BeeCP-Starter是小蜜蜂连接池在Springboot的装载器，通过标签+配置文件的方式启动一个或多个数据源，同时提供监控界面。

Maven坐标(Java8)

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

标签介绍

标签	备注
@EnableMultiDataSource	多数据源启用标签，一定要配置在@SpringBootApplication之前
@EnableDataSourceMonitor	连接池监控启用标签，可通过界面实时查看连接情况和SQL执行情况
@DataSourceId	数据源动态切换标签

单源例子

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

spring.datasource.type=cn.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.rar

多源例子

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

application.properties文件配置

#按单加载的列表，为数据源的名字清单
spring.datasource.ds-ids=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.rar

多源配置

配置项	说明	备注
dsIds	数据源配置名单表,名字作为数据源的Ioc注册名	必须提供
type	数据源类名,必须含有无参构造函数	其他数据源必须提供，则会默认为小蜜蜂池的配置
primary	是否为首要数据源,不配置为false
jndiName	数据源Jndi名，数据源来自部署容器本身	此项配置与type配置互斥

数据源配置工厂如下

public interface SpringBootDataSourceFactory {

    Object getObjectInstance(Environment environment, String dsId, String dsConfigPrefix) throws Exception;
}

监控界面

监控标签启用后，访问页面的地址为:http://IP:port/xxxx/BeeCPMonitor.html（其中xxxx为项目名）效果页面如下

SQL监控配置