摘要: 目前项目中持久化框架使用是mybatis，经过分析后不难发现，多数据源配置需要解决两个问题，一个是由原先的spring经典方式切换到了springboot方式下，多数据源如何配置？有无太大变化？另一个是怎样将多数据源与mybatis的配置关联起来？
前言最近迫于项目需要，笔者踏上了springboot多数据源的配置之旅。之前笔者配置过spring的动态多数据源切换，当时使用的是jdbc template。
目前项目中持久化框架使用是mybatis，经过分析后不难发现，多数据源配置需要解决两个问题，一个是由原先的spring经典方式切换到了springboot方式下，多数据源如何配置？有无太大变化？另一个是怎样将多数据源与mybatis的配置关联起来？
不妨先来看下,单数据源下mybatis如何配置的？
单数据源示例首先要声明一点，项目只是依赖单个数据源时，如果你不介意springboot帮你做事的话，那么恭喜你，你省事儿了！你只需要在项目的属性文件中添加数据源的相关属性配置，springboot会“免费”提供给你一个数据源使用，默认采用的是tomcat jdbc connection pool。
当然你可以拒绝springboot的好意，如果你依赖第三方的连接池技术，你可以配置自己的数据源，那么springboot检测到你自己定义了datasource后，就不会自动配置数据源了。
笔者不能拒绝springboot的好意，所以仅在项目的application.properties中添加了如下属性：
spring.datasource.url=jdbc:mysql://localhost:3306/testspring.datasource.username=rootspring.datasource.password=rootspring.datasource.driver-class-name=com.mysql.jdbc.driverspring.datasource.max-idle=10spring.datasource.max-wait=10000spring.datasource.min-idle=5spring.datasource.initial-size=5spring.datasource.validation-query=select 1spring.datasource.test-on-borrow=falsespring.datasource.test-while-idle=truespring.datasource.time-between-eviction-runs-millis=18800然后笔者创建了一个专门用于配置mybatis的类，如下:@configurationpublic class mybatisspringconfig {@bean(name = "sqlsessionfactory")public sqlsessionfactory sqlsessionfactory(datasource datasource) throws exception {sqlsessionfactorybean factorybean = new sqlsessionfactorybean();factorybean.setdatasource(datasource);factorybean.settypealiasespackage("demo.model");return factorybean.getobject();}[[[@bean](http://my.oschina.net/bean)](http://my.oschina.net/bean)](http://my.oschina.net/bean)public mapperscannerconfigurer mapperscannerconfigurer() { mapperscannerconfigurer mapperscannerconfigurer = new mapperscannerconfigurer(); mapperscannerconfigurer.setbasepackage("demo.repository"); return mapperscannerconfigurer;}}
没错，mybatis在spring中就是可以通过如此的简练配置进而正常工作起来。你无需刻意地去创建mybatis的配置文件，无需刻意地去注册mapper接口及指定对应xml文件的位置，这完全得益于mybatis-spring，它就像一个“粘合剂”，可以很方便地将mybatis和spring“粘合”在一起。
mybatis-spring的配置步骤
不妨先来说下mybatis-spring配置的一般步骤：
配置数据源datasource的bean。
使用datasource配置事务管理器。
使用datasource配置sqlsessionfactory的bean。
配置mapperscannerconfigurer的bean。
这里要求配置事务管理器和sqlsessionfactory的数据源必须是同一个，否则事务管理不起作用。配置mapperscannerconfigurer的目的是自动扫描mapper接口所在的包，自动帮你将mapper接口注册为bean（代理生成接口的实现类），你就可以直接拿来依赖注入了，建议将mapper接口及其对应的xml文件放在同一个包下，这样的话你无需在sqlsessionfactory里指定xml文件的位置了。
ok，到此对比我上面贴出的配置类内容，你可能会发现笔者怎么少了几步？感谢springboot，因为它自动配置了一个datasource，同时它还自动配置了一个事务管理器。所以笔者只配置了sqlsessionfactory和mapperscannerconfigurer。
当然如果看到这里你仍然“执意”要配置自己的数据源，参照下面的多数据源配置说明，抽出来多个中的一个就可以实现自定义单数据源的配置了。
多数据源示例经过上面单数据源的示例，可以说当我们切换到springboot的方式下写代码时，springboot为我们带来了很大的便利，还不影响我们自定义，所以笔者认为，没用使用springboot之前，无论你使用spring怎样的配置，使用springboot之后，不会有阻碍，甚至会比原来更快！
简单说下需要多数据源的场景，笔者参照了一下其他的文章，绝大部分的需要来自于数据库主从方式或读写分离。那么就按照master和slave两个数据源，直接贴出数据源的配置类。
application.properties
datasource.master.url=jdbc:mysql://localhost:3306/masterdatasource.master.username=rootdatasource.master.password=rootdatasource.master.driver-class-name=com.mysql.jdbc.driverdatasource.master.max-idle=10datasource.master.max-wait=10000datasource.master.min-idle=5datasource.master.initial-size=5datasource.master.validation-query=select 1datasource.master.test-on-borrow=falsedatasource.master.test-while-idle=truedatasource.master.time-between-eviction-runs-millis=18800datasource.slave.url=jdbc:mysql://localhost:3306/slavedatasource.slave.username=rootdatasource.slave.password=rootdatasource.slave.driver-class-name=com.mysql.jdbc.driverdatasource.slave.max-idle=10datasource.slave.max-wait=10000datasource.slave.min-idle=5datasource.slave.initial-size=5datasource.slave.validation-query=select 1datasource.slave.test-on-borrow=falsedatasource.slave.test-while-idle=truedatasource.slave.time-between-eviction-runs-millis=18800
master数据源
@configurationpublic class masterconfig {[[[@primary](http://my.oschina.net/primary)](http://my.oschina.net/primary)](http://my.oschina.net/primary)@bean(name = "masterdatasource")@configurationproperties(prefix = "datasource.master")public datasource datasource() { return datasourcebuilder.create().build();}
@primary@bean(name = "mastertransactionmanager")public datasourcetransactionmanager transactionmanager(@qualifier("masterdatasource") datasource datasource) { return new datasourcetransactionmanager(datasource); }}
slave数据源
@configurationpublic class slaveconfig { @bean(name = "slavedatasource") @configurationproperties(prefix = "datasource.slave") public datasource datasource() { return datasourcebuilder.create().build(){ } @bean(name = "slavetransactionmanager") public datasourcetransactionmanager transactionmanager(@qualifier("slavedatasource") datasource datasource) { return new datasourcetransactionmanager(datasource); }}
不难看出两个数据源的配置步骤吧：
在属性文件中配置两个数据源需要用到的属性值，注意起个好点的前缀名称。
构建两个数据源的配置类，当然这不是必须的，愿意堆在一个配置类中未尝不可。
配置类中，配置datasource的bean，记得起个能够标识的name！
配置两个数据源各自对应的事务管理器，别嫌麻烦，否则会给自己埋坑里，记得起个能够标识的name！
配置datasource时，利用@configurationproperties(prefix = "xxx.xxx")可以依靠指定的前缀，在诸多的属性值中“挑选”出数据源依赖的属性，进而完成数据源的构建。
当自己定义了datasource后，springboot就会取消自动配置的动作了。为了各司其职，为每个数据源配置各自的事务管理器，springboot自然也会取消自动配置事务管理器的动作。由于是多个数据源和多个事务管理器，都是一个类型的，你要是不起个区别的名字，任谁都分辨不出来吧？
@primary 有什么作用呢？简单地说，当有两个同一类型的bean，依赖注入时你没有指定name，正常情况下会报错，有两个你要的bean，识别不了。但是 @primary 相当于指定这个bean为默认的，如果你没有指定name，就采用 @primary 标识的bean。
ok，两个数据源的配置配好了，还需要配置各自的mybatis来进行持久化的操作。
mybatis-spring相关配置
mybatis for master
@configuration@mapperscan(basepackages = {"demo.repository.master"}, sqlsessionfactoryref = "mastersqlsessionfactory")public class masterconfig { @primary @bean(name = "masterdatasource") @configurationproperties(prefix = "datasource.master") public datasource datasource() { return datasourcebuilder.create().build(); }@primary@bean(name = "mastertransactionmanager")public datasourcetransactionmanager transactionmanager(@qualifier("masterdatasource") datasource datasource) { return new datasourcetransactionmanager(datasource);}@primary@bean(name = "mastersqlsessionfactory")public sqlsessionfactory sqlsessionfactory(@qualifier("masterdatasource") datasource datasource) throws exception { sqlsessionfactorybean factorybean = new sqlsessionfactorybean(); factorybean.setdatasource(datasource); factorybean.settypealiasespackage("demo.model"); return factorybean.getobject();}}
mybatis for slave
@configuration@mapperscan(basepackages = {"demo.repository.slave"}, sqlsessionfactoryref = "slavesqlsessionfactory")public class slaveconfig {@bean(name = "slavedatasource")@configurationproperties(prefix = "datasource.slave")public datasource datasource() {return datasourcebuilder.create().build();}@bean(name = "slavetransactionmanager")public datasourcetransactionmanager transactionmanager(@qualifier("slavedatasource") datasource datasource) {return new datasourcetransactionmanager(datasource);}@bean(name = "slavesqlsessionfactory")public sqlsessionfactory basicsqlsessionfactory(@qualifier("slavedatasource") datasource basicdatasource) throws exception {sqlsessionfactorybean factorybean = new sqlsessionfactorybean();factorybean.setdatasource(basicdatasource);factorybean.settypealiasespackage("demo.model");return factorybean.getobject();}}
这里需要强调几个地方：
细心人会发现上面的配置类中，少了mapperscannerconfigurer的bean配置，改用了@mapperscan注解。其实两者的作用是一样的，但是@mapperscan比较新，稍后会做解释为什么它比较新。
由于两个数据源的原因，引出了两套sqlsessionfactory的配置，所以@mapperscan中需要指明依赖的是哪个sqlsessionfactory，“sqlsessionfactoryref”对应就是sqlsessionfactory的name属性。
@mapperscan会将扫描的mapper接口代理生成实现类，并自动注册为bean。由于两个数据源的配置类中都有@mapperscan注解，为了避免造成冲突和排错时的困扰，猛烈提醒，两个数据源的配置，mybatis对应的mapper接口及对应xml文件也构建两套，最好接口名上也做些区分。model类使用同一套倒是没什么影响。所以你会看到上面的配置中，@mapperscan中basepackages指向的是两个包路径。
好了，来解释下@mapperscan为何比较新，并且笔者推荐使用@mapperscan。
首先@mapperscan要求的mybatis-spring版本比较新，说明它是新推出的特性。
其次@mapperscan要比配置mapperscannerconfigurer的bean要简练的多，代码量上就看得出来。
最后，@mapperscan中的basepackageclasses属性是mapperscannerconfigurer所没有的。并且笔者用到了这个basepackageclasses属性，所以这里强力推荐使用@mapperscan注解。
多聊一些，描述下笔者为何会用到@mapperscan中的basepackageclasses属性吧，况且与上述示例中的basepackages有何区别呢？
上面提到了多数据源的一般场景，笔者的不同。笔者的项目中划分了n个子模块，每个子模块有各自的数据库，现在需要每个子模块共享一个公共信息的数据库。
从代码上来说，由于各个子模块依赖的公共信息数据库-数据源、mapper接口和xml映射文件是相同的，笔者希望将这些类和文件抽离到maven的一个公共module（最后会打包为一个jar文件）中，供其他n个子模块依赖使用，这样可以避免重复代码嘛。
笔者这么做之后，发现配置mapperscannerconfigurer的basepackages找不到mapper接口所在的包路径，因为笔者是在子模块中配置的mapperscannerconfigurer，它自然会在子模块的结构中去寻找指定的包路径，是mapper接口被笔者放到了公共的module中，所以是找不到的！
不过还好在@mapperscan中发现了basepackageclasses属性，它会“接受”你指定的mapper接口的全名。再次提醒，记得把xml映射文件和mapper接口放在一起，mybatis-spring会帮你做关联。
以上就是springboot如何配置多数据源的详细内容。