spring boot约定优于配置的思想让我们的开发更加专注,mybatis plus让orm开发更加有效率。MyBatis-Plus(简称 MP)是一个 MyBatis 的增强工具,在 MyBatis 的基础上只做增强不做改变,为简化开发、提高效率而生。
接下来我们开始整合spring boot使用。首先创建spring boot项目工程,基于2.1.4版本具体可以参考我的GitHub。mybatis-plus模块。地址:https://github.com/UniqueDong/springboot-study
在此之前我们通过maven来管理依赖
拥有 Java 开发环境以及相应 IDE
熟悉 Spring Boot
熟悉 Maven
pom依赖如下所示:里面新加了dynamic-datasource-spring-boot-starter主要用来数据源动态切换,或者读写分离。
网上关于动态数据源的切换的文档有很多,核心只有两种。
构建多套环境,优势是方便控制也容易集成一些简单的分布式事务,缺点是非动态同时代码量较多,配置难度大。
基于spring提供原生的
AbstractRoutingDataSource
,参考一些文档自己实现切换。
如果你的数据源较少,场景不复杂,选择以上任意一种都可以。如果你需要更多特性,请尝试本动态数据源。
数据源分组,适用于多种场景 纯粹多库 读写分离 一主多从 混合模式。
简单集成Druid数据源监控多数据源,简单集成Mybatis-Plus简化单表,简单集成P6sy格式化sql,简单集成Jndi数据源。
简化Druid和HikariCp配置,提供全局参数配置。
提供自定义数据源来源(默认使用yml或properties配置)。
项目启动后能动态增减数据源。
使用spel动态参数解析数据源,如从session,header和参数中获取数据源。(多租户架构神器)
多层数据源嵌套切换。(一个业务ServiceA调用ServiceB,ServiceB调用ServiceC,每个Service都是不同的数据源)
使用正则匹配或spel表达式来切换数据源(实验性功能)。
#劣势
不能使用多数据源事务(同一个数据源下能使用事务),网上其他方案也都不能提供。
如果你需要使用到分布式事务,那么你的架构应该到了微服务化的时候了。
如果呼声强烈,项目达到800 star,作者考虑集成分布式事务。
PS: 如果您只是几个数据库但是有强烈的需求分布式事务,建议还是使用传统方式自己构建多套环境集成atomic这类,网上百度很多。
#约定
本框架只做 切换数据源 这件核心的事情,并不限制你的具体操作,切换了数据源可以做任何CRUD。
配置文件所有以下划线
_
分割的数据源 首部 即为组的名称,相同组名称的数据源会放在一个组下。切换数据源即可是组名,也可是具体数据源名称,切换时默认采用负载均衡机制切换。
默认的数据源名称为 master ,你可以通过spring.datasource.dynamic.primary修改。
方法上的注解优先于类上注解
同时我使用了maven的module概念。将myabtis plus模块放在一个父类pom管理的工程下
所以spring boot的依赖师门使用如下方式
<dependencyManagement>
<dependencies>
<dependency>
<!-- Import dependency management from Spring Boot -->
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-dependencies</artifactId>
<version>2.1.4.RELEASE</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.18.2</version>
<optional>true</optional>
</dependency>
</dependencies>
</dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>3.1.0</version>
</dependency>
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>dynamic-datasource-spring-boot-starter</artifactId>
<version>2.5.4</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>${mysql.version}</version>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
其对应的数据库 Schema 脚本如下:
``
DROP TABLE IF EXISTS vip_account;
CREATE TABLE vip_account
(
id BIGINT(20) NOT NULL COMMENT '主键ID',
username VARCHAR(30) NULL DEFAULT NULL COMMENT '姓名'
PRIMARY KEY (id)
);
我们使用yaml格式的配置文件,配置如下:
server:
servlet:
context-path: /mybatis
port: 9002
spring:
application:
name: mybatis-plus
datasource:
# 读写分离
dynamic:
hikari:
driver-class-name: com.mysql.jdbc.Driver
datasource:
master:
username: root
password: 123456
driver-class-name: com.mysql.jdbc.Driver
url: jdbc:mysql://localhost:3306/vip?useUnicode=true&characterEncoding=utf8&useSSL=false
slave:
username: root
password: 123456
driver-class-name: com.mysql.jdbc.Driver
url: jdbc:mysql://localhost:3306/vip?useUnicode=true&characterEncoding=utf8&useSSL=false
# mybatis plus配置
mybatis-plus:
global-config:
db-config:
id-type: auto
# 定义我们的mapper.xml文件路径
mapper-locations: classpath:/mapper/**/*Mapper.xml
type-aliases-package: zero.springboot.study.mybatisplus.domain
configuration:
# 自动将数据库字段的下划线的下一个字母转驼峰,比如user_name 转为userName
map-underscore-to-camel-case: true
这里mybatis plus利用springboot的starter自动装配特性就帮我们配置好了。有点类似于Java的SPI机制。
创建spring boot启动类
@SpringBootApplication
public class MybatisPlusApplication {
public static void main(String[] args) {
SpringApplication.run(MybatisPlusApplication.class, args);
}
}
MybatisPlusConfig 配置告诉mybatis我们存放mapper接口所在的包
Mybatis plus ServiceImpl相当于BaseMapper的封装拓展
BaseMapper提供了单表的CRUD方便我们快速开发。
编码时刻
创建实体类 VipAccount(此处使用了 Lombok 简化代码)
BaseMapper使用
编写我们的Mapper接口类VipAccountMapper
我们的Mapper接口只要继承mybatis plus的BaseMapper就有了基本的CRUD功能
代码如下:
@DS("master")标识使用的是那个数据源,该注解也可以使用在mapper的方法上标识同一个mapper不同方法使用不同的数据源,轻松实现读写分离
@DS("master")
publicinterfaceVipAccountMapperextendsBaseMapper<VipAccount>{
}
@Data
publicclassVipAccountimplementsSerializable{
privateLong id;
privateString username;
}
开始使用
大功告成,最后就可以愉快的使用了。跟多的mybatis plus功能特性可以参考官方文档 Mybatis Plus,这里重点是合理的整合方式,通过yaml简单配置开箱即用。使用到的SQL表数据如下
单元测试走起
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;
import zero.springboot.study.mybatisplus.domain.VipAccount;
import zero.springboot.study.mybatisplus.mapper.master.VipAccountMapper;
import zero.springboot.study.mybatisplus.mapper.slave.VipAccountMapperSlave;
import zero.springboot.study.mybatisplus.service.vip.VipAccountServiceImpl;
@RunWith(SpringRunner.class)
@SpringBootTest(classes = MybatisPlusApplication.class)
public class MybatisPlusApplicationTests {
@Autowired
private VipAccountServiceImpl vipAccountService;
@Autowired
private VipAccountMapper vipAccountMapper;
@Autowired
private VipAccountMapperSlave vipAccountMapperSlave;
@Test
public void testServiceCrud() {
VipAccount vipAccount = new VipAccount();
vipAccount.setUsername("青龙");
vipAccountService.saveOrUpdate(vipAccount);
}
@Test
public void testMapperCrud() {
vipAccountMapper.deleteById(2);
VipAccount vipAccount = new VipAccount();
vipAccount.setUsername("青龙");
vipAccountMapper.insert(vipAccount);
VipAccount data = vipAccountMapperSlave.selectById(3);
System.out.println(data.toString());
}
}
您的点赞与关注、是我们的共同进步。
长按下图二维码关注或搜索公众号 JavaStorm,你将感受到一个有趣的灵魂。