{"id":14973050,"url":"https://github.com/penggle/mds-spring-boot","last_synced_at":"2026-01-31T03:02:26.274Z","repository":{"id":37635146,"uuid":"496567034","full_name":"penggle/mds-spring-boot","owner":"penggle","description":"A SpringBoot2-based full-scene supported multi-datasource framework, supporting Spring-JDBC、Mybatis, MyBatis-Plus, MyBatis-Tiny, ShardingSphere, Mycat etc","archived":false,"fork":false,"pushed_at":"2022-06-12T11:04:36.000Z","size":110,"stargazers_count":1,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-10T12:58:16.047Z","etag":null,"topics":["multi-datasource","mybatis","mybatis-plus","mybatis-spring-boot-starter","mybatis-tiny","mycat","shardingsphere","springboot"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/penggle.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-05-26T09:59:02.000Z","updated_at":"2022-11-02T04:53:42.000Z","dependencies_parsed_at":"2022-08-18T16:50:17.028Z","dependency_job_id":null,"html_url":"https://github.com/penggle/mds-spring-boot","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/penggle/mds-spring-boot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/penggle%2Fmds-spring-boot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/penggle%2Fmds-spring-boot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/penggle%2Fmds-spring-boot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/penggle%2Fmds-spring-boot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/penggle","download_url":"https://codeload.github.com/penggle/mds-spring-boot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/penggle%2Fmds-spring-boot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28927770,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-31T02:59:34.861Z","status":"ssl_error","status_checked_at":"2026-01-31T02:59:05.369Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["multi-datasource","mybatis","mybatis-plus","mybatis-spring-boot-starter","mybatis-tiny","mycat","shardingsphere","springboot"],"created_at":"2024-09-24T13:48:00.695Z","updated_at":"2026-01-31T03:02:26.256Z","avatar_url":"https://github.com/penggle.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mds-spring-boot\n\n## 基本简介\n\nmds-spring-boot是什么？\n\nmds-spring-boot是一个基于SpringBoot2.x的、全场景支持的、多数据源框架，支持Spring-JDBC、Mybatis、Mybatis-Plus、Mybatis-Tiny、ShardingSphere、Mycat等，支持本地事务及完整的基于Spring-@Transactional声明式事务（及事务传播特性）。\n\n\n\n## 特性及限制\n\n全场景支持：\n\n- ##### 支持单纯的Spring-JDBC原生用法（即不使用其他ORM框架）\n\n  - Spring-JDBC（`spring-boot-starter-jdbc`）是最基本的支持\n  - SpringBoot-Mybatis（`mybatis-spring-boot-starter`）是可选支持，即使用时需要手动引入`mybatis-spring-boot-starter`依赖\n\n- ##### 支持单纯的Mybatis原生用法（即不使用Mybatis-Plus、Mybatis-Tiny等懒人框架）\n- ##### 支持MybatisPlus、MybatisTiny等懒人框架用法\n\n- ##### 支持本地事务，不支持分布式事务\n\n  - 【支持本地事务】即支持在同一个JVM中通过JDBC操作多个数据源(数据库)，保证其正确的Spring事务传播特性\n\n- ##### 支持传统单库多数据源场景，这也是最常见的\n\n- ##### 支持客户端分库分表的多数据源场景\n\n  - 【客户端分库分表】即诸如ShardingSphere-JDBC这样的客户端(嵌入在应用内部的)分库分表框架\n  - 这种情况下还支持混用，即存在单库数据源(例如项目中大多数表不需要分库分表，其不属于ShardingSphere管理，而属于应用本身来管理)，也存在ShardingSphereDataSource(比如项目中有几个表确实需借助ShardingSphere来做分库分表)，这种混用的场景在实际项目中也非常常见。[示例代码](https://github.com/penggle/mds-spring-boot/tree/main/mds-spring-boot-examples/mds-spring-boot-example1/mds-spring-boot-example1-csmds)就是这种混用方式\n\n- ##### 支持服务端分库分表多数据源场景\n\n  - 【服务端分库分表】即诸如ShardingSphere-Proxy、Mycat这样的服务端(伪装成一个数据库Server)分库分表中间件\n  - 这种情况下跟传统的单库多数据源场景一样了，因为作为应用的客户端看来，ShardingSphere-Proxy、Mycat这样的分库分表中间件就是一个数据库Server\n\n- ##### 再回头看看，是不是支持全场景?（基本上是全场景了吧）\n\n\n\n## 快速入门\n\n\u003e **Talk is cheap，show me the code！**\n\n- ##### 第一步引入依赖\n\n  ```xml\n  \u003cdependency\u003e\n      \u003cgroupId\u003eio.github.penggle\u003c/groupId\u003e\n      \u003cartifactId\u003emds-spring-boot-starter\u003c/artifactId\u003e\n      \u003c!-- 版本说明：2.1指的是基于mybatis-spring-boot-starter 2.1.x版本的意思 --\u003e\n      \u003cversion\u003e2.1\u003c/version\u003e\n  \u003c/dependency\u003e\n  \n  \u003c!-- 当然mybatis-spring-boot-starter是需要手动引入的 --\u003e\n  \u003cdependency\u003e\n      \u003cgroupId\u003eorg.mybatis.spring.boot\u003c/groupId\u003e\n      \u003cartifactId\u003emybatis-spring-boot-starter\u003c/artifactId\u003e\n      \u003cversion\u003e2.1.4\u003c/version\u003e\n  \u003c/dependency\u003e\n  ```\n\n- 在SpringBoot启动类上启用多数据源支持\n\n  ```java\n  @SpringBootApplication\n  @EnableMultiDataSource({@NamedDatabase(\"product\"), @NamedDatabase(\"order\")})\n  public class GmdsExample1Application {\n  \n      public static void main(String[] args) {\n          SpringApplication.run(GmdsExample1Application.class, args);\n      }\n  \n  }\n  ```\n\n- XxxMapper接口上标记所属数据源\n\n  ```java\n  @NamedDatabase(\"product\")\n  public interface ProductMapper {\n  \t...\n  }\n  \n  @NamedDatabase(\"order\")\n  public interface MainOrderMapper {\n  \t...\n  }\n  \n  @NamedDatabase(\"order\")\n  public interface OrderLineMapper {\n  \t...\n  }\n  ```\n  \n- application.yml配置\n\n  - springboot-datasource配置（**必要配置**）\n\n    ```yaml\n    spring:\n        #数据源配置\n        datasource:\n            #公共连接池配置\n            hikari:\n                #最小空闲连接数量\n                minimum-idle: 5\n                #空闲连接存活最大时间，默认600000(10分钟)\n                idle-timeout: 180000\n                #连接池最大连接数，默认是10\n                maximum-pool-size: 10\n                #池中连接的默认自动提交行为，默认值true\n                auto-commit: true\n                #池中连接的最长生命周期，0表示无限生命周期，默认1800000(30分钟)\n                max-lifetime: 1800000\n                #等待来自池的连接的最大毫秒数，默认30000(30秒)\n                connection-timeout: 30000\n                #连接测试语句\n                connection-test-query: SELECT 1\n            #商品库配置(逻辑名称)\n            product:\n                username: root\n                password: 123456\n                url: jdbc:mysql://127.0.0.1:3306/ec_product?useUnicode=true\u0026characterEncoding=utf-8\u0026allowMultiQueries=true\u0026serverTimezone=GMT%2B8\u0026useSSL=false\u0026rewriteBatchedStatements=true\u0026useCursorFetch=true\n            #订单库配置(逻辑名称)\n            order:\n                username: root\n                password: 123456\n                url: jdbc:mysql://127.0.0.1:3306/ec_order?useUnicode=true\u0026characterEncoding=utf-8\u0026allowMultiQueries=true\u0026serverTimezone=GMT%2B8\u0026useSSL=false\u0026rewriteBatchedStatements=true\u0026useCursorFetch=true\n    ```\n\n  - mybatis-spring-boot-starter模块配置（**可选配置**）\n\n    ```yaml\n    #mybatis-springboot配置\n    mybatis:\n        config-location: classpath:config/mybatis/mybatis-config.xml\n        mapper-locations: classpath*:com/penglecode/codeforce/mybatismds/examples/**/*Mapper.xml\n        type-aliases-package: com.penglecode.codeforce.mybatismds.examples\n        type-aliases-super-type: com.penglecode.codeforce.common.domain.DomainObject\n        #商品库的Mybatis特殊配置\n        product:\n            config-location: classpath:config/mybatis/mybatis-config.xml\n            mapper-locations: classpath*:com/penglecode/codeforce/mybatismds/examples/product/**/*Mapper.xml\n            type-aliases-package: com.penglecode.codeforce.mybatismds.examples\n            type-aliases-super-type: com.penglecode.codeforce.common.domain.DomainObject\n    ```\n\n- 好了，配置完毕，启动项目后，自动注册如下bean到Spring应用上下文中去：\n\n  - {database}DataSourceProperties：指定数据库的`org.springframework.boot.autoconfigure.jdbc.DataSourceProperties`\n  - {database}DataSource：指定数据库的`javax.sql.DataSource`\n  - {database}JdbcTemplate：指定数据库的`org.springframework.jdbc.core.JdbcTemplate`\n  - {database}TransactionManager：指定数据库的`org.springframework.transaction.PlatformTransactionManager`\n  - {database}SqlSessionFactory：指定数据库的`org.apache.ibatis.session.SqlSessionFactory`\n  - {database}SqlSessionTemplate：指定数据库的`org.mybatis.spring.SqlSessionTemplate`\n  - {database}XxxMapper：指定数据库的各个实体的XxxMapper接口代理\n  - allTransactionManager：默认的全局多数据源事务管理器`org.springframework.data.transaction.ChainedTransactionManager`\n\n- 本地事务使用示例：\n\n  碍于篇幅使用精简代码，具体代码见[示例代码](https://github.com/penggle/mds-spring-boot/tree/main/mds-spring-boot-examples/mds-spring-boot-example1/mds-spring-boot-example1-gmds)\n\n  - 测试`Propagation.REQUIRED`传播特性（[示例代码](https://github.com/penggle/mds-spring-boot/blob/main/mds-spring-boot-examples/mds-spring-boot-example1/mds-spring-boot-example1-common/src/main/java/com/penglecode/codeforce/mybatismds/examples/order/app/service/impl/OrderAppServiceImpl.java)）\n\n    \u003e 由于商品表的库存字段是UNSIGNED，多运行几次会导致扣库存失败，此时可以看看商品表与订单表是否全部回滚了事务\n\n    ```java\n    @Transactional(transactionManager=\"product,order\", propagation=Propagation.REQUIRED, rollbackFor=Exception.class)\n    //@Transactional(transactionManager=\"productTransactionManager,order\", propagation=Propagation.REQUIRED, rollbackFor=Exception.class)\n    //@Transactional(transactionManager=\"all\", propagation=Propagation.REQUIRED, rollbackFor=Exception.class)\n    //@Transactional(propagation=Propagation.REQUIRED, rollbackFor=Exception.class)\n    //在本例中以上几种@Transactional的写法都是等效的，但是建议：用到那几个库就指明其事务管理器的名称或别名\n    public void createOrder1(Order order) {\n        initOrder(order);\n        mainOrderService.createMainOrder(order); //创建主订单\n        orderLineService.createOrderLines(order.getOrderLines()); //创建订单明细\n        for(OrderLine orderLine : order.getOrderLines()) {\n            //decrProductInventory1()方法上设置的事务传播特性是Propagation.REQUIRED\n            productService.decrProductInventory1(orderLine.getProductId(), orderLine.getQuantity()); //扣库存\n        }\n    }\n    ```\n\n    \n\n  - 测试`Propagation.REQUIRES_NEW`传播特性（[示例代码](https://github.com/penggle/mds-spring-boot/blob/main/mds-spring-boot-examples/mds-spring-boot-example1/mds-spring-boot-example1-common/src/main/java/com/penglecode/codeforce/mybatismds/examples/order/app/service/impl/OrderAppServiceImpl.java)）\n\n    ```java\n    @Transactional(transactionManager=\"product,order\", propagation=Propagation.REQUIRED, rollbackFor=Exception.class)\n    //@Transactional(transactionManager=\"productTransactionManager,order\", propagation=Propagation.REQUIRED, rollbackFor=Exception.class)\n    //@Transactional(transactionManager=\"all\", propagation=Propagation.REQUIRED, rollbackFor=Exception.class)\n    //@Transactional(propagation=Propagation.REQUIRED, rollbackFor=Exception.class)\n    //在本例中以上几种@Transactional的写法都是等效的，但是建议：用到那几个库就指明其事务管理器的名称或别名\n    public void createOrder2(Order order) {\n        initOrder(order);\n        mainOrderService.createMainOrder(order); //创建主订单\n        orderLineService.createOrderLines(order.getOrderLines()); //创建订单明细\n        for(OrderLine orderLine : order.getOrderLines()) {\n            //decrProductInventory2()方法上设置的事务传播特性是Propagation.REQUIRES_NEW\n            productService.decrProductInventory2(orderLine.getProductId(), orderLine.getQuantity()); //扣库存\n        }\n        Assert.isTrue(order.getOrderId().equals(System.currentTimeMillis()), \"我不是故意的：测试Propagation.REQUIRES_NEW\");\n    }\n    ```\n\n\n\n## 使用示例\n\n- ##### 动态注册生命周期\n\n  mds-spring-boot框架提供了一个钩子接口：[MdsComponentsRegistrationLifecycle](https://github.com/penggle/mds-spring-boot/blob/main/mds-spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/mybatis/MdsComponentsRegistrationLifecycle.java)\n\n  ```java\n  public interface MdsComponentsRegistrationLifecycle {\n  \n      /**\n       * 在动态注册MDS组件之前做一些事件\n       *\n       * @param mdsAnnotationMetadata     - 可以取到{@link EnableMultiDataSource}注解的元数据信息\n       * @param registry                  - Spring Bean注册器\n       */\n      default void beforeMdsComponentsRegistered(AnnotationMetadata mdsAnnotationMetadata, BeanDefinitionRegistry registry) {\n  \n      }\n  \n      /**\n       * 在MDS之JDBC组件(DataSource、JdbcTemplate、TransactionManager)动态注册完毕之后做一些事情\n       *\n       * @param mdsAnnotationMetadata\n       * @param registry\n       * @param mdsComponentBeans\n       */\n      default void onMdsJdbcComponentsRegistered(AnnotationMetadata mdsAnnotationMetadata, BeanDefinitionRegistry registry, MdsComponentBeans mdsComponentBeans) {\n  \n      }\n  \n      /**\n       * 在MDS之Mybatis组件(SqlSessionFactory、SqlSessionTemplate、XxxMapper)动态注册完毕之后做一些事情\n       *\n       * @param mdsAnnotationMetadata\n       * @param registry\n       * @param mdsComponentBeans\n       */\n      default void onMdsMybatisComponentsRegistered(AnnotationMetadata mdsAnnotationMetadata, BeanDefinitionRegistry registry, MdsComponentBeans mdsComponentBeans) {\n  \n      }\n  \n      /**\n       * 在所有MDS组件动态注册完毕之后做一些事情\n       *\n       * @param mdsAnnotationMetadata     - 可以取到{@link EnableMultiDataSource}注解的元数据信息\n       * @param registry                  - Spring Bean注册器\n       * @param mdsComponentBeans         - 已动态注册的MDS组件\n       */\n      default void afterMdsComponentsRegistered(AnnotationMetadata mdsAnnotationMetadata, BeanDefinitionRegistry registry, MdsComponentBeans mdsComponentBeans) {\n  \n      }\n  \n  }\n  ```\n\n  基于它，我们能干很多事情，我们可以自定义一个实现，并注册到Spring上下文中，这在遇到外部数据源的时候特别有用，例如\"[基于ShardingSphere-JDBC的示例](https://github.com/penggle/mds-spring-boot/blob/main/mds-spring-boot-examples/mds-spring-boot-example1/mds-spring-boot-example1-csmds/src/main/java/com/penglecode/codeforce/mybatismds/examples/common/config/ShardingSphereConfiguration.java)\"\n\n- ##### 外部数据源支持\n\n  什么叫外部数据源？即数据源不是通过约定的基于如下多数据源配置自动构建出来的情况：\n\n  ```yaml\n  spring:\n      datasource:\n          #db1库配置(逻辑名称)\n          db1:\n              username: root\n              password: 123456\n              url: jdbc:mysql://127.0.0.1:3306/myapp_db1\n  ```\n\n  ```java\n  @SpringBootApplication\n  @EnableMultiDataSource({@NamedDatabase(\"db1\"), @NamedDatabase(\"db2\")})\n  public class MyApplication {\n  \n      public static void main(String[] args) {\n          SpringApplication.run(MyApplication.class, args);\n      }\n  \n  }\n  ```\n\n  \u003cu\u003e此时基于约定的配置，并没有发现db2的yaml配置，此时mds-spring-boot框架会去Spring上下文中找名字为db2DataSource的bean，如果没有则会报错。此时db2就称之为**外部数据源**\u003c/u\u003e\n\n  具体请看下面的基于ShardingSphere-JDBC的示例\n\n- ##### 基于ShardingSphere-JDBC的示例\n\n  首先为了兼顾灵活性，mds-spring-boot框架内部并没有任何特殊处理ShardingSphere的地方，对于mds-spring-boot框架来说，ShardingSphereDataSource实例是一个**外部数据源**，仅要求其在运行时存在于Spring上下文中即可。\n\n  由于mds-spring-boot框架动态注册数据访问层bean的时机太早了，以至于ShardingSphere的自动配置类`org.apache.shardingsphere.spring.boot.ShardingSphereAutoConfiguration`、`org.apache.shardingsphere.sharding.spring.boot.ShardingRuleSpringBootConfiguration`都还没来得及注册到Spring上下文中，此时通过实现MdsComponentsRegistrationLifecycle来在Spring启动的早期阶段勾起对上面两个配置类的加载与自动配置工作。这个里面水很深（需要深入理解AbstractApplicationContext#refresh()方法和ConfigurationClassPostProcessor的工作机制）具体可见[基于ShardingSphere-JDBC的示例](https://github.com/penggle/mds-spring-boot/blob/main/mds-spring-boot-examples/mds-spring-boot-example1/mds-spring-boot-example1-csmds/src/main/java/com/penglecode/codeforce/mybatismds/examples/common/config/ShardingSphereConfiguration.java)\n\n- ##### 基于MybatisTiny的示例\n\n  [MybatisTiny](https://github.com/penggle/mybatis-tiny)是本人的一个与MybatisPlus类似的框架，基于MybatisTiny的示例见[这里](https://github.com/penggle/mds-spring-boot/tree/main/mds-spring-boot-examples/mds-spring-boot-example2)\n\n- ##### 基于MybatisPlus的示例\n\n  基于MybatisPlus的示例见[这里](https://github.com/penggle/mds-spring-boot/tree/main/mds-spring-boot-examples/mds-spring-boot-example3)\n\n- ##### 示例所使用的数据库及表结构\n\n  所有示例所使用的数据库均为MySQL数据库，表结构见[这里](https://github.com/penggle/mds-spring-boot/tree/main/mds-spring-boot-examples/schemas)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpenggle%2Fmds-spring-boot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpenggle%2Fmds-spring-boot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpenggle%2Fmds-spring-boot/lists"}