MyBatis-Plus使用

mybatis-plus使用簡(jiǎn)介

一、簡(jiǎn)介

MyBatis-Plus(簡(jiǎn)稱(chēng) MP)是一個(gè) MyBatis 的增強(qiáng)工具,在 MyBatis 的基礎(chǔ)上只做增強(qiáng)不做改變孽水,為簡(jiǎn)化開(kāi)發(fā)、提高效率而生。官網(wǎng)是:https://mp.baomidou.com/

特性

  • 無(wú)侵入:只做增強(qiáng)不做改變肌访,引入它不會(huì)對(duì)現(xiàn)有工程產(chǎn)生影響,如絲般順滑
  • 損耗小:?jiǎn)?dòng)即會(huì)自動(dòng)注入基本 CURD艇劫,性能基本無(wú)損耗吼驶,直接面向?qū)ο蟛僮?/li>
  • 強(qiáng)大的 CRUD 操作:內(nèi)置通用 Mapper、通用 Service店煞,僅僅通過(guò)少量配置即可實(shí)現(xiàn)單表大部分 CRUD 操作蟹演,更有強(qiáng)大的條件構(gòu)造器,滿(mǎn)足各類(lèi)使用需求
  • 支持 Lambda 形式調(diào)用:通過(guò) Lambda 表達(dá)式顷蟀,方便的編寫(xiě)各類(lèi)查詢(xún)條件酒请,無(wú)需再擔(dān)心字段寫(xiě)錯(cuò)
  • 支持主鍵自動(dòng)生成:支持多達(dá) 4 種主鍵策略(內(nèi)含分布式唯一 ID 生成器 - Sequence),可自由配置鸣个,完美解決主鍵問(wèn)題
  • 支持 ActiveRecord 模式:支持 ActiveRecord 形式調(diào)用羞反,實(shí)體類(lèi)只需繼承 Model 類(lèi)即可進(jìn)行強(qiáng)大的 CRUD 操作
  • 支持自定義全局通用操作:支持全局通用方法注入( Write once, use anywhere )
  • 內(nèi)置代碼生成器:采用代碼或者 Maven 插件可快速生成 Mapper 、 Model 囤萤、 Service 昼窗、 Controller 層代碼,支持模板引擎涛舍,更有超多自定義配置等您來(lái)使用
  • 內(nèi)置分頁(yè)插件:基于 MyBatis 物理分頁(yè)澄惊,開(kāi)發(fā)者無(wú)需關(guān)心具體操作,配置好插件之后,寫(xiě)分頁(yè)等同于普通 List 查詢(xún)
  • 分頁(yè)插件支持多種數(shù)據(jù)庫(kù):支持 MySQL掸驱、MariaDB窘哈、Oracle、DB2亭敢、H2滚婉、HSQL、SQLite帅刀、Postgre让腹、SQLServer 等多種數(shù)據(jù)庫(kù)
  • 內(nèi)置性能分析插件:可輸出 Sql 語(yǔ)句以及其執(zhí)行時(shí)間,建議開(kāi)發(fā)測(cè)試時(shí)啟用該功能扣溺,能快速揪出慢查詢(xún)
  • 內(nèi)置全局?jǐn)r截插件:提供全表 delete 骇窍、 update 操作智能分析阻斷,也可自定義攔截規(guī)則锥余,預(yù)防誤操作

二腹纳、使用

1、添加依賴(lài)

<!-- mybatisPlus 核心庫(kù) -->
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.3.1</version>
</dependency>
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-generator</artifactId>
    <version>3.3.1.tmp</version>
</dependency>
<dependency>
    <groupId>org.freemarker</groupId>
    <artifactId>freemarker</artifactId>
</dependency>

這里列出了三個(gè)依賴(lài)驱犹,數(shù)據(jù)庫(kù)操作的依賴(lài)沒(méi)有在這里列出嘲恍,這三個(gè)依賴(lài)是接下來(lái)需要用到的,第一個(gè)依賴(lài)是mybatis-plus的核心依賴(lài)雄驹,第二個(gè)與第三個(gè)依賴(lài)是mybatis-plus的代碼生成器需要用到的依賴(lài)佃牛,因?yàn)閙ybatis-plus是基于模板引擎的模板來(lái)生成代碼和xml文件的,所以需要引入模板引擎的依賴(lài)医舆,freemarker只是其中一種俘侠。

