SpringBoot 系列教程 Mybatis+xml 整合篇
MyBatis 是一款优秀的持久层框架,它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以使用简单的 XML 或注解来配置和映射原生类型、接口和 Java 的 POJO(Plain Old Java Objects,普通老式 Java 对象)为数据库中的记录。
本文将通过实例方式,介绍下如何整合 SpringBoot + Mybatis,构建一个支持 CRUD 的 demo 工程
I. 环境
本文使用 SpringBoot 版本为 2.2.1.RELEASE
, mybatis 版本为1.3.2
,数据库为 mysql 5+
1. 项目搭建
推荐是用官方的教程来创建一个 SpringBoot 项目; 如果直接创建一个 maven 工程的话,将下面配置内容,拷贝到你的pom.xml
中
- 主要引入的是
mybatis-spring-boot-starter
,可以减少令人窒息的配置
org.springframework.boot
spring-boot-starter-parent
2.2.1.RELEASE
UTF-8
UTF-8
1.8
org.mybatis.spring.boot
mybatis-spring-boot-starter
1.3.2
mysql
mysql-connector-java
org.springframework.boot
spring-boot-maven-plugin
spring-snapshots
Spring Snapshots
https://repo.spring.io/libs-snapshot-local
true
spring-milestones
Spring Milestones
https://repo.spring.io/libs-milestone-local
false
spring-releases
Spring Releases
https://repo.spring.io/libs-release-local
false
2. 配置信息
在 application.yml
配置文件中,加一下 db 的相关配置
spring:
datasource:
url: jdbc:mysql://127.0.0.1:3306/story?useUnicode=true&characterEncoding=UTF-8&useSSL=false
username: root
password:
接下来准备一个测试表(依然借用之前 db 操作系列博文中的表结构),用于后续的 CURD;表结果信息如下
DROP TABLE IF EXISTS `money`;
CREATE TABLE `money` (
`id` int(11) unsigned NOT NULL AUTO_INCREMENT,
`name` varchar(20) NOT NULL DEFAULT '' COMMENT '用户名',
`money` int(26) NOT NULL DEFAULT '0' COMMENT '有多少钱',
`is_deleted` tinyint(1) NOT NULL DEFAULT '0',
`create_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`update_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
PRIMARY KEY (`id`),
KEY `name` (`name`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
II. 实例整合
本文将介绍一下传统的 xml 使用姿势,手动的添加PO
, DAO
, Mapper.xml
;至于 Generator 来自动生成的 case,后面通过图文的方式进行介绍
1. PO
创建表对应的 PO 对象: MoneyPo
@Data
public class MoneyPo {
private Integer id;
private String name;
private Long money;
private Integer isDeleted;
private Timestamp createAt;
private Timestamp updateAt;
}
2. DAO 接口
表的操作接口,下面简单的写了四个接口,分别对应 CRUID 四种操作
@Mapper
public interface MoneyMapper {
int savePo(@Param("po") MoneyPo po);
List findByName(@Param("name") String name);
int addMoney(@Param("id") int id, @Param("money") int money);
int delPo(@Param("id") int id);
}
重点观察下上面接口的两个注解
-
@Mapper
:声明这个为 mybatis 的 dao 接口,spring 扫描到它之后,会自动生成对应的代理类- 使用这个注解之后,可以不再启动类上加上
@MapperScan
; 当然加上@MapperScan
之后,也可以不用这个注解
- 使用这个注解之后,可以不再启动类上加上
-
@Param
: 主要传递到 xml 文件中,方便参数绑定
这里简单说一下几种常见的参数传递方式
a. 单参数传递
如果只有一个基本类型的参数,可以直接使用参数名的使用方式
MoneyPo findById(int id);
对应的 xml 文件如下(先忽略 include 与 resultMap), 可以直接用参数名
b. 多参数默认传递
当接口定义有多个参数时,就不能直接使用参数名了,使用 arg0, arg1... (或者 param1, param2...)
实例如下
List findByNameAndMoney(String name, Integer money);
对应的 xml
c. @Param 方式
就是上面 case 中的方式,xml 中的参数就是注解的 value;就不给演示了(后续的 xml 中可以看到使用姿势)
d. Map 传参
接口定义一个 Map
List findByMap(Map map);
对应的 xml 如下,关于标签的用法主要是 mybatis 的相关知识点,这里不详细展开
e. POJO 传参
参数为一个 POJO 对象,实际使用中,通过成员名来确定具体的参数
List findByPo(MoneyPo po);
对应的 xml 如下,需要添加参数parameterType
指定 POJO 的类型
此外请额外注意下面的参数使用姿势和后面savePo
接口对应的实现中参数的引用区别
3. xml 实现
上面的 Mapper 接口中定义接口,具体的实现需要放在 xml 文件中,在我们的实例 case 中,xml 文件放在 resources/sqlmapper
目录下
文件名为money-mapper.xml
, 没有什么特别的要求
id, name, money, is_deleted, create_at, update_at
INSERT INTO `money` (`name`, `money`, `is_deleted`)
VALUES
(#{po.name}, #{po.money}, #{po.isDeleted});
update money set money=money+#{money} where id=#{id}
delete from money where id = #{id,jdbcType=INTEGER}
在上面的 xml 文件中,除了四个接口对应的实现之外,还定义了一个resultMap
和 sql
- sql 标签定义通用的 sql 语句片段,通过
方式引入,避免写重复代码 - resultMap: 定义表中数据与 POJO 成员的映射关系,比如将下划线的命名映射成驼峰
4. mybatis 配置
上面基本上完成了整合工作的 99%, 但是还有一个问题没有解决,mapper 接口如何与 xml 文件关联起来?
- xml 文件中的 mapper 标签的 namespace 指定了具体的 mapper 接口, 表明这个 xml 文件对应的这个 mapper
但是对于 spring 而言,并不是所有的 xml 文件都会被扫描的,毕竟你又不是 web.xml
这么有名(为什么 web.xml 就这么特殊呢 , 欢迎查看我的Spring MVC 之基于 xml 配置的 web 应用构建)
为了解决 xml 配置扫描问题,请在 application.yml
文件中添加下面这一行配置
mybatis:
mapper-locations: classpath:sqlmapper/*.xml
5. 测试
接下来简单测试一下上面的四个接口,看是否可以正常工作
启动类
@SpringBootApplication
public class Application {
public Application(MoneyRepository repository) {
repository.testMapper();
}
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
测试类
@Repository
public class MoneyRepository {
@Autowired
private MoneyMapper moneyMapper;
private Random random = new Random();
public void testMapper() {
MoneyPo po = new MoneyPo();
po.setName("mybatis user");
po.setMoney((long) random.nextInt(12343));
po.setIsDeleted(0);
moneyMapper.savePo(po);
System.out.println("add record: " + po);
moneyMapper.addMoney(po.getId(), 200);
System.out.println("after addMoney: " + moneyMapper.findByName(po.getName()));
moneyMapper.delPo(po.getId());
System.out.println("after delete: " + moneyMapper.findByName(po.getName()));
}
}
输出结果
II. 其他
0. 项目
- 工程:https://github.com/liuyueyi/spring-boot-demo
- 项目源码: https://github.com/liuyueyi/spring-boot-demo/tree/master/spring-boot/103-mybatis-xml
1. 一灰灰 Blog
尽信书则不如,以上内容,纯属一家之言,因个人能力有限,难免有疏漏和错误之处,如发现 bug 或者有更好的建议,欢迎批评指正,不吝感激
下面一灰灰的个人博客,记录所有学习和工作中的博文,欢迎大家前去逛逛
- 一灰灰 Blog 个人博客 https://blog.hhui.top
- 一灰灰 Blog-Spring 专题博客 http://spring.hhui.top