1. Mybatis 存在的痛点
我们知道 MyBatis 是一个基于 java 的持久层框架,它内部封装了 jdbc,极大提高了我们的开发效率。
但是使用 Mybatis 开发也有很多痛点:
- 每个 Dao 接口都需要自己定义一堆增删改查方法。
/**
* @Desc: UserDao 接口
* @Author: 公众号:知否技术
* @date: 下午7:43 2022/5/7
*/
public interface UserDao {
// 获取所有用户信息
List<User> getUserList();
// 根绝 id 获取用户信息
User getUserById(int id);
// 新增用户信息
boolean add(User user);
// 更新用户信息
boolean update(User user);
// 删除用户信息
boolean delete(int id);
}
复制代码
2.每个 Mapper 文件都需要写一堆
基本的增删改查语句。
3.如果查询的列表需要分页,我们还需要给查询方法封装成分页对象。
你可能会说:Mybatis 还能有痛点?用着多方便!
对于小项目而言,用着确实还行。但是遇到大项目,光 Dao 接口都有几百个,如果还要手动定义一堆增删改查方法和 sql 语句,那也很浪费时间。
那有没有这样一个框架:
1.封装了 Mybatis,自带 CRUD 方法,我们不需要自己定义 CRUD 方法。
2.提供各种查询方法,不需要在 mapper 文件中写一些基础的 sql 语句。
3.封装了分页功能,让分页查询无比丝滑。
有的,MybatisPlus
闪亮登场。
2. 邂逅 MybatisPlus
官网:
https://baomidou.com/
复制代码
MybatisPlus 是在 Mybatis 原有功能的基础上进行了封装。它不做改变,而是增强了 Mybatis 的功能。
我们不用写 mappe.xml ,直接调用它的 API 就能完成 CRUD 和各种查询操作。
而且它自带分页插件等一些高级功能,极大地提高了我们的开发效率。
3. 入门案例
开发环境:
- 开发工具:IDEA
- 构建工具:Maven
- 数据库:MySQL
- 项目框架:SpringBoot
1.新建 SpringBoot 项目
2.引入依赖
<!-- mybatis-plus 依赖-->
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>3.4.0</version>
</dependency>
<!-- mysql驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<scope>runtime</scope>
</dependency>
<!-- test -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
复制代码
3.创建数据库表
user 表:
CREATE TABLE `user` (
`id` bigint NOT NULL AUTO_INCREMENT COMMENT 'id',
`name` varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci DEFAULT NULL COMMENT '姓名',
`age` int DEFAULT NULL COMMENT '年龄',
PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=1508421137384648706 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci ROW_FORMAT=DYNAMIC;
复制代码
4.实体类
public class User {
@TableId(value = "id", type = IdType.ASSIGN_ID)
private Long id;
private String name;
private int age;
public User(String name, int age) {
this.name = name;
this.age = age;
}
public Long getId() {
return id;
}
public void setId(Long id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
}
复制代码
5.修改 application.yml
server:
port: 8082
servlet:
context-path: /mybatisplus_demo
# 数据源配置
spring:
datasource:
username: root
password: 12345678
url: jdbc:mysql://localhost:3306/ssm?allowPublicKeyRetrieval=true&useSSL=false
driver-class-name: com.mysql.cj.jdbc.Driver
复制代码
6.新建 UserMapper 接口
注:
(1)因为 mybatis 规定:mapper.xml 文件的名字要和接口名字一样,所以很多人习惯将 Dao 接口命名为 xxxMapper
。
(2)BaseMapper 是 MybatisPlus 内置的接口,它包含基本的 CRUD 方法。
7.启动类添加 @MapperScan 注解
8.测试
@SpringBootTest
public class MybatisPlusDemoApplicationTests {
@Resource
private UserMapper userMapper;
@Test
void testMybatisPlus() {
for (int i = 18; i < 20; i++) {
User user = new User("王小波" + i, i);
userMapper.insert(user);
}
}
}
复制代码
9.总结
我们发现只要继承 MybatisPlus 的BaseMapper,就能完成基本的增删改查操作,非常方便。
4. 基本增删改查
1.新增
User user = new User("王小波", 19);
userMapper.insert(user);
复制代码
2.编辑
根据 id 更新数据
int rows = userMapper.updateById(user);
if(rows>0){
System.out.println("更新成功");
}
复制代码
3.删除
根据主键删除信息
userMapper.deleteById("152635612");
复制代码
根据 map 条件删除信息
Map<String, Object> param = new HashMap<>();
param.put("age", 18);
int rows = userMapper.deleteByMap(param);
if (rows > 0) {
System.out.println("删除成功!");
}
复制代码
根据 id 集合批量删除
List<Integer> ids = Stream.of(110, 112, 113, 115).collect(Collectors.toList());
int rows = userMapper.deleteBatchIds(ids);
if (rows > 0) {
System.out.println("删除成功!");
}
复制代码
4.查询
根据 id 查询
User user = userMapper.selectById(152382374);
复制代码
根据 map 条件查询
Map<String, Object> param = new HashMap<>();
param.put("age", 18);
List<User> userList = userMapper.selectByMap(param);
复制代码
根据 id 集合批量查询
List<Integer> ids = Stream.of(110, 112, 113, 115).collect(Collectors.toList());
List<User> userList = userMapper.selectBatchIds(ids);
复制代码
5. 构造器
MybatisPlus 提供了查询构造器和更新构造器用来生成带有 where 条件的 sql 语句。
(1)封装查询条件的构造器:
QueryWrapper
复制代码
常用查询条件:
等于:eq
QueryWrapper<User> userWrapper = new QueryWrapper<>();
// 查询名字是张三的用户
userWrapper.eq("name","张三");
List<User> userList = userMapper.selectList(userWrapper);
复制代码
不等于:ne
QueryWrapper<User> userWrapper = new QueryWrapper<>();
userWrapper.ne("name","张三");
// 查询名字不是张三的用户
List<User> userList = userMapper.selectList(userWrapper);
复制代码
模糊查询:like
QueryWrapper<User> userWrapper = new QueryWrapper<>();
// 模糊查询
userWrapper.like("name","张");
List<User> userList = userMapper.selectList(userWrapper);
复制代码
降序:orderByDesc
QueryWrapper<User> userWrapper = new QueryWrapper<>();
// 模糊查询并根据 number 倒序
userWrapper.like("name","张").orderByDesc("number");
List<User> userList = userMapper.selectList(userWrapper);
复制代码
升序:orderByAsc
QueryWrapper<User> userWrapper = new QueryWrapper<>();
// 模糊查询并根据 number 降序
userWrapper.like("name","张").orderByAsc("number");
List<User> userList = userMapper.selectList(userWrapper);
复制代码
其他常用的条件可以去官网查看相关文档,这里不再过多赘述:
https://baomidou.com/pages/10c804/#in
复制代码
(2)封装更新条件的构造器:
UpdateWrapper
复制代码
UpdateWrapper 的 where 条件和 QueryWrapper 的一样,只不过需要 set 值。
UpdateWrapper<User> userWrapper = new UpdateWrapper<>();
userWrapper.set("name","王小波").set("age",22)
.eq("name","张三");
复制代码
6. 通用 Service
MybatisPlus 中有一个通用的接口 Iservice 和实现类,封装了常用的增删改查等操作。
1.新建 service 和 实现类
UserService
/**
* @Desc:
* @Author: 公众号:知否技术
* @date: 下午9:57 2022/5/11
*/
public interface UserService extends IService<User> {
}
复制代码
UserServiceImpl
/**
* @Desc:
* @Author: 公众号:知否技术
* @date: 下午9:57 2022/5/11
*/
@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService {
}
复制代码
2.测试
我们发现该 IService 接口封装了一些常用的方法,极大地提高了我们的开发效率。
7. 常用注解
1.@TableId
MybatisPlus 会默认将实体类中的 id 作为主键。
@TableId 表示 id 的生成策略,常用的有两种:
(1) 基于数据库的自增策略
(2) 使用雪花算法策略随机生成 2.@TableName
如果实体类和数据库的表名不一致,可以使用这个注解做映射
例如:
3.@TableField
当表属性和实体类中属性名不一致时,可以使用这个注解做映射:
8. 分页
MybatisPlus 内部封装了分页插件,只用简单配置一下就能实现分页功能。
1.配置类
/**
* @Desc:
* @Author: 公众号:知否技术
* @date: 下午9:31 2022/5/11
*/
@Configuration
@MapperScan("com.zhifou.mapper")
public class MybatisPlusConfig {
@Bean
public MybatisPlusInterceptor mybatisPlusInterceptor() {
MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
interceptor.addInnerInterceptor(new
PaginationInnerInterceptor(DbType.MYSQL));
return interceptor;
}
}
复制代码
2.测试
@Test
void testMybatisPlus() {
int current = 1;
int size = 10;
Page<User> userPage = new Page<>(current, size);
//获取分页数据
List<User> list = userPage.getRecords();
list.forEach(user->{
System.out.println(user);
});
Page<User> page = userMapper.selectPage(userPage, null);
System.out.println("当前页:" + page.getCurrent());
System.out.println("每页条数:" + page.getSize());
System.out.println("总记录数:" + page.getTotal());
System.out.println("总页数:" + page.getPages());
}
复制代码
9. 代码生成器
MybatisPlus 可以帮助我们自动生成 controller、service、dao、model、mapper.xml 等文件,极大地提高了我们的开发效率。
1.引入依赖
<!-- 代码生成器 -->
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-generator</artifactId>
<version>3.5.1</version>
</dependency>
<dependency>
<groupId>org.freemarker</groupId>
<artifactId>freemarker</artifactId>
</dependency>
复制代码
2.代码生成器工具类
public class CodeGenerator {
public static void main(String[] args) {
// 连接数据库
FastAutoGenerator.create("jdbc:mysql://localhost:3306/ssm?allowPublicKeyRetrieval=true&useSSL=false&useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC", "root", "123456")
.globalConfig(builder -> {
builder.author("知否技术") // 设置作者
.fileOverride() // 覆盖已生成文件
// 设置日期时间
.dateType(DateType.ONLY_DATE)
.outputDir("D:\\WorkSpace\\idea\\mybatisplus_demo\\src\\main\\java"); // 指定输出目录
})
.packageConfig(builder -> {
builder.parent("com.zhifou") // 设置父包名
.pathInfo(Collections.singletonMap(OutputFile.mapperXml, "D:\\WorkSpace\\idea\\mybatisplus_demo\\src\\main\\resources\\mapper")); // 设置mapperXml生成路径
})
.strategyConfig(builder -> {
builder.addInclude("t_user") // 设置需要生成的表名
.addTablePrefix("t_"); // 设置过滤表前
// 新增数据,自动为创建时间赋值
IFill createFill = new Column("created_date", FieldFill.INSERT);
IFill updateFill = new Column("updated_date", FieldFill.UPDATE);
builder.entityBuilder()
// 设置id类型
.idType(IdType.ASSIGN_ID)
// 开启 Lombok
.enableLombok()
// 开启连续设置模式
.enableChainModel()
// 驼峰命名模式
.naming(NamingStrategy.underline_to_camel)
.columnNaming(NamingStrategy.underline_to_camel)
// 自动为创建时间、修改时间赋值
.addTableFills(createFill).addTableFills(updateFill)
// 逻辑删除字段
.logicDeleteColumnName("is_deleted");
// Restful 风格
builder.controllerBuilder().enableRestStyle();
// 去除 Service 前缀的 I
builder.serviceBuilder().formatServiceFileName("%sService");
// mapper 设置
builder.mapperBuilder()
.enableBaseResultMap()
.enableBaseColumnList();
})
// 固定
.templateEngine(new FreemarkerTemplateEngine()) // 使用Freemarker引擎模板,默认的是Velocity引擎模板
.execute();
}
}
复制代码
关键点:
(1)配置数据库连接信息。
自动生成代码需要连接数据库
(2)指定输出目录,这里直接设置你项目的目录,到时候不用赋值粘贴了。 (3)设置父包名。 (4)设置表名
然后右键运行,代码就会自动生成。
10. application.yml 配置
# MybatisPlus
mybatis-plus:
global-config:
db-config:
column-underline: true # 驼峰形式
logic-delete-field: isDeleted # 全局逻辑删除的实体字段名
logic-delete-value: 1 # 逻辑已删除值(默认为 1)
logic-not-delete-value: 0 # 逻辑未删除值(默认为 0)
db-type: mysql
id-type: assign_id # id策略
table-prefix: t_ # 配置表的默认前缀
mapper-locations: classpath*:/mapper/**Mapper.xml # mapper 文件位置
type-aliases-package: com.zhifou.entity # 实体类别名
configuration:
log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 日志:打印sql 语句
复制代码
11. 完整代码
链接: https://pan.baidu.com/s/1nlRjKOWs3ON53Dh1XXLKGw
提取码: 9un7
复制代码
12. 遇到的坑
1.传参为 0 时,查询语句失效。
例如传递的 age 为 0,查询就会失效
<select id="getUser" resultType="user">
select id,name,age,sex from user
<where>
<if test="age != null and age !='' ">
age = #{age}
</if>
</where>
</select>
复制代码
原因:判断 int 是否为空只要 !=null 就行了,如果加上 type != '',0 会被转为 null
。
2.MybatisPlus 更新字段为 null 失败
解决办法:
@TableField(updateStrategy = FieldStrategy.IGNORED)
private String name;
复制代码
该注解会忽略为空的判断,