{"id":15102604,"url":"https://github.com/awakebymyself/dynamicsource-springbootstarter","last_synced_at":"2026-01-19T03:33:36.033Z","repository":{"id":57719557,"uuid":"143947978","full_name":"awakebymyself/dynamicsource-springbootstarter","owner":"awakebymyself","description":"基于springboot,mybatis 的动态数据源配置，支持Disconf托管的配置类, 多读多写自动适用","archived":false,"fork":false,"pushed_at":"2018-09-03T15:49:25.000Z","size":152,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-10T22:44:38.676Z","etag":null,"topics":["disconf-client","dynamic-datasource","springboot","springboot-mybatis"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/awakebymyself.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-08-08T02:01:59.000Z","updated_at":"2022-03-13T13:28:14.000Z","dependencies_parsed_at":"2022-09-02T12:31:22.013Z","dependency_job_id":null,"html_url":"https://github.com/awakebymyself/dynamicsource-springbootstarter","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awakebymyself%2Fdynamicsource-springbootstarter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awakebymyself%2Fdynamicsource-springbootstarter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awakebymyself%2Fdynamicsource-springbootstarter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awakebymyself%2Fdynamicsource-springbootstarter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/awakebymyself","download_url":"https://codeload.github.com/awakebymyself/dynamicsource-springbootstarter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247332524,"owners_count":20921852,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["disconf-client","dynamic-datasource","springboot","springboot-mybatis"],"created_at":"2024-09-25T19:03:07.979Z","updated_at":"2026-01-19T03:33:36.028Z","avatar_url":"https://github.com/awakebymyself.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# dynamicsource-springbootstarter 基于springboot 的动态数据源配置器\n\n\n\n**背景及痛点：项目中发现使用mybatis的时候配置多数据源都是通过多套配置(多套数据源配置多个sqlSessionFactory,sqlSessionTemplate等等...)，不仅繁琐而且不易于维护，所有试想结合springboot加少许的约定实现一个动态数据源走天下的目的。一般来讲我们的数据源配置信息都是配置在xxx.properties上，目前公司是基于disconf进行配置托管， 此动态数据源便适用于上述的场景**\n\n**特点：目前市面上的自动配置一般都只支持一读一写或者多读一写，难免还会引发重复配置的问题, 此项目支持多读多写的数据源自动配置！**\n \n**Email: lzgsshen@163.com**\n\n\n## 场景一：Disconf client 托管我们的数据源配置信息\n应用程序在使用Disconf进去配置的时候都是通过配置文件的形式进行配置，如下：\n```java\n@Component\n@DisconfFile(fileName = \"db.properties\")\npublic class DbConfig {\n\n    private String masterWriteDriver;\n    private String masterWriteUrl;\n    private String masterWriteUser;\n    private String masterWritePassword;\n\n    private String slaveReadDriver;\n    private String slaveReadUrl;\n    private String slaveReadUser;\n    private String slaveReadPassword;\n\n    private String activityWriteDriver;\n    private String activityWriteUrl;\n    private String activityWriteUser;\n    private String activityWritePassword;\n\n    private String activityReadDriver;\n    private String activityReadUrl;\n    private String activityReadUser;\n    private String activityReadPassword;\n\n    @DisconfFileItem(name = \"activityWriteDriver\")\n    public String getActivityWriteDriver() {\n        return activityWriteDriver;\n    }\n\n    @DisconfFileItem(name = \"activityWriteUrl\")\n    public String getActivityWriteUrl() {\n        return activityWriteUrl;\n    }\n\n    @DisconfFileItem(name = \"activityWriteUser\")\n    public String getActivityWriteUser() {\n        return activityWriteUser;\n    }\n\n    @DisconfFileItem(name = \"activityWritePassword\")\n    public String getActivityWritePassword() {\n        return activityWritePassword;\n    }\n\n    @DisconfFileItem(name = \"activityReadDriver\")\n    public String getActivityReadDriver() {\n        return activityReadDriver;\n    }\n\n    @DisconfFileItem(name = \"activityReadUrl\")\n    public String getActivityReadUrl() {\n        return activityReadUrl;\n    }\n\n    @DisconfFileItem(name = \"activityReadUser\")\n    public String getActivityReadUser() {\n        return activityReadUser;\n    }\n\n    @DisconfFileItem(name = \"activityReadPassword\")\n    public String getActivityReadPassword() {\n        return activityReadPassword;\n    }\n\n    @DisconfFileItem(name = \"slaveReadDriver\")\n    public String getSlaveReadDriver() {\n        return slaveReadDriver;\n    }\n\n    @DisconfFileItem(name = \"slaveReadUrl\")\n    public String getSlaveReadUrl() {\n        return slaveReadUrl;\n    }\n\n    @DisconfFileItem(name = \"slaveReadUser\")\n    public String getSlaveReadUser() {\n        return slaveReadUser;\n    }\n\n    @DisconfFileItem(name = \"slaveReadPassword\")\n    public String getSlaveReadPassword() {\n        return slaveReadPassword;\n    }\n\n    @DisconfFileItem(name = \"masterWriteDriver\")\n    public String getMasterWriteDriver() {\n        return masterWriteDriver;\n    }\n\n    @DisconfFileItem(name = \"masterWriteUrl\")\n    public String getMasterWriteUrl() {\n        return masterWriteUrl;\n    }\n\n    @DisconfFileItem(name = \"masterWriteUser\")\n    public String getMasterWriteUser() {\n        return masterWriteUser;\n    }\n\n    @DisconfFileItem(name = \"masterWritePassword\")\n    public String getMasterWritePassword() {\n        return masterWritePassword;\n    }\n```\n\n以上是当前应该程序背景， 使用此starter的方式：\n首先配置启动自动配置选项，在`application.properties`中增加:\n```java\n// 要进行动态数据源配置的service 方法, 拦截数据库操作\ndynamic.ds.pointCut= execution (* com.lzg.xxx.service..*.*(..))\n// 启用自动配置\ndynamic.ds.enable=true\n```\n配置数据源注册测类`DynamicDsRegister`\n`JAVA配置:`\n```java\n    @Bean\n    public DynamicDsRegister register() {\n        return new DynamicDsRegister(xxx.class); //注意这边的xxx.class及为上面disconf托管的配置类！\n    }\n```\n`Xml 配置:`\n\n```xml\n\n\u003cbean id = \"dunamicDsRegister\" class = \"DynamicDsRegister\"\u003e\n    \u003cproperty name = \"dbClass\" value = \"xxx.xxx.xx\"/\u003e\n\u003c/bean\u003e\n```\n\n**这就是全部所需的配置了，快乐就完事了，同时关于disconf托管的配置类有几处默认的约定需要遵守，如下：**\n\n在配置数据源的时候我们通常会配置`Driver` `Url` `User` `Password`， 这些为配置的保留字，作为字段名的后缀,首字母大写,  如果这个数据源\n是写数据源，那么字段命名为`xxxWriteUrl`, 同理如果为读数据源，那么命名为`xxxReadUrl`. 在应该初始化完成的时候，对应的写数据源名称为\n`xxxWrite`, 读数据源名称为`xxxRead`\n\n#####对于上面的DbConfig类:\n\n```java\n我们的写数据源有：masterWrite 和 activityWrite 两个\n\n读数据源有：slaveRead  和 activityRead 两个\n\n```\n\n####下面讨论多数据源使用的场景\n 1. 一写一读或者多读（同库）：\n  ```java\n  private String xxxWriteUrl, xxxWriteDriver... 写配置\n\n  private String xxxReadUrl,xxxReadUser... 读配置1\n\n  private String ***ReadUrl,***ReadUser... 读配置2\n  ```\n方法不添加注解的时候根据方法名前缀判断是否走读库(query|select|find|get)开头，走读库的时候使用轮询算法，顺序使用多读源\n\n\n 2. 多写多读（不同库）:\n ```java\n private String xxxWriteUrl, xxxWriteDriver... 写配置1 对应数据源名称为xxxWrite\n private String ***WriteUrl, ***WriteDriver... 写配置2  对应数据源名称为***Write\n\n private String xxxReadUrl,xxxReadUser... 读配置1 对应数据源名称为xxxRead\n private String ***ReadUrl,***ReadUser... 读配置2 对应数据源名称为***Read\n ```\n\n对于不同库多写多读的情况，无法区别使用哪一个数据源, 需要组合注解一起使用\n可以指定程序默认使用的读写库, 在类上面添加注解:\n```java\n\n@DefaultDataSource(write = \"xxxWrite\", read = \"xxxRead\")\npublic class DbConfig {...}\n```\n这样如果我们没有在方法层面指定数据源，那么就会使用默认的数据源。\n\n指定数据源所需要的是在方法层面通过注解指定数据源名称：\n```java\n  @DynamicDS(\"xxxWrite\") 指定需要使用的数据源名称\n    public String hello() {\n        TicketLogPo ticketLogPo = logPoMapper.selectByPrimaryKey(1);\n\n        return ticketLogPo.toString();\n    }\n\n```\n\n\n\n\n## 场景二：基于springboot 配置文件进行的数据源配置\n\n**许多应该的配置并不是基于Disconf去托管数据库配置文件的，那么可以使用这种配置文件的方式去启动。**\n\n\n**配置方式支持类路径添加或者从外部文件系统加载**\n\n`内部添加：`\n 在`resources`目录下面添加`dynamic.properties`, 名称约定为这个， 配置数据源如下：\n\n ```java\naWriteUrl=aWriteUrl\naWriteUser=aUser\naWritePassword=aPassword\naWriteDriver=aDriver\n\naReadUrl=abc\naReadUser=aReadUser\naReadPassword=aReadPassword\naReadDriver=aReadDriver\n\nbWriteUrl=bWriteUrl\nbWriteUser=bWriteUser\nbWritePassword=bWritePassword\nbWriteDriver=bWriteDriver\n\nbReadUrl=bReadUrl\nbReadUser=bReadUser\nbReadPassword=bReadReadPassword\nbReadDriver=bReadDriver\n\nbSecondReadUrl=bSecondReadUrl\nbSecondReadUser=bSecondReadUser\nbSecondReadPassword=bSecondReadPassword\nbSecondReadDriver=bSecondReadDriver\n\n ```\n\n读数据源有：`aRead`, `bRead`, `bSecondRead`\n写数据源有：`aWrite`, `bWrite`\n\n\n`从外部添加：`\n可以在程序启动的时候知道外部文件的路径`System.setProperty(\"dynamic.path\", \"xxxpath\")` 或者jar运行是设置`-Ddynamic.path=xxxpth`即可\n\n\n\n**具体使用多数据源的场景**\n 请参考上面Disconf场景说明，唯一一点区别就是在设置默认读写数据源的时候我们没有配置类可以添加注解了，那么我们需要在\n `springboot` 的默认的配置文件`application.properties`中添加配置:\n\n ```xml\n dynamic.ds.defaultWrite=xxxWrite\n\n dynamic.ds.defaultWrite=xxxRead\n\n ```\n\n\n###综上两个不同的场景只是在配置数据源上会区别，其他需要的配置几乎一致， 简单易用可维护。\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fawakebymyself%2Fdynamicsource-springbootstarter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fawakebymyself%2Fdynamicsource-springbootstarter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fawakebymyself%2Fdynamicsource-springbootstarter/lists"}