2、application.yml

server:
  port: 8080
spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    type: com.alibaba.druid.pool.DruidDataSource
    username: root
    password: root
    url: jdbc:mysql://localhost:3306/mydb?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=GMT%2b8&allowPublicKeyRetrieval=true
mybatis-plus:
  mapper-locations: classpath:mapper/*.xml

使用了druid數(shù)據(jù)庫(kù)蔬将,由于使用了mybatis-plus所以之前對(duì)mybatis的設(shè)置現(xiàn)在就變成了對(duì)mybatis-plus的設(shè)置爷速。

3、CodeGenarator

在你的包下新建一個(gè)類(lèi)CodeGenarator.java

package com.qianfeng.mybatis;

import com.baomidou.mybatisplus.annotation.IdType;
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;


// 演示例子霞怀,執(zhí)行 main 方法控制臺(tái)輸入模塊表名回車(chē)自動(dòng)生成對(duì)應(yīng)項(xiàng)目目錄中
public class CodeGenerator {

    /**
     * <p>
     * 讀取控制臺(tái)內(nèi)容
     * </p>
     */
    public static String scanner(String tip) {
        Scanner scanner = new Scanner(System.in);
        StringBuilder help = new StringBuilder();
        help.append("請(qǐng)輸入" + tip + ":");
        System.out.println(help.toString());
        if (scanner.hasNext()) {
            String ipt = scanner.next();
            if (StringUtils.isNotEmpty(ipt)) {
                return ipt;
            }
        }
        throw new MybatisPlusException("請(qǐng)輸入正確的" + tip + "惫东!");
    }

    public static void main(String[] args) {
        // 代碼生成器
        AutoGenerator mpg = new AutoGenerator();

        // 全局配置
        GlobalConfig gc = new GlobalConfig();
        String projectPath = System.getProperty("user.dir");
        //生成的代碼所在的目錄
        gc.setOutputDir(projectPath + "/platform_entity/src/main/java");
        //文檔注釋中的作者名
        gc.setAuthor("huwenlong");
        //在xml文件中是否創(chuàng)建BaseResultMap
        gc.setBaseResultMap(true);
        gc.setOpen(false);
        gc.setBaseColumnList(false);
        gc.setIdType(IdType.AUTO);
        gc.setFileOverride(true);
        //文件命名
        gc.setControllerName("%sController");
        gc.setServiceName("%sService");
        gc.setServiceImplName("%sServiceImpl");
        gc.setXmlName("%sMapper");
        gc.setMapperName("%sMapper");
        // gc.setSwagger2(true); 實(shí)體屬性 Swagger2 注解
        mpg.setGlobalConfig(gc);

        // 數(shù)據(jù)源配置
        DataSourceConfig dsc = new DataSourceConfig();
        dsc.setUrl("jdbc:mysql://localhost:3306/mydb?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=GMT%2b8&allowPublicKeyRetrieval=true");
        // dsc.setSchemaName("public");
        dsc.setDriverName("com.mysql.cj.jdbc.Driver");
        dsc.setUsername("root");
        dsc.setPassword("huwenlong");
        mpg.setDataSource(dsc);

        // 包配置
        PackageConfig pc = new PackageConfig();
        pc.setModuleName(null);
        //設(shè)置父包名
        pc.setParent("com.qianfeng");
        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<>();
        // 自定義配置會(huì)被優(yōu)先輸出
        focList.add(new FileOutConfig(templatePath) {
            @Override
            public String outputFile(TableInfo tableInfo) {
                // 自定義輸出文件名 , 如果你 Entity 設(shè)置了前后綴里烦、此處注意 xml 的名稱(chēng)會(huì)跟著發(fā)生變化T渌狻禁谦!
                //設(shè)置xml文件的輸出路徑
                return projectPath + "/platform_entity/src/main/resources/mapper/"
                       + tableInfo.getEntityName() + "Mapper" + StringPool.DOT_XML;
            }
        });
        /*
        cfg.setFileCreate(new IFileCreate() {
            @Override
            public boolean isCreate(ConfigBuilder configBuilder, FileType fileType, String filePath) {
                // 判斷自定義文件夾是否需要?jiǎng)?chuàng)建
                checkDir("調(diào)用默認(rèn)方法創(chuàng)建的目錄");
                return false;
            }
        });
        */
        cfg.setFileOutConfigList(focList);
        mpg.setCfg(cfg);

        // 配置模板
        TemplateConfig templateConfig = new TemplateConfig();

        // 配置自定義輸出模板
        //指定自定義模板路徑胁黑,注意不要帶上.ftl/.vm, 會(huì)根據(jù)使用的模板引擎自動(dòng)識(shí)別
        // templateConfig.setEntity("templates/entity2.java");
        // templateConfig.setService();
        // templateConfig.setController();
        //不在mapper包下生成xml文件
        templateConfig.setXml(null);
        mpg.setTemplate(templateConfig);

        // 策略配置
        StrategyConfig strategy = new StrategyConfig();
        strategy.setNaming(NamingStrategy.underline_to_camel);
        strategy.setColumnNaming(NamingStrategy.underline_to_camel);
        // strategy.setSuperEntityClass("你自己的父類(lèi)實(shí)體,沒(méi)有就不用設(shè)置!");
        strategy.setEntityLombokModel(true);
        strategy.setRestControllerStyle(true);
        // 公共父類(lèi)
        // strategy.setSuperControllerClass("你自己的父類(lèi)控制器,沒(méi)有就不用設(shè)置!");
        // 寫(xiě)于父類(lèi)中的公共字段
        // strategy.setSuperEntityColumns("id");
        strategy.setInclude(scanner("表名,多個(gè)英文逗號(hào)分割").split(","));
        strategy.setControllerMappingHyphenStyle(true);
        strategy.setTablePrefix(pc.getModuleName() + "_");
        mpg.setStrategy(strategy);
        mpg.setTemplateEngine(new FreemarkerTemplateEngine());
        mpg.execute();
    }

}

