您好,登錄后才能下訂單哦!
SpringBoot中實現整合MyBatis-Plus的方法?相信很多沒有經驗的人對此束手無策,為此本文總結了問題出現的原因和解決方法,通過這篇文章希望你能解決這個問題。
一、簡介
1、MyBatis
MyBatis 是一款優秀的持久層框架,它支持自定義 SQL、存儲過程以及高級映射。MyBatis 免除了幾乎所有的 JDBC 代碼以及設置參數和獲取結果集的工作。MyBatis 可以通過簡單的 XML 或注解來配置和映射原始類型、接口和 Java POJO(Plain Old Java Objects,普通老式 Java 對象)為數據庫中的記錄。
官方文檔:
https://mybatis.org/mybatis-3/zh/index.html
2、MyBatis-Plus
MyBatis-Plus(簡稱 MP)是一個 MyBatis 的增強工具,在 MyBatis 的基礎上只做增強不做改變,為簡化開發、提高效率而生。
官方文檔:
https://mybatis.plus/guide/
二、開發前戲
1、引入 MyBatis-Plus
在 pom.xml 文件中引入 MyBatis-Plus 所需依賴
<!-- mybatis-plus --> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.3.1</version> </dependency> <!-- mybatis-plus代碼生成器 --> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-generator</artifactId> <version>3.3.1.tmp</version> </dependency> <!-- mybatisPlus Freemarker 模版引擎 --> <dependency> <groupId>org.freemarker</groupId> <artifactId>freemarker</artifactId> </dependency> <!-- mysql連接 --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <scope>runtime</scope> </dependency>
freemarker 作為 MyBatis-Plus 自動生成代碼時作為模板使用,還可選用 velocity 作為模板
<dependency> <groupId>org.apache.velocity</groupId> <artifactId>velocity-engine-core</artifactId> <version>2.2</version> </dependency>
本次我們選用 freemarker 作為模板
2、配置信息
在 application.yml 文件中,配置 mybatis-plus 的信息
# mybatis配置 mybatis-plus: # xml文件路徑 mapper-locations: classpath:mapper/*.xml # 實體類路徑 type-aliases-package: com.zyxx.sbm.entity configuration: # 駝峰轉換 map-underscore-to-camel-case: true # 是否開啟緩存 cache-enabled: false # 打印sql log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 全局配置 global-config: # 數據庫字段駝峰下劃線轉換 db-column-underline: true # id自增類型(數據庫id自增) id-type: 0
我們主要配置了:
/** * 數據庫ID自增 */ AUTO(0), /** * 該類型為未設置主鍵類型(注解里等于跟隨全局,全局里約等于 INPUT) */ NONE(1), /** * 用戶輸入ID * <p>該類型可以通過自己注冊自動填充插件進行填充</p> */ INPUT(2), /* 以下3種類型、只有當插入對象ID 為空,才自動填充。 */ /** * 分配ID (主鍵類型為number或string), * 默認實現類 {@link com.baomidou.mybatisplus.core.incrementer.DefaultIdentifierGenerator}(雪花算法) * * @since 3.3.0 */ ASSIGN_ID(3), /** * 分配UUID (主鍵類型為 string) * 默認實現類 {@link com.baomidou.mybatisplus.core.incrementer.DefaultIdentifierGenerator}(UUID.replace("-","")) */ ASSIGN_UUID(4);
MyBatis-Plus 默認的是推特的“雪花算法”,但是這樣生成的主鍵 id 會比較長,本次我們選擇數據庫自增策略
我們還需要在項目啟動類加上
@MapperScan("com.zyxx.sbm.mapper") @ComponentScan(basePackages = {"com.zyxx"})
掃描我們 mapper 包下面的文件,有時你會發現不在啟動類當前包下面的文件無法掃描,于是加上第二個注解,掃描其他文件
3、自動生成代碼類
import com.baomidou.mybatisplus.core.exceptions.MybatisPlusException; 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 org.apache.commons.lang3.StringUtils; import java.util.ArrayList; import java.util.List; import java.util.Scanner; /** * 代碼生成器 * * @Author Lizhou */ 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(); // TODO 全局配置 GlobalConfig gc = new GlobalConfig(); String projectPath = System.getProperty("user.dir"); // 生成文件的輸出目錄【默認 D 盤根目錄】 gc.setOutputDir(projectPath + "/src/main/java"); // 作者 gc.setAuthor("lizhou"); // 是否打開輸出目錄 gc.setOpen(false); // controller 命名方式,注意 %s 會自動填充表實體屬性 gc.setControllerName("%sController"); // service 命名方式 gc.setServiceName("%sService"); // serviceImpl 命名方式 gc.setServiceImplName("%sServiceImpl"); // mapper 命名方式 gc.setMapperName("%sMapper"); // xml 命名方式 gc.setXmlName("%sMapper"); // 開啟 swagger2 模式 gc.setSwagger2(true); // 是否覆蓋已有文件 gc.setFileOverride(true); // 是否開啟 ActiveRecord 模式 gc.setActiveRecord(true); // 是否在xml中添加二級緩存配置 gc.setEnableCache(false); // 是否開啟 BaseResultMap gc.setBaseResultMap(true); // XML columList gc.setBaseColumnList(false); // 全局 相關配置 mpg.setGlobalConfig(gc); // TODO 數據源配置 DataSourceConfig dsc = new DataSourceConfig(); dsc.setUrl("jdbc:mysql://127.0.0.1:3306/sbm?useUnicode=true&useJDBCCompliantTimezoneShift=true&useLegacyDatetimeCode=false&serverTimezone=UTC&useSSL=true&characterEncoding=UTF-8"); dsc.setDriverName("com.mysql.jdbc.Driver"); dsc.setUsername("root"); dsc.setPassword("123456"); mpg.setDataSource(dsc); // TODO 包配置 PackageConfig pc = new PackageConfig(); // 父包名。如果為空,將下面子包名必須寫全部, 否則就只需寫子包名 pc.setParent("com.zyxx.sbm"); // Entity包名 pc.setEntity("entity"); // Service包名 pc.setService("service"); // Service Impl包名 pc.setServiceImpl("service.impl"); mpg.setPackageInfo(pc); // TODO 自定義配置 InjectionConfig cfg = new InjectionConfig() { @Override public void initMap() { // to do nothing } }; // 輸出文件配置 List<FileOutConfig> focList = new ArrayList<>(); focList.add(new FileOutConfig("/templates/mapper.xml.ftl") { @Override public String outputFile(TableInfo tableInfo) { // 自定義輸入文件名稱 return projectPath + "/src/main/resources/mapper/" + tableInfo.getEntityName() + "Mapper.xml"; } }); // 自定義輸出文件 cfg.setFileOutConfigList(focList); mpg.setCfg(cfg); mpg.setTemplate(new TemplateConfig().setXml(null)); // TODO 策略配置 StrategyConfig strategy = new StrategyConfig(); // 數據庫表映射到實體的命名策略,駝峰原則 strategy.setNaming(NamingStrategy.underline_to_camel); // 字數據庫表字段映射到實體的命名策略,駝峰原則 strategy.setColumnNaming(NamingStrategy.underline_to_camel); // 實體是否生成 serialVersionUID strategy.setEntitySerialVersionUID(false); // 是否生成實體時,生成字段注解 strategy.setEntityTableFieldAnnotationEnable(true); // 使用lombok strategy.setEntityLombokModel(true); // 設置邏輯刪除鍵 strategy.setLogicDeleteFieldName("del_flag"); // TODO 指定生成的bean的數據庫表名 strategy.setInclude(scanner("表名,多個英文逗號分割").split(",")); // 駝峰轉連字符 strategy.setControllerMappingHyphenStyle(true); mpg.setStrategy(strategy); // 選擇 freemarker 引擎需要指定如下加,注意 pom 依賴必須有! mpg.setTemplateEngine(new FreemarkerTemplateEngine()); mpg.execute(); } }
我們需要改變的就是:
三、開發進行中
1、創建數據表
我們創建一個用戶信息表 user_info
drop table if exists user_info; /*==============================================================*/ /* Table: user_info */ /*==============================================================*/ create table user_info ( id bigint(20) not null auto_increment comment '主鍵id', account varchar(32) comment '賬號', password varchar(32) comment '密碼', name varchar(32) comment '姓名', phone varchar(11) comment '電話', avatar varchar(255) comment '頭像', sex tinyint(1) comment '性別(0--未知1--男2--女)', create_time datetime comment '創建時間', create_user bigint(20) comment '創建人', status tinyint(1) default 0 comment '狀態(0--正常1--凍結)', del_flag tinyint(1) default 0 comment '刪除狀態(0,正常,1已刪除)', primary key (id) ) type = InnoDB; alter table user_info comment '用戶信息表';
2、生成代碼
我們利用剛剛創建的自動生成代碼類,生成關于 user_info 數據表的 controller、service、mapper、xml、entity 等文件
生成方法:
生成的文件就自動放在我們配置的包下面
3、代碼鑒賞
UserInfo.java 文件
import com.baomidou.mybatisplus.annotation.*; import com.baomidou.mybatisplus.extension.activerecord.Model; import com.zyxx.common.annotation.Dict; import io.swagger.annotations.ApiModel; import io.swagger.annotations.ApiModelProperty; import lombok.Data; import lombok.EqualsAndHashCode; import lombok.experimental.Accessors; import java.io.Serializable; /** * <p> * 用戶信息表 * </p> * * @author lizhou * @since 2020-07-06 */ @Data @EqualsAndHashCode(callSuper = false) @Accessors(chain = true) @TableName("sys_user_info") @ApiModel(value="SysUserInfo對象", description="用戶信息表") public class UserInfo extends Model<UserInfo> { @ApiModelProperty(value = "ID") @TableId(value = "id", type = IdType.AUTO) private Long id; @ApiModelProperty(value = "登錄賬號") @TableField("account") private String account; @ApiModelProperty(value = "登錄密碼") @TableField("password") private String password; @ApiModelProperty(value = "姓名") @TableField("name") private String name; @ApiModelProperty(value = "電話") @TableField("phone") private String phone; @ApiModelProperty(value = "頭像") @TableField("avatar") private String avatar; @ApiModelProperty(value = "性別(0--未知1--男2--女)") @TableField("sex") private Integer sex; @ApiModelProperty(value = "狀態(0--正常1--凍結)") @TableField("status") private Integer status; @ApiModelProperty(value = "創建時間") @TableField("create_time") private String createTime; @ApiModelProperty(value = "創建人") @TableField("create_user") private Long createUser; @ApiModelProperty(value = "刪除狀態(0--未刪除1--已刪除)") @TableField("del_flag") @TableLogic private Integer delFlag; @Override protected Serializable pkVal() { return this.id; } }
UserInfoMapper.java 文件
import com.baomidou.mybatisplus.core.mapper.BaseMapper; import com.zyxx.sbm.entity.UserInfo; /** * <p> * 用戶信息表 Mapper 接口 * </p> * * @author lizhou * @since 2020-07-06 */ public interface UserInfoMapper extends BaseMapper<UserInfo> { }
繼承了 BaseMapper 抽象類,使得有了 CRUD 的基本方法
UserInfoMapper.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.zyxx.sbm.mapper.UserInfoMapper"> <!-- 通用查詢映射結果 --> <resultMap id="BaseResultMap" type="com.zyxx.sbm.entity.UserInfo"> <id column="id" property="id" /> <result column="account" property="account" /> <result column="password" property="password" /> <result column="name" property="name" /> <result column="phone" property="phone" /> <result column="avatar" property="avatar" /> <result column="sex" property="sex" /> <result column="status" property="status" /> <result column="create_time" property="createTime" /> <result column="create_user" property="createUser" /> <result column="del_flag" property="delFlag" /> </resultMap> </mapper>
UserInfoService.java 文件
import com.baomidou.mybatisplus.extension.service.IService; import com.zyxx.common.utils.LayTableResult; import com.zyxx.common.utils.ResponseResult; import com.zyxx.sbm.entity.UserInfo; /** * <p> * 用戶信息表 服務類 * </p> * * @author lizhou * @since 2020-07-06 */ public interface UserInfoService extends IService<UserInfo> { }
UserInfoServiceImpl.java 文件
import com.zyxx.sbm.entity.UserInfo; import com.zyxx.sbm.service.UserInfoService; import org.springframework.stereotype.Service; import java.util.List; /** * <p> * 用戶信息表 服務實現類 * </p> * * @author lizhou * @since 2020-07-06 */ @Service public class UserInfoServiceImpl extends ServiceImpl<UserInfoMapper, UserInfo> implements UserInfoService { }
UserInfoController.java 文件
import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.*; /** * <p> * 用戶信息表 前端控制器 * </p> * * @author lizhou * @since 2020-07-06 */ @Controller @RequestMapping("/user-info") public class UserInfoController { }
四、開始使用
1、分頁查詢
我們在 service 的實現類中寫一個 分頁查詢用戶的方法,listUserInfo()
@Override public void listUserInfo(Integer page, Integer limit, UserInfo UserInfo) { QueryWrapper<SysUserInfo> queryWrapper = new QueryWrapper<>(); if (StringUtils.isNotBlank(sysUserInfo.getName())) { queryWrapper.like("name", sysUserInfo.getName()); } queryWrapper.orderByDesc("create_time"); IPage<SysUserInfo> iPage = page(new Page<>(page, limit), queryWrapper); long total = iPage.getTotal(); List<UserInfo> list = iPage.getRecords(); }
我們傳入了查詢條件:根據用戶名稱查詢,再根據用戶的注冊時間倒序排序,最后分頁查詢
我們還可以使用 lambda 的方式來寫查詢條件,例如:
queryWrapper.lambda().eq(SysUserInfo::getName, sysUserInfo.getName());
這樣,就能避免寫數據庫字段的時候寫錯了
2、分頁插件
注意:這時候,我們查詢數據,發現分頁并沒有起作用,我們還需要配置 MyBatis-Plus 的分頁插件
創建 MybatisPlusConfig.java 文件
package com.zyxx.common.mybatis; import com.baomidou.mybatisplus.extension.plugins.PaginationInterceptor; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.transaction.annotation.EnableTransactionManagement; /** * mybatis配置 * * @Author Lizhou */ @EnableTransactionManagement @Configuration public class MybatisPlusConfig { /** * 分頁插件 */ @Bean public PaginationInterceptor paginationInterceptor() { return new PaginationInterceptor(); } }
這時候,我們的分頁就正常了,分頁默認從1開始,所以不用考慮page = (page-1)*limit 才能使用,1-20的數據,就傳入 1,20,20-40的數據就傳入 2,20 就可以了
其它的增刪改查的方法也是使用很方便的,如果涉及到多表聯查,我們還是在 xml 文件中寫 sql 吧
五、總結
看完上述內容,你們掌握SpringBoot中實現整合MyBatis-Plus的方法的方法了嗎?如果還想學到更多技能或想了解更多相關內容,歡迎關注億速云行業資訊頻道,感謝各位的閱讀!
免責聲明:本站發布的內容(圖片、視頻和文字)以原創、轉載和分享為主,文章觀點不代表本網站立場,如果涉及侵權請聯系站長郵箱:is@yisu.com進行舉報,并提供相關證據,一經查實,將立刻刪除涉嫌侵權內容。