内容简介:一个基于springboot的快速集成多数据源的启动器 https://gitee.com/baomidou/dynamic-datasource-spring-boot-starter 简介 dynamic-datasource-spring-boot-starter 是一个基于springboot的快速集成多数据源的启...
一个基于springboot的快速集成多数据源的启动器
https://gitee.com/baomidou/dynamic-datasource-spring-boot-starter
简介
dynamic-datasource-spring-boot-starter 是一个基于springboot的快速集成多数据源的启动器。
其支持 Jdk 1.7+, SpringBoot 1.4.x 1.5.x 2.0.x。
从 2.0.0 开始它适用于多种场景,常见的场景如下。
纯粹多库,各个库甚至可以是不同的数据库。
读写分离,一主多从,多主多从。
混合模式,既有主从也有单库。
本框架只做 切换数据源 这件核心的事情,并不限制您的具体操作。
强烈建议在 主从模式 下遵循普遍的规则,以便他人能更轻易理解您的代码。
主数据库 建议 只执行 INSERT UPDATE DELETE 操作。
从数据库 建议 只执行 SELECT 操作。
另外如果您的项目比较复杂,强烈建议您使用 sharding-jdbc 。
使用方法
引入dynamic-datasource-spring-boot-starter。
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>dynamic-datasource-spring-boot-starter</artifactId>
<version>${version}</version>
</dependency>配置数据源。
从 2.0.0 开始所有数据源的 配置同级 ,不再有默认的主从限制,您可以给您的数据源起任何合适的名字。
约定大于配置:
所有以下划线
_分割的数据源 首部 即为组的名称,相同组名称的数据源会放在一个组下。默认的数据源名称为 master ,您可以通过spring.datasource.dynamic.primary来修改。
下面给出最常见的几种配置方案:
一主多从方案:
spring: datasource: dynamic: primary: master #设置默认的数据源或者数据源组,默认值即为master,如果你主从默认下主库的名称就是master可不定义此项。 datasource: master: username: root password: 123456 driver-class-name: com.mysql.jdbc.Driver url: jdbc:mysql://47.100.20.186:3306/dynamic?characterEncoding=utf8&useSSL=false slave_1: username: root password: 123456 driver-class-name: com.mysql.jdbc.Driver url: jdbc:mysql://47.100.20.186:3307/dynamic?characterEncoding=utf8&useSSL=false slave_2: username: root password: 123456 driver-class-name: com.mysql.jdbc.Driver url: jdbc:mysql://47.100.20.186:3308/dynamic?characterEncoding=utf8&useSSL=false #......省略 #以上会配置一个默认库master,一个组slave下有两个子库slave_1,slave_2
多主多从方案:(谨慎使用,您清楚的知道多个主库间需要自己做同步)
spring: datasource: dynamic: datasource: master_1: master_2: slave_1: slave_2: slave_3:
纯粹多库方案:
spring: datasource: dynamic: primary: mysql #记得设置一个默认数据源 datasource: mysql: oracle: sqlserver: h2:
混合方案:
spring: datasource: dynamic: datasource: master: slave_1: slave_2: oracle_1: oracle_2: sqlserver:
使用 @DS 切换数据源。
@DS 可以注解在方法上和类上,同时存在方法注解优先于类上注解,强烈建议注解在service实现或mapper接口方法上。
注意从2.0.0 不再支持@DS空注解 ,您 必须 指明你所需要的数据库 组名 或者 具体某个数据库名称 。
| 注解 | 结果 |
|---|---|
| 没有@DS | 默认数据源 |
| @DS("dsName") | 存在slave指定slave,不存在主库 |
@Service
@DS("slave")
public class UserServiceImpl implements UserService {
@Autowired
private JdbcTemplate jdbcTemplate;
public List<Map<String, Object>> selectAll() {
return jdbcTemplate.queryForList("select * from user");
}
@Override
@DS("slave_1")
public List<Map<String, Object>> selectByCondition() {
return jdbcTemplate.queryForList("select * from user where age >10");
}
}在mybatis环境下也可注解在mapper接口层。
@DS("slave")
public interface UserMapper {
@Insert("INSERT INTO user (name,age) values (#{name},#{age})")
boolean addUser(@Param("name") String name, @Param("age") Integer age);
@Update("UPDATE user set name=#{name}, age=#{age} where id =#{id}")
boolean updateUser(@Param("id") Integer id, @Param("name") String name, @Param("age") Integer age);
@Delete("DELETE from user where id =#{id}")
boolean deleteUser(@Param("id") Integer id);
@Select("SELECT * FROM user")
@DS("slave_1")
List<User> selectAll();
}集成druid
springBoot2.x默认使用HikariCP,但在国内Druid的使用者非常庞大,此项目特地对其进行了适配,完成多数据源下使用Druid进行监控。
注意:主从可以使用不同的数据库连接池,如master使用Druid监控,从库使用HikariCP。 如果不配置连接池type类型,默认是Druid优先于HikariCP。
项目引入
druid-spring-boot-starter依赖。
<dependency> <groupId>com.alibaba</groupId> <artifactId>druid-spring-boot-starter</artifactId> <version>1.1.10</version> </dependency>
排除 原生Druid的快速配置类。
@SpringBootApplication(exclude = DruidDataSourceAutoConfigure.class)
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}为什么要排除DruidDataSourceAutoConfigure ?
DruidDataSourceAutoConfigure会注入一个DataSourceWrapper,其会在原生的spring.datasource下找url,username,password等。而我们动态数据源的配置路径是变化的。
其他属性依旧如原生
druid-spring-boot-starter的配置。
spring: datasource: druid: stat-view-servlet: loginUsername: admin loginPassword: 123456 dynamic: datasource: master: username: root password: 123456 driver-class-name: com.mysql.jdbc.Driver url: jdbc:mysql://47.100.20.186:3306/dynamic?characterEncoding=utf8&useSSL=false druid: #以下均为默认值 initial-size: 3 max-active: 8 min-idle: 2 max-wait: -1 min-evictable-idle-time-millis: 30000 max-evictable-idle-time-millis: 30000 time-between-eviction-runs-millis: 0 validation-query: select 1 validation-query-timeout: -1 test-on-borrow: false test-on-return: false test-while-idle: true pool-prepared-statements: true max-open-prepared-statements: 100 filters: stat,wall share-prepared-statements: true
如上即可配置访问用户和密码,访问 http://localhost:8080/druid/index.html 查看druid监控。
自定义
自定义数据源来源。
数据源来源的默认实现是YmlDynamicDataSourceProvider,其从yaml或properties中读取信息并解析出所有数据源信息。
public interface DynamicDataSourceProvider {
/**
* 加载所有数据源
*
* @return 所有数据源,key为数据源名称
*/
Map<String, DataSource> loadDataSources();
}【声明】文章转载自:开源中国社区 [http://www.oschina.net]
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持 码农网
猜你喜欢:- 苞米豆 — 谷歌验证码快速启动器 1.1.0 发布
- 苞米豆-多数据源快速启动器 V1.4.0 发布
- 苞米豆-多数据源启动器 2.0.0 全新发布:无限制分组
- 苞米豆多数据源启动器 2.0.1 发布,Bug 修复版本
- 苞米豆-多数据源启动器 2.0.2 发布:修复 sb2.0 集成 bug
- Spring Boot的gRPC启动器
本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们。
程序员代码面试指南:IT名企算法与数据结构题目最优解
左程云 / 电子工业出版社 / 2015-9 / 79.00元
这是一本程序员面试宝典!书中对IT名企代码面试各类题目的最优解进行了总结,并提供了相关代码实现。针对当前程序员面试缺乏权威题目汇总这一痛点,本书选取将近200道真实出现过的经典代码面试题,帮助广大程序员的面试准备做到万无一失。“刷”完本书后,你就是“题王”!__eol__本书采用题目+解答的方式组织内容,并把面试题类型相近或者解法相近的题目尽量放在一起,读者在学习本书时很容易看出面试题解法之间的联......一起来看看 《程序员代码面试指南:IT名企算法与数据结构题目最优解》 这本书的介绍吧!