這些配置的詳細(xì)信息可以在這個(gè)頁(yè)面查看:https://mp.baomidou.com/config/generator-config.html州泊。

需要修改的地方有:全局配置(生成的代碼所在的目錄丧蘸、代碼注釋中的作者名)、數(shù)據(jù)源配置(url、username力喷、password刽漂、drivername)。運(yùn)行這個(gè)main方法后按照控制臺(tái)輸出的提示輸入需要生成代碼的數(shù)據(jù)庫(kù)表名回車(chē)就可以了(多個(gè)數(shù)據(jù)庫(kù)之間用英文逗號(hào)分割)弟孟。

注意:由于我使用的時(shí)候開(kāi)發(fā)的是微服務(wù)項(xiàng)目贝咙,一個(gè)項(xiàng)目中有很多個(gè)模塊,我是在一個(gè)模塊中生成的java代碼拂募,所以我的全局配置中的生成的代碼所在的目錄較長(zhǎng)庭猩,如果你開(kāi)發(fā)的是單體項(xiàng)目,就直接從/src開(kāi)始陈症,xml文件的輸出路徑也是蔼水,切記切記。

4录肯、分頁(yè)插件

新建一個(gè)類(lèi)名為MybatisPlusConfig趴腋。

package com.qianfeng.mybatis;

import com.baomidou.mybatisplus.extension.plugins.PaginationInterceptor;
import com.baomidou.mybatisplus.extension.plugins.pagination.optimize.JsqlParserCountOptimize;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.transaction.annotation.EnableTransactionManagement;

@EnableTransactionManagement
@Configuration
public class MybatisPlusConfig {
    /**
     * 分頁(yè)插件
     */
    @Bean
    public PaginationInterceptor paginationInterceptor() {
        PaginationInterceptor paginationInterceptor = new PaginationInterceptor();
        // 設(shè)置請(qǐng)求的頁(yè)面大于最大頁(yè)后操作, true調(diào)回到首頁(yè)论咏,false 繼續(xù)請(qǐng)求  默認(rèn)false
        paginationInterceptor.setOverflow(false);
        // 設(shè)置最大單頁(yè)限制數(shù)量优炬,默認(rèn) 500 條,-1 不受限制
        paginationInterceptor.setLimit(500);
        // 開(kāi)啟 count 的 join 優(yōu)化,只針對(duì)部分 left join
        paginationInterceptor.setCountSqlParser(new JsqlParserCountOptimize(true));
        return paginationInterceptor;
    }
}

