前言:
mybatis 在持久层框架中还是比较火的,一般项目都是基于ssm。虽然 mybatis 可以直接在xml中通过SQL语句操作数据库,很是灵活。但正其操作都要通过SQL语句进行,就必须写大量的xml文件,很是麻烦。mybatis-plus就很好的解决了这个问题。
简介
MyBatis-Plus(简称 MP)是一个 MyBatis的增强工具,在 MyBatis 的基础上只做增强不做改变,为简化开发、提高效率而生。
整合
1、创建表
CREATE TABLE user (
id BIGINT(20) PRIMARY KEY NOT NULL COMMENT '主键',
user_name VARCHAR(30) DEFAULT NULL COMMENT '姓名',
age INT(11) DEFAULT NULL COMMENT '年龄',
email VARCHAR(50) DEFAULT NULL COMMENT '邮箱',
create_time DATETIME DEFAULT NULL COMMENT '创建时间',
update_time DATETIME DEFAULT NULL COMMENT '修改时间'
) ENGINE=INNODB CHARSET=UTF8;
初始化数据
INSERT INTO user (id, user_name, age, email,create_time,update_time) VALUES
(1, 'Jone', 18, 'test1@baomidou.com',now(),now()),
(2, 'Jack', 20, 'test2@baomidou.com',now(),now()),
(3, 'Tom', 28, 'test3@baomidou.com',now(),now()),
(4, 'Sandy', 21, 'test4@baomidou.com',now(),now()),
(5, 'Billie', 24, 'test5@baomidou.com',now(),now());
now()函数获取当前时间
2、创建springboot项目并导入依赖
这里导入的mysql版本为8.0,修改mysql版本为5.1.47(看个人mysql版本了)
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.47</version>
<scope>runtime</scope>
</dependency>
MyBatis-Plus依赖:
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>3.2.0</version>
</dependency>
官网最新版本已经为: 3.3.2
,使用Boot版本为2.2.4
,不使用最新的,哈哈。
3、配置
1、在 application.yml 配置文件中添加数据库的相关配置:
server:
port: 1998
spring:
datasource:
url: jdbc:mysql://127.0.0.1:3306/test?useSSL=false&useUnicode=true&characterEncoding=utf-8
username: root
password: 980402
driver-class-name: com.mysql.jdbc.Driver
mysql5跟mysql8在连接的时候会有点不同:
(1)、mysql 5 驱动不同 com.mysql.jdbc.Driver
(2)、mysql 8 驱动不同com.mysql.cj.jdbc.Driver、需要增加时区的配置 serverTimezone=GMT+8
4、编码
1、编写实体类 User.java
//生成getter,setter等函数
@Data
//生成全参数构造函数
@AllArgsConstructor
//生成无参构造函数
@NoArgsConstructor
public class User {
private Long id;
private String userName;
private Integer age;
private String email;
private Date createTime;
private Date updateTime;
}
2、编写Mapper接口
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.gongj.mybatisplus.entity.User;
//继承基本的类 BaseMapper
public interface UserMapper extends BaseMapper<User> {
}
3、在 Spring Boot 启动类中添加 @MapperScan 注解,扫描 Mapper 所在目录
@SpringBootApplication
@MapperScan("com.gongj.mybatisplus.mapper")
public class MybatisPlusApplication {
public static void main(String[] args) {
SpringApplication.run(MybatisPlusApplication.class, args);
}
}
5、测试
5.1、测试查询全部
@SpringBootTest
class MybatisPlusApplicationTests {
@Autowired
UserMapper userMapper;
@Test
void testSelect(){
// 参数是一个 Wrapper ,条件构造器,这里我们先不用 null 查询全部用户
List<User> users = userMapper.selectList(null);
users.forEach(System.out::println);
}
}
5.2、在yml配置sql日志
mybatis-plus:
configuration:
log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
再次查询
5.3、测试添加
@Test
void testInsert() {
User user = new User();
user.setUserName("gongj");
user.setEmail("19908488818@163.com");
user.setAge(23);
user.setCreateTime(new Date());
user.setUpdateTime(new Date());
int insert = userMapper.insert(user);//帮我们自动生成id
System.out.println("id=" + user.getId()); //id会自动回填
}
MyBatisPlus 主键策略:
public enum IdType {
AUTO(0), //数据库id自增
NONE(1), // 未设置主键id
INPUT(2), // 用户输入id
//以下三种只有当插入对象ID 为空,才自动填充。
ID_WORKER(3), // 默认的全局唯一id
UUID(4), //全局唯一uuid
ID_WORKER_STR(5); //字符串全局唯一ID ID_WORKER的字符串表示方式
}
修改默认的主键策略
在实体类字段上加上注解:@TableId(type = xxx)
@TableId(type = IdType.AUTO)
private Long id;
修改了主键策略为自增,数据库字段一定要是自增!
5.4、测试自动填充
在上面添加操作中我们是手动给创建时间、修改时间赋值,能不能自动化完成呢? MyBatisPlus 提供了这样的配置。
1、自定义实现类 MyMetaObjectHandler
@Component
public class MyMetaObjectHandler implements MetaObjectHandler {
// 插入时的填充策略
@Override
public void insertFill(MetaObject metaObject) {
this.setFieldValByName("createTime",new Date(),metaObject);
this.setFieldValByName("updateTime",new Date(),metaObject);
}
// 更新时的填充策略
@Override
public void updateFill(MetaObject metaObject) {
this.setFieldValByName("updateTime",new Date(),metaObject);
}
}
2、实体类字段属性增加注解
@TableField(fill = FieldFill.INSERT)
private Date createTime;
@TableField(fill = FieldFill.INSERT_UPDATE)
private Date updateTime;
填充类型:
public enum FieldFill {
/**
* 默认不处理
*/
DEFAULT,
/**
* 插入填充字段
*/
INSERT,
/**
* 更新填充字段
*/
UPDATE,
/**
* 插入和更新填充字段
*/
INSERT_UPDATE
}
再次测试添加操作:
@Test
void testInsert() {
User user = new User();
user.setUserName("gongj2");
user.setEmail("19908488818@163.com");
user.setAge(223);
int insert = userMapper.insert(user);//帮我们自动生成id
System.out.println("id=" + user.getId());
}
效果杠杠的。
5.5、修改测试
@Test
void testUpdate() {
User user = new User();
user.setId(1276042184872341506L);
user.setUserName("ggggggggggg");
user.setAge(555);
int insert = userMapper.updateById(user);
System.out.println("id=" + user.getId());
}
所有的sql都是自动帮你动态配置的!也可以看到updateTime的自动填充也生效了。
5.6、乐观锁
当要更新一条记录的时候,希望这条记录没有被别人更新
乐观锁实现方式:
1、取出记录时,获取当前version
2、更新时,带上这个version
3、执行更新时, set version = newVersion where version = oldVersion
4、如果version不对,就更新失败
5.6.1数据库增加version字段!
5.6.2实体类增加 version 属性并加注解!
@Version
private Integer version;
5.6.3插件配置
@Configuration
public class MybatisPlusConfig {
/**
* 乐观锁插件
*/
@Bean
public OptimisticLockerInterceptor optimisticLockerInterceptor() {
return new OptimisticLockerInterceptor();
}
}
5.6.4、测试修改
@Test
void testVserion(){
// 1、查询用户信息
User user = userMapper.selectById(1276056567094583298L);
user.setAge(55);
user.setUserName("yuanj");
//user 就是前台传入的值
userMapper.updateById(user);
}
我们注意一下update的sql语句
UPDATE user SET create_time=?, update_time=?, user_name=?, version=?, email=?, age=? WHERE id=? AND version=?
version做为了修改条件。
特别说明:
- 支持的数据类型只有:int,Integer,long,Long,Date,Timestamp,LocalDateTime
- 整数类型下
newVersion = oldVersion + 1
newVersion
会回写到entity
中- 仅支持
updateById(id)
与update(entity, wrapper)
方法 - 在
update(entity, wrapper)
方法下,wrapper
不能复用!!!
5.7、查询
5.7.1、根据id查询
@Test
void selectById(){
userMapper.selectById(1276056567094583298L);
}
5.7.2、根据id批量查询
@Test
public void selectBatchIds(){
// 根据id批量查询
List<User> users = userMapper.selectBatchIds(Arrays.asList(1276056567094583298L, 5, 3));
}
5.7.3、根据Map 自定义条件查询
@Test
public void selectByMap(){
// 根据Map 自定义条件查询
Map map = new HashMap();
map.put("user_name","yuanj");
List<User> users = userMapper.selectByMap(map);
}
5.8、分页查询
5.8.1、配置拦截器组件
/**
* 分页插件
*/
@Bean
public PaginationInterceptor paginationInterceptor() {
return new PaginationInterceptor();
}
5.8.2、编码
@Test
public void selectPage(){
Page<User> userPage = new Page<>();
userPage.setCurrent(1L); //当前是第几页 默认为1
userPage.setSize(2); //每页大小
IPage<User> userIPage = userMapper.selectPage(userPage, null);
System.out.println("当前页" + userIPage.getCurrent()); //当前页
System.out.println("总页数" + userIPage.getPages()); //总页数
System.out.println("返回数据" + userIPage.getRecords()); //返回数据
System.out.println("每页大小" + userIPage.getSize()); //每页大小
System.out.println("满足符合条件的条数" + userIPage.getTotal()); //满足符合条件的条数
System.out.println("下一页" + userPage.hasNext()); //下一页
System.out.println("上一页" + userPage.hasPrevious()); //上一页
}
5.9、删除
删除分为物理删除和逻辑删除。
5.9.1、物理删除
1、根据id物理删除
@Test
void deleteById(){
//根据id物理删除
int i = userMapper.deleteById(1L);
}
2、根据id物理批量删除
@Test
void deleteBatchIds(){
//批量删除
int i = userMapper.deleteBatchIds(Arrays.asList(2L, 4L));
System.out.println(i); //受影响的行数为2
}
5.9.2、逻辑删除
1、在数据表中增加一个 deleted 字段
2、实体类中增加属性并加上注解
@TableLogic
private Integer deleted;
3、测试
再次执行删除操作
@Test
void deleteById(){
//根据id删除
int i = userMapper.deleteById(3L);
System.out.println(i);
}
可以看到sql是修改语句。
4、执行查询:
@Test
void testSelect(){
// 参数是一个 Wrapper ,条件构造器,这里我们先不用 null 查询全部用户
List<User> users = userMapper.selectList(null);
users.forEach(System.out::println);
}
可以看到id为3的数据已经查询不出来了。
5.10、条件构造器
1、查询创建时间在2020-6-15到2020-7-5并且邮箱不等于空并不等于null的数据
@Test
void select1(){
QueryWrapper<User> queryWrapper = new QueryWrapper<>();
//查询创建时间在2020-6-15到2020-7-5并且邮箱不等于空并不等于null的数据
queryWrapper.between("create_time","2020-06-01","2020-07-05").ne("email","").isNotNull("email");
List<User> users = userMapper.selectList(queryWrapper);
users.forEach((System.out::println));
}
Preparing: SELECT id,deleted,create_time,update_time,user_name,version,email,age FROM
user WHERE deleted=0 AND (create_time BETWEEN ? AND ? AND
email <> ? AND email IS NOT NULL)
2、模糊查询
@Test
void select2(){
//模糊查询
QueryWrapper<User> queryWrapper = new QueryWrapper<>();
queryWrapper.likeLeft("user_name","J"); //左模糊 %J
List<User> users = userMapper.selectList(queryWrapper);
users.forEach((System.out::println));
}
3、子查询并根据id倒序
@Test
void select3(){
//子查询并根据id倒序
QueryWrapper<User> queryWrapper = new QueryWrapper<>();
queryWrapper.inSql("id","select id from user where id < 4");
queryWrapper.orderByDesc("id");
List<User> users = userMapper.selectList(queryWrapper);
users.forEach((System.out::println));
}
Preparing: SELECT id,deleted,create_time,update_time,user_name,version,email,age
FROM user WHERE deleted=0 AND (id IN (select id from user where id < 4))
ORDER BY id DESC
4、分页多条件查询
//分页多条件查询
@Test
void select4(){
//查询年龄大于等于28岁的信息并分页
QueryWrapper<User> queryWrapper = new QueryWrapper<>();
queryWrapper.ge("age",28);
Page<User> userPage = new Page<>();
userPage.setCurrent(1L);
userPage.setSize(2);
IPage<User> userIPage = userMapper.selectPage(userPage, queryWrapper);
List<User> records = userIPage.getRecords();
records.forEach((System.out::println));
}
SELECT COUNT(1) FROM user WHERE deleted = 0 AND (age >= ?)
SELECT id,deleted,create_time,update_time,user_name,version,email,age,cid
FROM user WHERE deleted=0 AND (age >= ?) LIMIT ?,?
5.11、关联查询
1、新建一个card表
CREATE TABLE card (
cid BIGINT(20) PRIMARY KEY NOT NULL COMMENT '主键',
cname VARCHAR(30) DEFAULT NULL COMMENT '卡片名'
) ENGINE=INNODB CHARSET=UTF8;
INSERT INTO card (cid,cname) VALUES
(1,'健身卡'),
(2,'KTV卡'),
(3,'校园卡')
2、在user表中创建cid列
并将user表和card表关联起来
3、编码
3.1、card实体
//生成getter,setter等函数
@Data
//生成全参数构造函数
@AllArgsConstructor
//生成无参构造函数
@NoArgsConstructor
public class Card {
private Long cid;
private String cname;
}
3.2、user实体
加入cid和cards属性
private Long cid;
private List<Card> cards;
3.3、UserMapper新增方法
List<User> userJoinCard();
3.4、UserMapper.xml
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.gongj.mybatisplus.mapper.UserMapper">
<resultMap id="userJoinCardMap" type="com.gongj.mybatisplus.entity.User">
<id column="id" property="id"/>
<result property="userName" column="user_name"></result>
<result property="age" column="age"></result>
<result property="createTime" column="create_time"></result>
<result property="updateTime" column="update_time"></result>
<result property="email" column="email"></result>
<result property="email" column="email"></result>
<result property="version" column="version"></result>
<result property="deleted" column="deleted"></result>
<result property="cid" column="cid"></result>
<collection property="cards" column="cid" ofType="com.gongj.mybatisplus.entity.Card">
<id column="cid" property="cid"></id>
<result column="cname" property="cname"></result>
</collection>
</resultMap>
<select id="userJoinCard" resultMap="userJoinCardMap">
select u.id,u.user_name,u.email,u.age,u.version,u.create_time,u.update_time,u.deleted,u.cid,c.cid,c.cname from user u left join card c on u.cid = c.cid
</select>
</mapper>
resultMap包含的元素:
<resultMap id="唯一的标识" type="映射的pojo对象">
<id column="表的主键字段" jdbcType="字段类型" property="映射pojo对象的主键属性" />
<result column="表的一个字段" jdbcType="字段类型" property="映射到pojo对象的一个属性"/>
<association property="pojo的一个对象属性" javaType="pojo关联的pojo对象">
<id column="关联pojo对象对应表的主键字段" jdbcType="字段类型" property="关联pojo对象的主席属性"/>
<result column="任意表的字段" jdbcType="字段类型" property="关联pojo对象的属性"/>
</association>
<!-- 集合中的property须为oftype定义的pojo对象的属性-->
<collection property="pojo的集合属性" ofType="集合中的pojo对象">
<id column="集合中pojo对象对应的表的主键字段" jdbcType="字段类型" property="集合中pojo对象的主键属性" />
<result column="可以为任意表的字段" jdbcType="字段类型" property="集合中的pojo对象的属性" />
</collection>
</resultMap>
如果collection标签是使用嵌套查询,格式如下:
注意:标签中的column:要传递给select查询语句的参数,如果传递多个参数,格式为column= ” {参数名1=表字段1,参数名2=表字段2} ;
<collection column="传递给嵌套查询语句的字段参数" property="pojo对象中集合属性" ofType="集合属性中的pojo对象" select="嵌套的查询语句" >
</collection>
https://www.cnblogs.com/kenhome/p/7764398.html
3.5、调用
@Test
void joinQuery(){
List<User> users = userMapper.userJoinCard();
users.forEach((System.out::println));
}
可以看到就是一条关联查询sql,然后在resultMap中进行字段映射。
3.6、collection的另外一种写法,也可以叫分布查询
CardMapper
public interface CardMapper extends BaseMapper<Card> {
public Card selectById();
}
CardMapper.xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.gongj.mybatisplus.mapper.CardMapper">
<resultMap id="CardMap" type="com.gongj.mybatisplus.entity.Card">
<id column="cid" property="cid"></id>
<result column="cname" property="cname"></result>
</resultMap>
<select id="selectById" resultMap="CardMap">
select * from card where cid = #{cid}
</select>
</mapper>
userMapper
List<User> userJoinCard2();
UserMapper.xml
<resultMap id="userJoinCardMap2" type="com.gongj.mybatisplus.entity.User">
<id column="id" property="id"/>
<result property="userName" column="user_name"></result>
<result property="age" column="age"></result>
<result property="createTime" column="create_time"></result>
<result property="updateTime" column="update_time"></result>
<result property="email" column="email"></result>
<result property="email" column="email"></result>
<result property="version" column="version"></result>
<result property="deleted" column="deleted"></result>
<result property="cid" column="cid"></result>
<collection property="cards" column="cid" ofType="com.gongj.mybatisplus.entity.Card" select="com.gongj.mybatisplus.mapper.CardMapper.selectById">
</collection>
</resultMap>
<select id="userJoinCard2" resultMap="userJoinCardMap2">
select u.id,u.user_name,u.email,u.age,u.version,u.create_time,u.update_time,u.deleted,u.cid from user u
</select>
select="com.gongj.mybatisplus.mapper.CardMapper.selectById"
使用内嵌查询。
调用
@Test
void joinQuery2(){
List<User> users = userMapper.userJoinCard2();
users.forEach((System.out::println));
}
5.12、关联查询并分页
UserMapper
List<User> userJoinCardPage(Page page);
UserMapper.xml
<select id="userJoinCardPage" resultMap="userJoinCardMap2">
select u.id,u.user_name,u.email,u.age,u.version,u.create_time,u.update_time,u.deleted,u.cid from user u
</select>
测试
@Test
void joinQueryPage(){
Page<User> userPage = new Page<>();
userPage.setSize(1);
userPage.setCurrent(1);
List<User> users = userMapper.userJoinCardPage(userPage);
users.forEach((System.out::println));
}
还是挺简单的,只需要传入一个Page对象就可以了。
补充1:
我们发现如果去调用单表查询的结果,也就是自带的查询,就会出现异常。
@Test
void testSelect(){
// 参数是一个 Wrapper ,条件构造器,这里我们先不用 null 查询全部用户
List<User> users = userMapper.selectList(null);
users.forEach(System.out::println);
}
那怎么解决呢?在实体类的属性上加入注解,exist 默认为true。
@TableField(exist = false)
private List<Card> cards;
注解加在bean属性上,表示当前属性不是数据库的字段,但在项目中必须使用,这样在新增、查询等使用bean的时候,mybatis-plus就会忽略这个,不会报错。
补充2:多表分页条件查询
//多表分页查询
@Test
void joinQueryPage3(){
//查询年龄大于等于20、名称以j开头的信息并分页
Page<User> userPage = new Page<>();
userPage.setSize(2);
userPage.setCurrent(1);
QueryWrapper<User> queryWrapper = new QueryWrapper<>();
queryWrapper.ge("age",20);
queryWrapper.likeRight("user_name","j");
IPage<User> userIPage = userMapper.userJoinCardPageQuery2(userPage,queryWrapper);
System.out.println("当前页" + userIPage.getCurrent()); //当前页
System.out.println("总页数" + userIPage.getPages()); //总页数
System.out.println("每页大小" + userIPage.getSize()); //每页大小
System.out.println("满足符合条件的条数" + userIPage.getTotal()); //满足符合条件的条数
System.out.println("返回数据===="); //返回数据
userIPage.getRecords().forEach((System.out::println));
}
执行结果:
当前页1
总页数1
每页大小2
满足符合条件的条数1
返回数据====
User(id=2, userName=Jack, age=20, email=test2@baomidou.com, createTime=Sat Oct 31 07:50:19 CST 2020, updateTime=Sat Oct 31 07:50:19 CST 2020, version=0, deleted=0, cid=1, cards=[Card(cid=1, cname=健身卡)])
UserMapper
IPage<User> userJoinCardPageQuery2(Page page, @Param(Constants.WRAPPER)QueryWrapper<User> queryWrapper);
UserMapper.xml
<select id="userJoinCardPageQuery2" resultMap="userJoinCardMap2">
<!--带上${ew.customSqlSegment 就可以实现查询-->
select u.id,u.user_name,u.email,u.age,u.version,u.create_time,u.update_time,u.deleted,u.cid from user u
${ew.customSqlSegment}
</select>
执行的sql
SELECT COUNT(1) FROM user u WHERE (age >= ? AND user_name LIKE ?)
select u.id,u.user_name,u.email,u.age,u.version,u.create_time,u.update_time,u.deleted,u.cid from user u WHERE (age >= ? AND user_name LIKE ?) LIMIT ?,?
select * from card where cid = ?