如果我的文章对您有帮助,请关注支持下作者的公众号:极客挖掘机,获取最新干货推送:)
1. 前言
ORM 框架的目的是简化编程中的数据库操作,经过这么多年的发展,基本上活到现在的就剩下两家了,一个是宣称可以不用写 SQL 的 Hibernate ,一个是对 SQL 非常友好的 Mybaties ,,两者各有特点,在企业级系统开发中可以根据需求灵活使用。发现一个有趣的现象:传统企业大都喜欢使用 Hibernate ,互联网行业通常使用 Mybatis 。
Hibernate 特点就是所有的 SQL 都用 Java 代码来生成,不用跳出程序去写(看) SQL ,有着编程的完整性,发展到最顶端就是 Spring Data Jpa 这种模式了,基本上根据方法名就可以生成对应的 SQL 了,有不太了解的可以看笔者的前两篇文章 Spring Boot (三):ORM 框架 JPA 与连接池 Hikari 和 为 JPA 插上翅膀的 QueryDSL。
Mybatis 初期使用比较麻烦,需要各种配置文件、实体类、Dao 层映射关联、还有一大推其它配置。当然 Mybatis 也发现了这种弊端,初期开发了 generator 可以根据表结果自动生产实体类、配置文件和 Dao 层代码,可以减轻一部分开发量;后期也进行了大量的优化可以使用注解了,自动管理 Dao 层和配置文件等,发展到最顶端就是今天要讲的这种模式了,mybatis-spring-boot-starter 就是 Spring Boot + Mybatis 可以完全注解不用配置文件,也可以简单配置轻松上手。
2. 工程实战
首先创建父工程 spring-boot-mybatis,引入全局依赖包,如下:
代码清单:spring-boot-mybatis/pom.xml
org.springframework.boot spring-boot-starter-web org.mybatis.spring.boot mybatis-spring-boot-starter 2.1.0mysql mysql-connector-java runtimeorg.projectlombok lombok trueorg.springframework.boot spring-boot-starter-test test
- mybatis-spring-boot-starter :目前最新版本为 2.1.0
2.1 极简 xml 版
创建子工程 spring-boot-mybatis-xml
2.1.1 配置文件
application.yml 配置文件如下:
代码清单:spring-boot-mybatis/spring-boot-mybatis-xml/src/main/resources/application.yml
server: port: 8080spring: application: name: spring-boot-mybatis-xml datasource: url: jdbc:mysql://localhost:3306/test?serverTimezone=Asia/Shanghai&useUnicode=true&characterEncoding=UTF-8&useSSL=false username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver type: com.zaxxer.hikari.HikariDataSource hikari: auto-commit: true minimum-idle: 2 idle-timeout: 60000 connection-timeout: 30000 max-lifetime: 1800000 pool-name: DatebookHikariCP maximum-pool-size: 5mybatis: type-aliases-package: com.springboot.springbootmybatisxml.model config-location: classpath:mybatis/mybatis-config.xml mapper-locations: classpath:mybatis/mapper/*.xml
- 这里使用 hikari 作为数据库连接池
- Spring Boot 会自动加载 spring.datasource.* 相关配置,数据源会自动注入到 sqlSessionFactory 中, sqlSessionFactory 会自动注入到 Mapper 中。
- 这里需要指定基础配置文件和实体类映射文件的地址
mybatis-config.xml 配置文件如下:
代码清单:spring-boot-mybatis/spring-boot-mybatis-xml/src/main/resources/mybatis/mybatis-config.xml
2.1.2 Mapper 映射文件
代码清单:spring-boot-mybatis/spring-boot-mybatis-xml/src/main/resources/mybatis/mapper/UserMapper.xml
id, nick_name, age, create_date SELECT FROM user SELECT FROM user WHERE id = #{id} select uuid() as id from dual INSERT INTO user (id, nick_name, age, create_date) VALUES (#{id}, #{nickName}, #{age}, #{createDate}) UPDATE user SET nick_name = #{nickName},age = #{age},create_date = #{createDate} WHERE id = #{id} DELETE FROM user WHERE id = #{id}
- namespace :需配置对应的接口
- 实现了简单的 CRUD 操作
- 新增数据时选用 UUID 作为主键
- 动态条件可使用 标签作判断
2.1.3 Mapper 层代码
代码清单:spring-boot-mybatis/spring-boot-mybatis-xml/src/main/java/com/springboot/springbootmybatisxml/mapper/UserMapper.java
public interface UserMapper { List getAll(); User getUser(String id); Long insertUser(User user); Long updateUser(User user); Long deleteUser(String id);}
- 这里仅需定义接口方法, mybaties 会自动帮我们调用 xml 映射文件中的代码。
2.1.4 启动主类
代码清单:spring-boot-mybatis/spring-boot-mybatis-xml/src/main/java/com/springboot/springbootmybatisxml/SpringBootMybatisXmlApplication.java
@SpringBootApplication@MapperScan("com.springboot.springbootmybatisxml.mapper")public class SpringBootMybatisXmlApplication { public static void main(String[] args) { SpringApplication.run(SpringBootMybatisXmlApplication.class, args); }}
- 在启动主类上配置 @MapperScan 或者直接在 Mapper 类上增加注解 @Mapper ,两种方法起到的结果是一样的。不过建议选择在启动主类上配置 @MapperScan ,不然在每个 Mapper 类上加注解也麻烦,还容易漏加。
2.2 无配置文件注解版
2.2.1 配置
配置文件 application.yml 如下:
代码清单:
mybatis: type-aliases-package: com.springboot.springbootmybatisannotation.model
- 剩余部分和上面一致, mybatis 的配置仅需配置这一条足够
2.2.2 Mapper 类
注解版的核心就是这个类,所有的 SQL 都在这个类里面,代码如下:
代码清单:
public interface UserMapper { @Select("select * from user") @Results({ @Result(property = "id