说明:

  以下出现的第一个入参boolean condition表示该条件是否加入最后生成的sql中

  以下代码块内的多个方法均为从上往下补全个别boolean类型的入参,默认为true

  以下出现的泛型Param均为Wrapper的子类实例(均具有AbstractWrapper的所有方法)

  以下方法在入参中出现的R为泛型,在普通wrapper中是String,在LambdaWrapper中是函数(例:Entity::getId,Entity为实体类,getId为字段id的getMethod)

  以下方法入参中的R column均表示数据库字段,当R具体类型为String时则为数据库字段名(字段名是数据库关键字的自己用转义符包裹!)!而不是实体类数据字段名!!!,另当R具体类型为SFunction时项目runtime不支持eclipse自家的编译器!!!

  以下举例均为使用普通wrapper,入参为Map和List的均以json形式表现!

  使用中如果入参的Map或者List为空,则不会加入最后生成的sql中!!!

警告:

  wrapper 很重

  传输 wrapper 可以类比为你的 controller 用 map 接收值(开发一时爽,维护火葬场)

  正确的 RPC 调用姿势是写一个 DTO 进行传输,被调用方再根据 DTO 执行相应的操作

  我们拒绝接受任何关于 RPC 传输 Wrapper 报错相关的 issue 甚至 pr

1. AbstractWrapper

说明:QueryWrapper(LambdaQueryWrapper) 和 UpdateWrapper(LambdaUpdateWrapper) 的父类。用于生成 sql 的 where 条件, entity 属性也用于生成 sql 的 where 条件

注意:  entity 生成的 where 条件与 使用各个 api 生成的 where 条件没有任何关联行为

1.1 allEq (全部eq 或个别isNull)

allEq(Map<R, V> params)
allEq(Map<R, V> params, boolean null2IsNull)
allEq(boolean condition, Map<R, V> params, boolean null2IsNull)

个别参数说明:

  params : key为数据库字段名,value为字段值

  null2IsNull : 为true则在map的value为null时调用 isNull 方法,为false时则忽略value为null的

例1: allEq({id:1,name:"老王",age:null})--->id = 1 and name = '老王' and age is null

例2: allEq({id:1,name:"老王",age:null}, false)--->id = 1 and name = '老王'

1.2 eq (等于 =)

eq(R column, Object val)
eq(boolean condition, R column, Object val)

例: eq("name", "老王")--->name = '老王'

1.3 ne(不等于 <>)

ne(R column, Object val)
ne(boolean condition, R column, Object val)

例: ne("name", "老王")--->name <> '老王'

1.4 gt(大于 >)

gt(R column, Object val)
gt(boolean condition, R column, Object val)

例: gt("age", 18)--->age > 18

1.5 ge(大于等于 >=)

ge(R column, Object val)
ge(boolean condition, R column, Object val)

例: ge("age", 18)--->age >= 18

1.6 lt(小于 <)

lt(R column, Object val)
lt(boolean condition, R column, Object val)

例: lt("age", 18)--->age < 18

1.7 le(小于等于 <=)

le(R column, Object val)
le(boolean condition, R column, Object val)

例: le("age", 18)--->age <= 18

1.8 between(BETWEEN 值1 AND 值2)

between(R column, Object val1, Object val2)
between(boolean condition, R column, Object val1, Object val2)

例: between("age", 18, 30)--->age between 18 and 30

1.9 notBetween(NOT BETWEEN 值1 AND 值2)

notBetween(R column, Object val1, Object val2)
notBetween(boolean condition, R column, Object val1, Object val2)

例: notBetween("age", 18, 30)--->age not between 18 and 30

1.10 like(LIKE '%值%')

like(R column, Object val)
like(boolean condition, R column, Object val)

例: like("name", "王")--->name like '%王%'

1.11 notLike(NOT LIKE '%值%')

notLike(R column, Object val)
notLike(boolean condition, R column, Object val)

例: notLike("name", "王")--->name not like '%王%'

1.12 likeLeft(LIKE '%值')

likeLeft(R column, Object val)
likeLeft(boolean condition, R column, Object val)

例: likeLeft("name", "王")--->name like '%王'

1.13 likeRight(LIKE '值%')

