【官方文档】
【maven 依赖】
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>3.2.0</version>
</dependency>
下图可以看出mybatis-plus-boot-starter包含mybatis的相关包,所以不需要额外再引入mybatis的相关包
【本文Demo】
https://github.com/qidasheng2012/springboot2.x_ssm/tree/branch-mybatis-plus
【pom.xml】
添加依赖
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.2.0.RELEASE</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<groupId>com.springboot</groupId>
<artifactId>springboot2.x_ssm</artifactId>
<version>1.0.0</version>
<description>Spring Boot2.x 搭建 SSM 项目</description>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
<java.version>1.8</java.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>3.2.0</version>
</dependency>
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-generator</artifactId>
<version>3.2.0</version>
</dependency>
<dependency>
<groupId>org.freemarker</groupId>
<artifactId>freemarker</artifactId>
<version>2.3.29</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<scope>runtime</scope>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-devtools</artifactId>
<scope>runtime</scope>
<optional>true</optional>
</dependency>
<!-- 支持 @ConfigurationProperties 注解 读取properties或yml配置文件中的值 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-configuration-processor</artifactId>
<optional>true</optional>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>
【application.yml】
注意配置: mybatis-plus:
server:
port: 81
servlet:
context-path: /ssm
spring:
#数据源
datasource:
url: jdbc:mysql://localhost:3306/ssm?serverTimezone=Asia/Shanghai&characterEncoding=utf8
username: root
password: 123456
mybatis-plus:
# 如果是放在src/main/java目录下 classpath:/com/yourpackage/*/mapper/*Mapper.xml
# 如果是放在resource目录 classpath:/mapper/*Mapper.xml
mapper-locations: classpath*:mapper/*.xml
# 别名包扫描,多个package用逗号或者分号分隔
type-aliases-package: com.springboot.ssm.domain
configuration:
#配置返回数据库(column下划线命名&&返回java实体是驼峰命名),自动匹配无需as(没开启这个,SQL需要写as: select user_id as userId)
map-underscore-to-camel-case: true
cache-enabled: false
#配置JdbcTypeForNull, oracle数据库必须配置
jdbc-type-for-null: 'null'
global-config:
#主键类型 0:"数据库ID自增", 1:"用户输入ID",2:"全局唯一ID (数字类型唯一ID)", 3:"全局唯一ID UUID";
id-type: 0
#字段策略 0:"忽略判断",1:"非 NULL 判断"),2:"非空判断"
field-strategy: 2
#驼峰下划线转换
db-column-underline: true
#mp2.3+ 全局表前缀 t_
table-prefix: t_
#刷新mapper 调试神器
refresh-mapper: true
#数据库大写下划线转换
capital-mode: true
#逻辑删除配置(下面3个配置)
logic-delete-value: 4
logic-not-delete-value: 0
# 日志
logging:
level:
com.springboot.ssm.mapper: debug # 显示执行sql
【MybatisPlusConfig】
package com.springboot.ssm.config;
import com.baomidou.mybatisplus.extension.plugins.PaginationInterceptor;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.transaction.annotation.EnableTransactionManagement;
@EnableTransactionManagement
@Configuration
@MapperScan(basePackages = "com.springboot.ssm.mapper")
public class MybatisPlusConfig {
@Bean
public PaginationInterceptor paginationInterceptor() {
PaginationInterceptor paginationInterceptor = new PaginationInterceptor();
// 设置请求的页面大于最大页后操作, true调回到首页,false 继续请求 默认false
// paginationInterceptor.setOverflow(false);
// 设置最大单页限制数量,默认 500 条,-1 不受限制
// paginationInterceptor.setLimit(500);
return paginationInterceptor;
}
}
【UserMapper 】
继承 com.baomidou.mybatisplus.core.mapper.BaseMapper
package com.springboot.ssm.mapper;
import com.springboot.ssm.entity.User;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
/**
* 用户信息Mapper
* @author apple
* @since 2019-11-19
*/
public interface UserMapper extends BaseMapper<User> {
}
【BaseEntity】
package com.springboot.ssm.common;
import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableId;
import lombok.Data;
import java.io.Serializable;
@Data
public class BaseEntity implements Serializable {
@TableId(type = IdType.AUTO)
private Integer id;
}
【User】
package com.springboot.ssm.entity;
import com.baomidou.mybatisplus.annotation.TableName;
import com.springboot.ssm.common.BaseEntity;
import lombok.Data;
import lombok.EqualsAndHashCode;
import lombok.experimental.Accessors;
/**
* 用户信息
* @author apple
* @since 2019-11-19
*/
@Data
@EqualsAndHashCode(callSuper = true)
@Accessors(chain = true)
@TableName("t_user")
public class User extends BaseEntity {
/**
* 姓名
*/
private String name;
/**
* 年龄
*/
private Integer age;
}
【IUserService】
package com.springboot.ssm.service;
import com.springboot.ssm.entity.User;
import com.baomidou.mybatisplus.extension.service.IService;
/**
* 用户信息Service
* @author apple
* @since 2019-11-19
*/
public interface IUserService extends IService<User> {
}
【UserServiceImpl 】
package com.springboot.ssm.service.impl;
import com.springboot.ssm.entity.User;
import com.springboot.ssm.mapper.UserMapper;
import com.springboot.ssm.service.IUserService;
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import org.springframework.stereotype.Service;
/**
* 用户信息ServiceImpl
* @author apple
* @since 2019-11-19
*/
@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements IUserService {
}
【BaseController】
自定义通用controller
package com.springboot.ssm.common;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import org.springframework.web.bind.annotation.*;
import java.util.List;
public abstract class BaseController<T> {
public abstract IService<T> getIService();
@GetMapping("/list")
public List<T> list() {
return getIService().list();
}
@GetMapping("/page")
public IPage<T> page(@RequestParam long current, @RequestParam long size) {
Page<T> page = new Page(current, size);
return getIService().page(page);
}
@PostMapping("/add")
public String add(@RequestBody T t) {
return getIService().save(t) ? "添加成功!" : "添加失败!";
}
@PutMapping("/update")
public String update(@RequestBody T t) {
return getIService().updateById(t) ? "修改成功!" : "修改失败!";
}
@DeleteMapping("/deleteById/{id}")
public String deleteById(@PathVariable int id) {
return getIService().removeById(id) ? "删除成功!" : "删除失败!";
}
}
【UserController】
package com.springboot.ssm.controller;
import com.baomidou.mybatisplus.extension.service.IService;
import com.springboot.ssm.common.BaseController;
import com.springboot.ssm.entity.User;
import com.springboot.ssm.service.IUserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
/**
* 用户controller
* @author apple
* @since 2019-11-19
*/
@RestController
@RequestMapping("/user")
public class UserController extends BaseController<User> {
@Autowired
private IUserService iUserService;
@Override
public IService getIService() {
return iUserService;
}
}
【测试】
访问:http://127.0.0.1:81/ssm/user/list
访问:http://127.0.0.1:81/ssm/user/page?current=0&size=2
访问:http://127.0.0.1:81/ssm/user/add
访问:http://127.0.0.1:81/ssm/user/update
访问:http://127.0.0.1:81/ssm/user/deleteById/5
【代码生成器】
根据官网 代码生成器文档 改编,道友使用时请根据自己的项目路径进行相应的修改
package com.springboot.ssm.generator;
import com.baomidou.mybatisplus.core.exceptions.MybatisPlusException;
import com.baomidou.mybatisplus.core.toolkit.StringPool;
import com.baomidou.mybatisplus.core.toolkit.StringUtils;
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;
import java.util.Scanner;
//import com.baomidou.mybatisplus.core.toolkit.StringUtils;
// 演示例子,执行 main 方法控制台输入模块表名回车自动生成对应项目目录中
public class CodeGenerator {
/**
* <p>
* 读取控制台内容
* </p>
*/
public static String scanner(String tip) {
Scanner scanner = new Scanner(System.in);
StringBuilder help = new StringBuilder();
help.append("请输入" + tip + ":");
System.out.println(help.toString());
if (scanner.hasNext()) {
String ipt = scanner.next();
if (StringUtils.isNotEmpty(ipt)) {
return ipt;
}
}
throw new MybatisPlusException("请输入正确的" + tip + "!");
}
public static void main(String[] args) {
// 代码生成器
AutoGenerator mpg = new AutoGenerator();
// 全局配置
GlobalConfig gc = new GlobalConfig();
String projectPath = System.getProperty("user.dir");
gc.setOutputDir(projectPath + "/src/main/java");
gc.setAuthor("apple");
gc.setOpen(false);
// gc.setSwagger2(true); 实体属性 Swagger2 注解
mpg.setGlobalConfig(gc);
// 数据源配置
DataSourceConfig dsc = new DataSourceConfig();
dsc.setUrl("jdbc:mysql://localhost:3306/ssm?serverTimezone=Asia/Shanghai&useUnicode=true&useSSL=false&characterEncoding=utf8");
// dsc.setSchemaName("public");
dsc.setDriverName("com.mysql.cj.jdbc.Driver");
dsc.setUsername("root");
dsc.setPassword("123456");
mpg.setDataSource(dsc);
// 包配置
PackageConfig pc = new PackageConfig();
//pc.setModuleName(scanner("模块名"));
pc.setParent("com.springboot.ssm");
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 projectPath + "/src/main/resources/mapper/" + tableInfo.getEntityName() + "Mapper" + StringPool.DOT_XML;
}
});
cfg.setFileOutConfigList(focList);
mpg.setCfg(cfg);
// 配置模板
TemplateConfig templateConfig = new TemplateConfig();
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);
// 公共父类Entity
strategy.setSuperEntityClass("com.springboot.ssm.common.BaseEntity");
// 写于父类中的公共字段
strategy.setSuperEntityColumns("id");
// 公共父类Controller
strategy.setSuperControllerClass("com.springboot.ssm.common.BaseController");
strategy.setInclude(scanner("表名(多个英文逗号分割)").split(","));
strategy.setControllerMappingHyphenStyle(true);
strategy.setTablePrefix(scanner("表名前缀") + "_");
mpg.setStrategy(strategy);
mpg.setTemplateEngine(new FreemarkerTemplateEngine());
mpg.execute();
}
}
注意事项:
代码生成器生成的controller
请根据上面的案例进行相应的修改,实体类中serialVersionUID
请重新生成