測(cè)試類(lèi):

package com.qianfeng;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.qianfeng.entity.Hotel;
import com.qianfeng.mapper.HotelMapper;
import org.junit.jupiter.api.Test;
import org.springframework.boot.test.context.SpringBootTest;


import javax.annotation.Resource;
import java.util.List;
@SpringBootTest
public class pageTest {
    @Resource
    private HotelMapper hotelMapper;
    @Test
    public void testPage(){
        //兩個(gè)參數(shù)分別是開(kāi)始下標(biāo)和查詢(xún)的個(gè)數(shù)
        IPage<Hotel> hotelPage = new Page<>(0,5);
        IPage<Hotel> page = hotelMapper.selectPage(hotelPage, null);
        List<Hotel> records = page.getRecords();
        for (Hotel record : records) {
            System.out.println(record);
        }
    }
}
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末厅贪,一起剝皮案震驚了整個(gè)濱河市穿剖,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌卦溢,老刑警劉巖糊余,帶你破解...
    沈念sama閱讀 211,639評(píng)論 6 492
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異单寂,居然都是意外死亡贬芥,警方通過(guò)查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,277評(píng)論 3 385
  • 文/潘曉璐 我一進(jìn)店門(mén)宣决,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)蘸劈,“玉大人,你說(shuō)我怎么就攤上這事尊沸⊥” “怎么了?”我有些...
    開(kāi)封第一講書(shū)人閱讀 157,221評(píng)論 0 348
  • 文/不壞的土叔 我叫張陵洼专,是天一觀(guān)的道長(zhǎng)棒掠。 經(jīng)常有香客問(wèn)我,道長(zhǎng)屁商,這世上最難降的妖魔是什么烟很? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 56,474評(píng)論 1 283
  • 正文 為了忘掉前任,我火速辦了婚禮,結(jié)果婚禮上雾袱,老公的妹妹穿的比我還像新娘恤筛。我一直安慰自己,他們只是感情好芹橡,可當(dāng)我...
    茶點(diǎn)故事閱讀 65,570評(píng)論 6 386
  • 文/花漫 我一把揭開(kāi)白布毒坛。 她就那樣靜靜地躺著,像睡著了一般林说。 火紅的嫁衣襯著肌膚如雪粘驰。 梳的紋絲不亂的頭發(fā)上,一...
    開(kāi)封第一講書(shū)人閱讀 49,816評(píng)論 1 290
  • 那天述么,我揣著相機(jī)與錄音蝌数,去河邊找鬼。 笑死度秘,一個(gè)胖子當(dāng)著我的面吹牛顶伞,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播剑梳,決...
    沈念sama閱讀 38,957評(píng)論 3 408
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼唆貌,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來(lái)了垢乙?” 一聲冷哼從身側(cè)響起锨咙,我...
    開(kāi)封第一講書(shū)人閱讀 37,718評(píng)論 0 266
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎追逮,沒(méi)想到半個(gè)月后酪刀,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 44,176評(píng)論 1 303
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡钮孵,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,511評(píng)論 2 327
  • 正文 我和宋清朗相戀三年骂倘,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片巴席。...
    茶點(diǎn)故事閱讀 38,646評(píng)論 1 340
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡历涝,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出漾唉,到底是詐尸還是另有隱情荧库,我是刑警寧澤,帶...
    沈念sama閱讀 34,322評(píng)論 4 330
  • 正文 年R本政府宣布赵刑,位于F島的核電站分衫,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏料睛。R本人自食惡果不足惜丐箩,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,934評(píng)論 3 313
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望恤煞。 院中可真熱鬧屎勘,春花似錦、人聲如沸居扒。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 30,755評(píng)論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)喜喂。三九已至瓤摧,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間玉吁,已是汗流浹背照弥。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 31,987評(píng)論 1 266
  • 我被黑心中介騙來(lái)泰國(guó)打工, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留进副,地道東北人这揣。 一個(gè)月前我還...
    沈念sama閱讀 46,358評(píng)論 2 360
  • 正文 我出身青樓,卻偏偏與公主長(zhǎng)得像影斑,于是被迫代替她去往敵國(guó)和親给赞。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 43,514評(píng)論 2 348