likeRight(R column, Object val)
likeRight(boolean condition, R column, Object val)

例: likeRight("name", "王")--->name like '王%'

1.14 isNull(字段 IS NULL)

isNull(R column)
isNull(boolean condition, R column)

例: isNull("name")--->name is null

1.15 isNotNull(字段 IS NOT NULL)

isNotNull(R column)
isNotNull(boolean condition, R column)

例: isNotNull("name")--->name is not null

1.16 in(字段 IN (字段 IN (v0, v1, ...)),参数可以是Collection的实现类,或者数组

in(R column, Collection<?> value)
in(boolean condition, R column, Collection<?> value)
in(R column, Object... values)
in(boolean condition, R column, Object... values)

例: in("age",{1,2,3})--->age in (1,2,3)
例: in("age", 1, 2, 3)--->age in (1,2,3)

1.17 notIn(NOT IN (v0, v1, ...)),参数可以是Collection的实现类,或者数组

notIn(R column, Collection<?> value)
notIn(boolean condition, R column, Collection<?> value)
notIn(R column, Object... values)
notIn(boolean condition, R column, Object... values)

例: notIn("age",{1,2,3})--->age not in (1,2,3)
例: notIn("age", 1, 2, 3)--->age not in (1,2,3)

1.18 inSql(字段 IN ( sql语句 ))

inSql(R column, String inValue)
inSql(boolean condition, R column, String inValue)

例: inSql("age", "1,2,3,4,5,6")--->age in (1,2,3,4,5,6)
例: inSql("id", "select id from table where id < 3")--->id in (select id from table where id < 3)

1.19 notInSql(字段 NOT IN ( sql语句 ))

notInSql(R column, String inValue)
notInSql(boolean condition, R column, String inValue)

例: notInSql("age", "1,2,3,4,5,6")--->age not in (1,2,3,4,5,6)
例: notInSql("id", "select id from table where id < 3")--->age not in (select id from table where id < 3)

1.20 groupBy(分组:GROUP BY 字段, ...)

groupBy(R... columns)
groupBy(boolean condition, R... columns)

例: groupBy("id", "name")--->group by id,name

1.21 orderByAsc(排序:ORDER BY 字段, ... ASC)

orderByAsc(R... columns)
orderByAsc(boolean condition, R... columns)

例: orderByAsc("id", "name")--->order by id ASC,name ASC

1.22 orderByDesc(排序:ORDER BY 字段, ... DESC)

orderByDesc(R... columns)
orderByDesc(boolean condition, R... columns)

例: orderByDesc("id", "name")--->order by id DESC,name DESC

1.23 orderBy(排序:ORDER BY 字段, ...)

orderBy(boolean condition, boolean isAsc, R... columns)

例: orderBy(true, true, "id", "name")--->order by id ASC,name ASC

1.24 having(HAVING ( sql语句 ))

having(String sqlHaving, Object... params)
having(boolean condition, String sqlHaving, Object... params)

例: having("sum(age) > 10")--->having sum(age) > 10
例: having("sum(age) > {0}", 11)--->having sum(age) > 11

1.25 or(拼接 OR)

or()
or(boolean condition)
or(Consumer<Param> consumer)
or(boolean condition, Consumer<Param> consumer)

注意事项: 主动调用or表示紧接着下一个方法不是用and连接!(不调用or则默认为使用and连接)
例: eq("id",1).or().eq("name","老王")--->id = 1 or name = '老王'
例: or(i -> i.eq("name", "李白").ne("status", "活着"))--->or (name = '李白' and status <> '活着')

1.26 and(AND 嵌套)

and(Consumer<Param> consumer)
and(boolean condition, Consumer<Param> consumer)

例: and(i -> i.eq("name", "李白").ne("status", "活着"))--->and (name = '李白' and status <> '活着')

1.27 nested(正常嵌套 不带 AND 或者 OR)

nested(Consumer<Param> consumer)
nested(boolean condition, Consumer<Param> consumer)

例: nested(i -> i.eq("name", "李白").ne("status", "活着"))--->(name = '李白' and status <> '活着')

1.28 apply(拼接 sql)

apply(String applySql, Object... params)
apply(boolean condition, String applySql, Object... params)

注意事项:该方法可用于数据库函数 动态入参的params对应前面applySql内部的{index}部分.这样是不会有sql注入风险的,反之会有!
例: apply("id = 1")--->id = 1
例: apply("date_format(dateColumn,'%Y-%m-%d') = '2008-08-08'")--->date_format(dateColumn,'%Y-%m-%d') = '2008-08-08'")
例: apply("date_format(dateColumn,'%Y-%m-%d') = {0}", "2008-08-08")--->date_format(dateColumn,'%Y-%m-%d') = '2008-08-08'")

1.29 last(无视优化规则直接拼接到 sql 的最后)

last(String lastSql)
last(boolean condition, String lastSql)

注意事项:只能调用一次,多次调用以最后一次为准 有sql注入的风险,请谨慎使用
例: last("limit 1")

1.30 exists(拼接 EXISTS ( sql语句 ))

exists(String existsSql)
exists(boolean condition, String existsSql)

例: exists("select id from table where age = 1")--->exists (select id from table where age = 1)

1.31 notExists(拼接 NOT EXISTS ( sql语句 ))

notExists(String notExistsSql)
notExists(boolean condition, String notExistsSql)

例: notExists("select id from table where age = 1")--->not exists (select id from table where age = 1)

2. QueryWrapper

说明:
  继承自 AbstractWrapper ,自身的内部属性 entity 也用于生成 where 条件
  及 LambdaQueryWrapper, 可以通过 new QueryWrapper().lambda() 方法获取

2.1 select(设置查询字段)

select(String... sqlSelect)
select(Predicate<TableFieldInfo> predicate)
select(Class<T> entityClass, Predicate<TableFieldInfo> predicate)

说明:
以上方分法为两类.
第二类方法为:过滤查询字段(主键除外),入参不包含 class 的调用前需要wrapper内的entity属性有值! 这两类方法重复调用以最后一次为准

例: select("id", "name", "age")
例: select(i -> i.getP

3. UpdateWrapper

说明:
  继承自 AbstractWrapper ,自身的内部属性 entity 也用于生成 where 条件
  及 LambdaUpdateWrapper, 可以通过 new UpdateWrapper().lambda() 方法获取!

3.1 set(SQL SET 字段)

set(String column, Object val)
set(boolean condition, String column, Object val)

例: set("name", "老李头")
例: set("name", "")--->数据库字段值变为空字符串
例: set("name", null)--->数据库字段值变为null

3.2 setSql(设置 SET 部分 SQL)

setSql(String sql)

例: setSql("name = '老李头'")

MyBatis-Plus使用(3)-条件构造器的更多相关文章

  1. mybatis plus的条件构造器

    我们在使用条件构造器的时候要使用QueryWrapper或者UpdateWrapper来充当条件语句来进行构造 QueryWrapper(LambdaQueryWrapper) 和 UpdateWra ...

  2. MyBatis:MyBatis-Plus条件构造器EntityWrapper

    EntityWrapper 简介 1. MybatisPlus 通过 EntityWrapper(简称 EW,MybatisPlus 封装的一个查询条件构造器)或者 Condition(与 EW 类似 ...

  3. 小书MybatisPlus第2篇-条件构造器的应用及总结

    一.条件构造器Wrapper Mybatis Plus为我们提供了如下的一些条件构造器,我们可以利用它们实现查询条件.删除条件.更新条件的构造. 条件构造器用于给如下的Mapper方法传参,通常情况下 ...

  4. MyBatisPlus性能分析插件,条件构造器,代码自动生成器详解

    性能分析插件 我们在平时的开发中,会遇到一些慢sql,测试,druid MP(MyBatisPlus)也提供性能分析插件,如果超过这个时间就停止 不过官方在3.2版本的时候取消了,原因如下 条件构造器 ...

  5. Mybatis-Plus 实战完整学习笔记(十一)------条件构造器删除,修改,conditon

    1.修改功能--其他过滤方式跟select一样 /** * 修改条件构造器 * @throws SQLException */ @Test public void selectUpdate() thr ...

  6. Mybatis-Plus 实战完整学习笔记(十)------条件构造器核心用法大全(下)

    31.升序orderByAsc 31.升序orderByAsc List<Employee> employeeList = employeeMapper.selectList(new Qu ...

  7. Mybatis-Plus 实战完整学习笔记(九)------条件构造器核心用法大全(上)

    一.Mybatisplus通用(公共方法)CRUD,一共17种(3.0.3版),2.3系列也是这么多,这个新版本一定程度进行了改造和删减. 二.构造器UML图(3.0.3)-----实体包装器,主要用 ...

  8. MybatisPlus学习(四)条件构造器Wrapper方法详解

    文章目录 1.条件构造器 2.QueryWrapper 2.1.eq.ne 2.2.gt.ge.lt.le 2.3.between.notBetween 2.4.like.notLike.likeLe ...

  9. Mybatis-plus<三> MybatisPlus条件构造器

    Mybatis-plus<三> MybatisPlus条件构造器 Demo GitHub下载地址:https://github.com/RJvon/Mybatis_plus_demo My ...

  10. Mybatis-Plus - 条件构造器 QueryWrapper 的使用

    目录 前言 查询示例 基础代码 QueryWrapper 的基本使用 QueryWrapper 的lambada写法 LambadaQueryWrapper 的使用 LambdaQueryChainW ...

随机推荐

  1. 从零开始使用 Webpack 搭建 Vue3 开发环境

    从零开始使用 Webpack 搭建 Vue3 开发环境 创建项目 首先需要创建一个空目录,在该目录打开命令行,执行 npm init 命令创建一个项目,这个过程会提示输入一些内容,完成后会自动生成一个 ...

  2. 安装FeedReader添加RSS订阅

    #0x1 FeedReader FeedReader是一款功能齐全,界面优美的GTK+ 3RSS阅读器客户端,用于在线RSS服务. FeedReader目前支持Feedbin,Feedly,Fresh ...

  3. PHP使用array_filter查找二维数组中符合字段和字段值的数据集合

    1.方法: /** * 获取符合字段和字段值的数组集合 * @param array $data 待过滤数组 * @param string $field 要查找的字段 * @param $value ...

  4. Java加密与安全

    数据安全   什么是数据安全?假如Bob要给Alice发送一封邮件,在发送邮件的过程中,黑客可能会窃取到邮件的内容,所以我们需要防窃听:黑客也有可能会篡改邮件的内容,所以Alice必须要有能有去识别邮 ...

  5. python爬虫中对含中文的url处理以 及 Python3—UnicodeEncodeError 'ascii' codec can't encode characters in position

    在练习urllib操作中,遇到了url中含有中文字符的问题.比如http://dotamax.com/,看下源码的话,上方的搜索框的name=p,输入内容点击搜索以后,通过GET方法进行传递,比如我们 ...

  6. 008.Nginx静态资源

    一 Nginx静态资源概述 1.1 静态资源类型 Nginx作为静态资源Web服务器部署配置, 传输非常高效, 常常用于静态资源处理,请求以及动静分离.通常非服务器动态运行生成的文件属于静态资源. 类 ...

  7. Quartz.Net系列(十六):通过Plugins模式使用Xml方式配置Job和Trigger和自定义LogPrivider

    1.简单介绍 Quarz.Net中采用插件式来实现配置文件配置,通过XMLSchedulingDataProcessor类进行Xml数据处理 默认配置文件命名:quart_jobs.xml publi ...

  8. 命令模式(c++实现)

    命令模式 目录 命令模式 模式定义 模式动机 UML类图 源码实现 优点 缺点 模式定义 命令模式(Facade),将一个请求封装为一个对象,从而使你可用不同的请求对客户进行参数化:对请求排队或记录请 ...

  9. http连接池存在的问题

    连接的有效性检测是所有连接池都面临的一个通用问题,大部分HTTP服务器为了控制资源开销,并不会 永久的维护一个长连接,而是一段时间就会关闭该连接.放回连接池的连接,如果在服务器端已经关闭,客 户端是无 ...

  10. Atlassian Confluence 5.1.2 破解版部署

    Atlassian Confluence(简称Confluence)是一个专业的wiki程序.它是一个知识管理的工具,通过它可以实现团队成员之间的协作和知识共享.Confluence 不是一个开源软件 ...