目录
1 mp介绍
MyBatis-Plus (opens new window)(简称 MP)是一个 MyBatis (opens new window)的增强工具,在 MyBatis 的基础上只做==增强不做改变==,为简化开发、提高效率而生。--单表操作的都不需要自己在写sql语句。--
愿景
我们的愿景是成为 MyBatis 最好的搭档,就像 魂斗罗 中的 1P、2P,基友搭配,效率翻倍。
1.2 特点
-
无侵入:只做增强不做改变,引入它不会对现有工程产生影响,如丝般顺滑
-
损耗小:启动即会自动注入基本 CURD,性能基本无损耗,直接面向对象操作
-
强大的 CRUD 操作:内置通用 Mapper、通用 Service,仅仅通过少量配置即可实现-==单表大部分 CRUD 操作==,更有强大的==条件构造器[条件封装成一个条件类]==,满足各类使用需求
-
支持 Lambda 形式调用:通过 Lambda 表达式,方便的编写各类查询条件,无需再担心字段写错
-
支持主键自动生成:支持多达 4 种主键策略(内含分布式唯一 ID 生成器 - Sequence),可自由配置,完美解决主键问题
-
支持 ActiveRecord 模式:支持 ActiveRecord 形式调用,实体类只需继承 Model 类即可进行强大的 CRUD 操作
-
支持自定义全局通用操作:支持全局通用方法注入( Write once, use anywhere )
-
内置代码生成器:采用代码或者 Maven 插件可快速生成 Mapper 、 Model 、 Service 、 Controller 层代码,支持模板引擎,更有超多自定义配置等您来使用
-
内置分页插件:基于 MyBatis 物理分页,开发者无需关心具体操作,配置好插件之后,写分页等同于普通 List 查询。
-
分页插件支持多种数据库:支持 MySQL、MariaDB、Oracle、DB2、H2、HSQL、SQLite、Postgre、SQLServer 等多种数据库.
-
内置性能分析插件:可输出 SQL 语句以及其执行时间,建议开发测试时启用该功能,能快速揪出慢查询
-
内置全局拦截插件:提供全表 delete 、 update 操作智能分析阻断,也可自定义拦截规则,预防误操作.
1.3 如何使用
(1)创建数据库和表
CREATE TABLE user
(
id BIGINT(20) NOT NULL COMMENT '主键ID',
name VARCHAR(30) NULL DEFAULT NULL COMMENT '姓名',
age INT(11) NULL DEFAULT NULL COMMENT '年龄',
email VARCHAR(50) NULL DEFAULT NULL COMMENT '邮箱',
PRIMARY KEY (id)
);
DELETE FROM user;INSERT INTO user (id, name, age, email) VALUES
(1, 'Jone', 18, 'test1@baomidou.com'),
(2, 'Jack', 20, 'test2@baomidou.com'),
(3, 'Tom', 28, 'test3@baomidou.com'),
(4, 'Sandy', 21, 'test4@baomidou.com'),
(5, 'Billie', 24, 'test5@baomidou.com');
(2)依赖
<!--mp的依赖-->
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>3.5.1</version>
</dependency>
(3)创建实体类
package com.xzj.entity;
import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import lombok.Data;
@Data
//如果表名和实体类名不一致。@TableName(value = "tbl_user")
public class User {
//标记该属性为主键。 value:标记列名和属性名的对应
@TableId(value = "id")
private Integer id;
//如果属性和列名不一样 @TableField(value = "")
private String name;
private Integer age;
private String email;
}
//后期使用
package com.xzj.entity;
import java.time.LocalDateTime;
import java.io.Serializable;
import com.baomidou.mybatisplus.annotation.FieldFill;
import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableLogic;
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import lombok.EqualsAndHashCode;
import lombok.NoArgsConstructor;
/**
* <p>
*
* </p>
*
* @author xzj
* @since 2022-07-25
*/
@Data
@NoArgsConstructor
@EqualsAndHashCode(callSuper = false)
@ApiModel(value="User对象", description="")
public class User implements Serializable {
private static final long serialVersionUID = 1L;
@ApiModelProperty(value = "主键ID")
private Long id;
@ApiModelProperty(value = "姓名")
private String name;
@ApiModelProperty(value = "年龄")
private Integer age;
@ApiModelProperty(value = "邮箱")
private String email;
@ApiModelProperty(value = "逻辑字段 0表示未删除 1表示删除")
@TableLogic
private Boolean isdelete;
@ApiModelProperty(value = "创建时间")
@TableField(fill = FieldFill.INSERT)
private LocalDateTime gmtCreated;
@ApiModelProperty(value = "修改时间")
@TableField(fill = FieldFill.UPDATE)
private LocalDateTime gmtUpdated;
private String deptid;
@TableField(exist = false)
private TblDept dept;
public User(String name, Integer age, String email, String deptid) {
this.name = name;
this.age = age;
this.email = email;
this.deptid = deptid;
}
}
(4)dao
//BaseMapper接口中提供了单表的所有操作。crud.
@Mapper
public interface UserMapper extends BaseMapper<User> {
}
(5)测试
@Autowired
private UserMapper userMapper;
@Test
void contextLoads() {
User user = userMapper.selectById(1);
System.out.println(user);
}
2. mp操作
2.1 mp-增加
swagger类
package com.xzj.config;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.service.VendorExtension;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import java.util.ArrayList;
/**
* @author xuan
*/
@Configuration
public class SwaggerConfig {
@Bean
public Docket docket(){
Docket docket = new Docket(DocumentationType.SWAGGER_2)
.apiInfo(apiInfo())
.select()
.apis(RequestHandlerSelectors.basePackage("com.xzj.controller"))
.build();
return docket;
}
public ApiInfo apiInfo(){
Contact DEFAULT_CONTAT=new Contact("xxx","http://www.aaa.com","111@qq.com");
ApiInfo apiInfo= new ApiInfo("qy151在线文档","这是一个文档","A1.0","http://www.aaa.com",
DEFAULT_CONTAT,"AAA","http://www.aaa.com",new ArrayList<VendorExtension>());
return apiInfo;
}
}
增加
/**
* 主键mp提供相应的生成策略:
* AUTO(0),递增策略,如果使用该策略必须要求数据表的列也是递增。
* NONE(1),
* INPUT(2),没有策略,必须人为的输入id值
* ASSIGN_ID(3), 随机生成一个Long类型的值。该值一定是唯一。而且每次生成都不会相同。算法:雪花算法。 适合分布式主键。
* ASSIGN_UUID(4); 随机产生一个String类型的值。该值也是唯一的。
*/
@PostMapping("/findInsert")
@ApiOperation(value = "添加")
@ApiImplicitParams(
{
@ApiImplicitParam(value = "姓名", name="name",required = true),
@ApiImplicitParam(value = "年龄", name="age",required = true),
@ApiImplicitParam(value = "邮箱", name="email",required = true),
@ApiImplicitParam(value = "部门id", name="deptid",required = true)
}
)
public CommonResult findInsert(User user){
int insert = userMapper.insert(user);
if(insert==1){
return new CommonResult(2000,"添加成功",insert);
}else {
return new CommonResult(5000,"添加失败",null);
}
}
2.2 mp-逻辑删除
自动填充
package com.xzj.config;
import com.baomidou.mybatisplus.core.handlers.MetaObjectHandler;
import lombok.extern.slf4j.Slf4j;
import org.apache.ibatis.reflection.MetaObject;
import org.springframework.stereotype.Component;
import java.time.LocalDateTime;
@Slf4j
@Component
public class MyMetaObjectHandler implements MetaObjectHandler {
//当添加时自动填充的值
@Override
public void insertFill(MetaObject metaObject) {
log.info("start insert fill ....");
// 或者
this.strictInsertFill(metaObject, "gmtCreated", () -> LocalDateTime.now(), LocalDateTime.class); // 起始版本 3.3.3(推荐)
this.strictInsertFill(metaObject, "isdelete", ()->0, Integer.class); // 起始版本 3.3.3(推荐)
}
//当修改时自动填充的值
@Override
public void updateFill(MetaObject metaObject) {
log.info("start update fill ....");
// 或者
this.strictUpdateFill(metaObject, "gmtUpdated", () -> LocalDateTime.now(), LocalDateTime.class); // 起始版本 3.3.3(推荐)
}
}
删除
/**
* 实际开发中: 我们的删除可能是逻辑删除。所谓的逻辑删除就是修改功能。把某个列修改以删除的状态值。
* 只对自动注入的 sql 起效:
* 插入: 不作限制---
* 查找: 追加 where 条件过滤掉已删除数据,且使用 wrapper.entity 生成的 where 条件会忽略该字段
* 更新: 追加 where 条件防止更新到已删除数据,且使用 wrapper.entity 生成的 where 条件会忽略该字段
* 删除: 转变为 更新
* (1)增加一个逻辑字段: isdeleted 0表示未删除 1表示删除.
* (2)实体类上的字段添加 @TableLogic.
*/
@PostMapping("/findDelete")
@ApiOperation(value = "删除")
@ApiImplicitParams({
@ApiImplicitParam(value = "id" ,name="id",required = true)
})
public CommonResult testDelete(Long id){
int i = userMapper.deleteById(id);
if(i==1){
return new CommonResult(2000,"删除成功",i);
}else {
return new CommonResult(5000,"删除失败",null);
}
}
3. mp-查询
3.1 根据主键查询
@PostMapping("/findById")
@ApiOperation(value = "根据ID查询")
@ApiImplicitParams({
@ApiImplicitParam(value = "id",name = "id",required = true),
})
public CommonResult findById(Long id){
User user = userMapper.selectById(id);
System.out.println(user);
if(user!=null){
return new CommonResult(2000,"查询成功",user);
}else {
return new CommonResult(5000,"查询失败",null);
}
}
3.2 根据各种条件查询
public void testSelectByCondition(){
//Wrapper:封装了关于查询的各种条件方法。有三个子类最常用: QueryWrapper查询条件 UpdateWrapper修改条件 LambdaQueryWrapper查询使用lambda表达式条件
QueryWrapper<User> wrapper=new QueryWrapper<>();
wrapper.between("age", 15, 25);
wrapper.select("name","age");
wrapper.like("name","a");
System.out.println(userMapper.selectList(wrapper));
}
3.3 根据条件查询一条记录
public void testSelectOne(){
QueryWrapper<User> wrapper=new QueryWrapper<>();
wrapper.eq("username","");
wrapper.eq("password","");
User user = userMapper.selectOne(wrapper);
}
3.4 分页查询
/**
* (1)添加分页拦截器
* (2)调用分页方法
*/
@PostMapping("/findall")
@ApiOperation(value = "分页查询所有")
@ApiImplicitParams({
@ApiImplicitParam(value = "页码",name = "currentPage",required = true),
@ApiImplicitParam(value = "每页显示条数",name = "pageSize",required = true)
})
public CommonResult testall(Integer currentPage, Integer pageSize){
//P page, 分页对象 Page
// @Param("ew") Wrapper<T> queryWrapper
Page<User> userPage = new Page<>(currentPage,pageSize);
QueryWrapper<User> wrapper = new QueryWrapper<>();
//把查询的结果自动封装到Page对象中
Page<User> page = userMapper.selectPage(userPage, wrapper);
if(page!=null){
return new CommonResult(2000,"查询成功",page);
}else {
return new CommonResult(5000,"查询失败",null);
}
}
3.5 联表查询也使用mp的分页
@Mapper
public interface UserMapper extends BaseMapper<User> {
IPage<User> selectUserWithDept(IPage<User> page,@Param("ew") Wrapper<User> wrapper);
}
创建分页类
package com.xzj.config;
import com.baomidou.mybatisplus.annotation.DbType;
import com.baomidou.mybatisplus.autoconfigure.ConfigurationCustomizer;
import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
@Configuration
public class MybatisPlusConfig {
/**
* 新的分页插件,一缓和二缓遵循mybatis的规则,需要设置 MybatisConfiguration#useDeprecatedExecutor = false 避免缓存出现问题(该属性会在旧插件移除后一同移除)
*/
@Bean
public MybatisPlusInterceptor mybatisPlusInterceptor() {
MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
return interceptor;
}
}
创建mapper
<?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.xzj.mapper.UserMapper">
<resultMap id="baseMaper" type="com.xzj.entity.User" autoMapping="true">
<id property="id" column="id"/>
<association property="dept" javaType="com.xzj.entity.TblDept" autoMapping="true">
<id column="did" property="did"/>
</association>
</resultMap>
<select id="selectUserWithDept" resultMap="baseMaper">
select * from user u join tbl_dept d on u.deptid=d.did where isdelete=0
<if test="ew!=null">
and ${ew.sqlSegment}
</if>
</select>
</mapper>
controller层
@PostMapping("/findAll")
@ApiOperation(value = "联表分页查询所有")
@ApiImplicitParams({
@ApiImplicitParam(value = "页码",name = "currentPage",required = true),
@ApiImplicitParam(value = "每页显示条数",name = "pageSize",required = true)
})
public CommonResult Testlianbiao (Integer currentPage, Integer pageSize){
Page<User> page = new Page<>(currentPage,pageSize);
QueryWrapper<User> wrapper = new QueryWrapper<>();
IPage<User> users = userMapper.selectUserWithDept(page, null);
System.out.println(users);
if(users!=null){
return new CommonResult(2000,"查询成功",users);
}else {
return new CommonResult(5000,"查询失败",null);
}
}
4. mp的代码生成器
jar包
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-generator</artifactId>
<version>3.4.1</version>
</dependency>
<dependency>
<groupId>org.apache.velocity</groupId>
<artifactId>velocity-engine-core</artifactId>
<version>2.3</version>
</dependency><dependency>
<groupId>org.freemarker</groupId>
<artifactId>freemarker</artifactId>
<version>2.3.30</version>
</dependency>
创建类
package com.xzj.generator;
import com.baomidou.mybatisplus.core.exceptions.MybatisPlusException;
import com.baomidou.mybatisplus.core.toolkit.StringPool;
import com.baomidou.mybatisplus.generator.AutoGenerator;
import com.baomidou.mybatisplus.generator.InjectionConfig;
import com.baomidou.mybatisplus.generator.config.*;
import com.baomidou.mybatisplus.generator.config.po.TableInfo;
import com.baomidou.mybatisplus.generator.config.rules.NamingStrategy;
import com.baomidou.mybatisplus.generator.engine.FreemarkerTemplateEngine;
import java.util.ArrayList;
import java.util.List;
/**
* @author xuan
*/
// 演示例子,执行 main 方法控制台输入模块表名回车自动生成对应项目目录中
public class CodeGenerator {
/**
* <p>
* 读取控制台内容
* </p>
*/
public static void main(String[] args) {
// 代码生成器
AutoGenerator mpg = new AutoGenerator();
// 全局配置
GlobalConfig gc = new GlobalConfig();
gc.setOutputDir("./src/main/java");
gc.setAuthor("xzj");
gc.setOpen(false);
gc.setSwagger2(true); //实体属性 Swagger2 注解
mpg.setGlobalConfig(gc);
// 数据源配置
DataSourceConfig dsc = new DataSourceConfig();
dsc.setUrl("jdbc:mysql://localhost:3306/mp?serverTimezone=Asia/Shanghai");
// dsc.setSchemaName("public");
dsc.setDriverName("com.mysql.cj.jdbc.Driver");
dsc.setUsername("root");
dsc.setPassword("pAssW0rd");
mpg.setDataSource(dsc);
// 包配置
PackageConfig pc = new PackageConfig();
// pc.setModuleName("system");
pc.setParent("com.xzj");
mpg.setPackageInfo(pc);
// 自定义配置
InjectionConfig cfg = new InjectionConfig() {
@Override
public void initMap() {
// to do nothing
}
};
// 如果模板引擎是 freemarker
String templatePath = "/templates/mapper.xml.ftl";
// 如果模板引擎是 velocity
// String templatePath = "/templates/mapper.xml.vm";
// 自定义输出配置
List<FileOutConfig> focList = new ArrayList<>();
// 自定义配置会被优先输出
focList.add(new FileOutConfig(templatePath) {
@Override
public String outputFile(TableInfo tableInfo) {
// 自定义输出文件名 , 如果你 Entity 设置了前后缀、此处注意 xml 的名称会跟着发生变化!!
return "./src/main/resources/mapper/"/* + pc.getModuleName()
+ "/"*/ + tableInfo.getEntityName() + "Mapper" + StringPool.DOT_XML;
}
});
/*
cfg.setFileCreate(new IFileCreate() {
@Override
public boolean isCreate(ConfigBuilder configBuilder, FileType fileType, String filePath) {
// 判断自定义文件夹是否需要创建
checkDir("调用默认方法创建的目录,自定义目录用");
if (fileType == FileType.MAPPER) {
// 已经生成 mapper 文件判断存在,不想重新生成返回 false
return !new File(filePath).exists();
}
// 允许生成模板文件
return true;
}
});
*/
cfg.setFileOutConfigList(focList);
mpg.setCfg(cfg);
// 配置模板
TemplateConfig templateConfig = new TemplateConfig();
// 配置自定义输出模板
//指定自定义模板路径,注意不要带上.ftl/.vm, 会根据使用的模板引擎自动识别
// templateConfig.setEntity("templates/entity2.java");
// templateConfig.setService();
// templateConfig.setController();
templateConfig.setXml(null);
mpg.setTemplate(templateConfig);
// 策略配置
StrategyConfig strategy = new StrategyConfig();
strategy.setNaming(NamingStrategy.underline_to_camel);
strategy.setColumnNaming(NamingStrategy.underline_to_camel);
strategy.setEntityLombokModel(true);
strategy.setRestControllerStyle(true);
// 公共父类
// 写于父类中的公共字段
strategy.setControllerMappingHyphenStyle(true);
mpg.setStrategy(strategy);
mpg.setTemplateEngine(new FreemarkerTemplateEngine());
mpg.execute();
}
}