Mybatis动态SQL实战:如何用OGNL表达式简化复杂查询(附避坑指南)

MyBatis字符串比较避坑指南:为什么你的if条件总是不生效? 本文深入解析了MyBatis动态SQL中字符串比较条件失效的常见问题,其根源在于OGNL表达式引擎的类型处理机制。文章提供了四种可靠的解决方案,包括使用`.toString()`方法、调换单双引号位置、使用常量以及自定义函数,并分享了空值处理、大小写敏感等复杂场景下的最佳实践与调试技巧,帮助开发者彻底规避此类陷阱。 阅读详情

MyBatis动态SQL实战:OGNL表达式的高阶应用与避坑指南

在Java持久层开发中,MyBatis因其灵活性和直观性备受开发者青睐。而真正让MyBatis在复杂业务场景中游刃有余的,是其动态SQL与OGNL表达式的深度结合。本文将带你突破基础用法,探索OGNL在条件构造、动态排序、批量操作等场景中的高阶应用,同时分享性能调优和安全防护的一线实战经验。

1. OGNL表达式核心机制解析

1.1 类型自动转换的底层逻辑

OGNL的类型转换机制远比表面看到的复杂。当处理age > '18'这样的表达式时,OGNL会自动将字符串'18'转换为Integer类型。但实际开发中我们常遇到这样的坑:

// 当age为String类型时的隐式转换
<if test="age > 30">  // 自动将String转为Integer比较
   AND age = #{age}
</if>

注意:隐式转换可能导致精度丢失,建议保持比较双方类型一致

1.2 集合操作的性能陷阱

OGNL的集合投影语法list.{property}看似方便,但在大数据量时可能成为性能瓶颈:

<!-- 不推荐在大集合使用投影 -->
<foreach item="item" collection="users.{id}" >  <!-- 隐含O(n)遍历 -->
   #{item}
</foreach>

更高效的做法是直接操作原始集合:

<foreach item="user" collection="users">  <!-- 单次遍历 -->
   #{user.id}
</foreach>

1.3 方法调用的安全边界

OGNL允许直接调用对象方法,但需要警惕安全隐患:

<!-- 潜在危险示例 -->
<if test="@java.lang.Runtime@getRuntime().exec('rm -rf')">
   ...
</if>

安全实践建议:

  • 在MyBatis配置中禁用危险类方法
  • 使用白名单控制可访问的类
  • 避免将用户输入直接作为OGNL表达式

2. 动态SQL高阶实战技巧

2.1 多条件智能组合

传统<if>标签容易产生冗余WHERE条件,更优雅的写法是:

<select id="searchUsers">
  SELECT * FROM users
  <where>
    <trim prefixOverrides="AND |OR ">
      <if test="name != null">AND name LIKE #{name}</if>
      <if test="roles != null">
        AND id IN (
          SELECT user_id FROM user_roles
          WHERE role IN
          <foreach item="role" collection="roles" open="(" separator="," close=")">
            #{role}
          </foreach>
        )
      </if>
      <if test="dept != null">AND dept_id = #{dept.id}</if>
    </trim>
  </where>
</select>

2.2 动态排序的安全实现

直接拼接排序字段存在SQL注入风险,推荐方案:

<select id="findWithOrder">
  SELECT * FROM products
  ORDER BY 
  <choose>
    <when test="@org.apache.commons.lang3.StringUtils@equalsIgnoreCase(orderBy,'price')">
      price ${direction}
    </when>
    <when test="@org.apache.commons.lang3.StringUtils@equalsIgnoreCase(orderBy,'sales')">
      sales_count ${direction}
    </when>
    <otherwise>id ASC</otherwise>
  </choose>
</select>

关键点:

  • 使用工具类进行安全比较
  • 排序方向(direction)仍需参数化处理
  • 提供安全的默认排序

2.3 批量操作的性能优化

对比三种批量插入方式的性能差异:

方式10条耗时1000条耗时内存占用
单条循环插入50ms5000ms低
批量模式(Batch)60ms600ms中
VALUES多值语法30ms120ms高

最佳实践代码:

<insert id="batchInsert">
  INSERT INTO orders (user_id, amount)
  VALUES 
  <foreach item="order" collection="list" separator=",">
    (#{order.userId}, #{order.amount})
  </foreach>
</insert>

3. 安全防护体系构建

3.1 OGNL沙箱配置

在mybatis-config.xml中增加安全限制:

<configuration>
  <settings>
    <setting name="ognl.security.manager" value="true"/>
    <setting name="ognl.class.allow" 
             value="java.lang.Math,java.util.Date"/>
  </settings>
</configuration>

3.2 表达式注入防御

危险场景示例:

<!-- 恶意用户传入:' || 1=1 || ' -->
<if test="${name} != null">  <!-- 使用${}导致SQL注入 -->
  name = '${name}'
</if>

防护方案:

  1. 始终优先使用#{}语法
  2. 必须使用${}时,进行白名单校验
  3. 复杂表达式使用工具类处理

3.3 日志审计策略

建议记录高风险OGNL操作:

public class SafeOgnlLogger extends OgnlLogger {
  @Override
  public void debug(String msg) {
    if(msg.contains("Runtime") || msg.contains("Process")) {
      alertSecurityTeam(msg);
    }
    super.debug(msg);
  }
}

4. 性能调优实战

4.1 表达式预编译

OGNL表达式每次执行都需要解析,可通过缓存优化:

// 初始化时编译表达式
private static final OgnlExpression expression = 
    Ognl.parseExpression("name != null ? name : 'default'");

// 执行时直接使用编译后对象
Object value = Ognl.getValue(expression, context, root);

4.2 避免嵌套地狱

不推荐的深层嵌套:

<if test="user != null && user.department != null 
          && user.department.manager != null">
  ...
</if>

优化方案:

  1. 在Java代码中预处理复杂判断
  2. 使用<bind>变量简化:
<bind name="hasManager" 
      value="@java.util.Objects@nonNull(user?.department?.manager)"/>
<if test="hasManager">
  ...
</if>

4.3 监控与诊断

关键性能指标监控点:

  • OGNL表达式解析时间
  • 动态SQL生成耗时
  • 最终执行SQL复杂度

诊断工具推荐:

# 开启MyBatis调试日志
logging.level.org.mybatis=DEBUG

5. 复杂业务场景解决方案

5.1 多租户数据过滤

安全实现租户隔离:

<select id="findItems">
  SELECT * FROM items
  WHERE tenant_id = #{tenantId}
  <if test="query.filter != null">
    AND 
    <foreach item="f" collection="query.filter" separator=" AND ">
      ${f.field} ${f.operator} #{f.value}
    </foreach>
  </if>
</select>

5.2 动态字段映射

按需返回不同字段集:

<select id="getUserView">
  SELECT 
  <choose>
    <when test="type == 'BASIC'">
      id, name, avatar
    </when>
    <when test="type == 'FULL'">
      <include refid="fullUserColumns"/>
    </when>
  </choose>
  FROM users
  WHERE id = #{id}
</select>

5.3 跨表关联查询优化

动态关联策略示例:

<select id="findOrderDetails">
  SELECT o.*
  <if test="withItems">
    , i.name as item_name, i.price
  </if>
  FROM orders o
  <if test="withItems">
    JOIN items i ON o.item_id = i.id
  </if>
  WHERE o.user_id = #{userId}
</select>

6. 扩展与替代方案

6.1 自定义OGNL函数

注册自定义函数:

public class MyOgnlFunctions {
  public static boolean containsAny(String str, String... keys) {
    // 实现逻辑
  }
}

// 在配置中注册
configuration.getVariables().put("myfn", new MyOgnlFunctions());

使用示例:

<if test="@myfn@containsAny(name, 'VIP','黄金')">
  ...
</if>

6.2 表达式引擎对比选型

特性OGNLSpELMVEL
学习曲线简单中等较陡
Spring集成需适配原生支持需适配
性能一般优秀优秀
安全控制有限完善中等

迁移建议:

  • Spring项目优先考虑SpEL
  • 高性能场景评估MVEL
  • 旧系统维护保持OGNL

6.3 MyBatis-Plus增强方案

MyBatis-Plus对动态SQL的扩展:

// 使用Wrapper构建复杂条件
new QueryWrapper<User>()
    .like(StringUtils.isNotBlank(name), "name", name)
    .gt(age != null, "age", age)
    .orderBy(true, StringUtils.equals(sort,"desc"), "create_time");

优势:

  • 类型安全的API
  • 更直观的条件组合
  • 更好的IDE支持
一文全解:OGNL表达式以及Mybatis中的OGNL表达式 OGNL(Object-Graph Navigation Language)是一种用于在Java中访问和操作对象图的表达式语言。它提供了一种简洁、灵活的方式来遍历和操作复杂的对象结构,而无需编写大量的代码。OGNL表达式可以用于各种场景,如Web应用、批处理任务、测试等。OGNL表达式是一种强大的工具,尤其在Mybatis中能够极大地简化动态SQL的编写。它的简洁语法和强大功能,使得开发者能够高效地处理复杂的对象操作。然而,在使用OGNL表达式时,也要注意性能和安全性的问题,合理使用表达式,避免潜在的风险。 阅读详情

相关推荐

【Java】基于【Mybatis】框架学习系列——动态SQL

Mybatis的强大特性之一就是使用了动态SQL,使用JDBC或者其他框架时,需要根据不同的查询条件拼接SQL语句进行多字段的数据操作。

ALi.S的博客 852

OGNL表达式,值栈(ValueStack),类型转换

OGNL表达式,值栈(ValueStack),类型转换 1. 什么是OGNL? l  全称是Object Graphic Navigation Language,对象图导航语言 它是一种强大的表达式语言,可以通过简单一致的表达式语法来读取和设置Java对象的属性值、调用对象的方法、遍历整个对象的结果图、实现字段类型转换等功能,它是一个开源项目。 l  OGNL表达式的计算是围绕OGNL上下

WuTing的专栏 805

华为P30/pro (ELE-AL00) 鸿蒙4.2降级 EMUI 9

分享

m0_52356707的博客 1万+

深入解析:Mybatis中OGNL表达式的动态SQL实战技巧

本文深入解析了Mybatis中OGNL表达式在动态SQL中的核心应用与实战技巧。OGNL作为Mybatis动态SQL的灵魂语法,赋予`<if>`、`<choose>`、`<foreach>`等标签动态能力,使SQL能根据运行时条件灵活生成。文章详细介绍了OGNL的基础属性访问、对象图导航、方法调用等核心语法,并结合`<bind>`标签、性能优化与空指针规避等实战场景,帮助开发者从“硬编码”过渡到灵活高效的动态SQL编写,提升数据访问层代码的清晰度与健壮性。

d3e4f的博客 567

Clion编译stm32cube初始化工程时non constant or forward reference address expression for section .ARM.extab报错

相信应该有同学在看了稚晖君关于clion开发stm32的文章之后也想在自己PC上实现“优雅の嵌入式开发”遇到和我类似的问题。他的文章是22年写的,我个人猜测应当是版本更新导致的不适配。意思就是说 READONLY 只能在gcc11以后的版本中使用,gcc10及以前的版本将无法正确识别,也就有如下错误。或者就可以将gcc升级至最新的版本。记得在clion工具链中修改c,cpp编译器的位置。可以将文本括号中的 READONLY 全部删除。当时由于没有注意到这行注释导致在这里卡了好久。

2301_77256849的博客 2514

从零配置ORB-SLAM3:TUM-VI数据集yaml文件参数调优指南

本文深入解析了ORB-SLAM3在TUM-VI数据集上的yaml配置文件参数调优方法。针对双目惯性模式,详细拆解了相机标定、IMU噪声模型和ORB特征提取三大模块的关键参数,解释了其原理与影响,并通过实战案例展示了如何通过调整特征点数量、FAST阈值及IMU噪声参数,有效提升系统在低纹理环境下的鲁棒性和轨迹精度。

weixin_29071809的博客 154

MyBatis之动态SQL编写指南

实际开发中SQL语句往往需要根据不同条件动态生成(如多条件查询、动态排序、批量操作等),MyBatis的动态SQL通过标签化语法,实现了SQL的灵活拼接,避免了手动拼接SQL的繁琐和SQL注入风险。本文我将系统讲解MyBatis动态SQL的核心标签(`if`、`choose`、`foreach`等),并结合实例解析其用法和最佳实践,带你掌握动态SQL的编写技巧。

aa_hdkf_vg的博客 1174

电池管理系统(BMS)系列—状态估计之SOH

BMS系列文章,介绍了SOH估计

zxx52113140的博客 1849

MyBatis动态SQL标签总结、开发手册、高阶用法(动态SQL、OGNL、批量操作、片段重用、 SQL 组合、 执行优化、嵌套查询与延迟加载)

MyBatis动态SQL标签总结、开发手册、高阶用法(动态SQL、OGNL、批量操作、片段重用、 SQL 组合、 执行优化、嵌套查询与延迟加载)

开源AI 专属 UI——papyrai-ui。《千界明彻录》(故事形式构建元思维)——胡说小说。更多思辨内容在公众号。 2593

如何用AP525 测试输入信号的相位,频响,延时,Pop和卡顿

假设信号不是从AP输出,是功放或者其他的播放设备输出的信号,接入到AP525的输入端。

帮助100万人颠覆负面潜意识,实现人生蜕变,培养1万名潜意识开发导师 2408

通过情感分类实例 详细介绍如果借助Huggingface平台 完成Transformers模型运行(包括配置环境-tokenizer-Model-输出头-预测)

attention_mask和padding是配套使用的,当人为去修改padding的时候,也要把attention_mask里面的参数进行修改。下载Huggingface包,Huggingface可以说是一个社区,集成了很多nlp的模型、数据集、预训练权重文件等等,并且免费,只需要pip install下载即可。那么用什么做分类就选择什么输出头,就import什么东西。代码中使用了自动分词器选择,它是由checkpoint指定的预训练模型关联的,不用我们自己选择tokenizer,它自动帮我们选择好了。

LZL2020LZL的博客 1138

MyBatis 源码解析:OGNL 表达式解析与使用

OGNL(Object-Graph Navigation Language)为 MyBatis 提供了强大的表达式解析能力,使 SQL 语句能根据业务需求动态生成。本文将深入解析 MyBatis 中如何通过 OGNL 进行动态 SQL 的生成,并通过自定义实现简化的 OGNL 解析器,探讨其工作原理,详细解读源码中的关键实现,帮助开发者更好理解这一功能。

捕风捉你 · 星桥API接入与大模型实战 1514

畅游Diffusion数字人(0):专栏文章导航

畅游Diffusion数字人(0):专栏文章导航

沉迷单车的追风少年 1425

你必须要知道Mybatis中的OGNL表达式

OGNL是个什么东西?很多刚入门Java的同学会有点陌生。但是在Structs流行的时代OGNL可是必会的数据渲染技术。它全称Object Graph Navigation Language,作用是降低对数据层访问的难度,它拥有类型转换、访问对象方法、操作集合对象等功能。目前已经很少通过OGNL来访问数据层了,写这篇文章主要是因为目前国内大部分的ORM框架是**Mybatis**,而Mybatis中的动态SQL技术运用了OGNL。

抓娃攻城师 3129

SillyTavern 酒馆在 Mac 和 Linux 上的部署教程(含启动器安装方法)

SillyTavern 是一个支持多种大模型聊天接口的本地前端项目,适用于 MacOS 和 Linux 系统。本文提供了两种部署方式:手动安装和使用 SillyTavern Launcher 安装器。手动安装需要先安装 Git 和 NodeJS,然后克隆项目源码并运行启动脚本。使用 Launcher 则更为简便,适合新手用户,能够自动安装依赖和配置环境。部署完成后,用户可以通过浏览器访问本地服务器,加载角色卡片并连接大模型 API,享受二次元角色扮演聊天的乐趣。无论是开发者还是终端用户,都能轻松完成 Sil

代码简单说 Vue、JAVA、PHP、Node.js 熟练运用,接口、架构、性能全搞定。 3400

IEM模型,地表粗糙度模拟

利用微波反演土壤水分时候,利用IEM模型可以实现对随机地表的模拟

java回顾:MyBatis参数、sql片段、动态sql、高级查询

MyBatis参数、sql片段、动态sql、高级查询:一对一、一对多、多对多

m0_56678122的博客 2337

Data-Structures-and-Algorithm-Analysis-in-Java.pdf

作者: Weiss, Mark A. 出版社: Addison Wesley Data Structures and Algorithm Analysis in Java is an “advanced algorithms” book that fits between traditional CS2 and Algorithms Analysis courses. In the old ACM Curriculum Guidelines, this course was known as CS7. This text is for readers who want to learn good programming and algorithm analysis skills simultaneously so that they can develop such programs with the maximum amo...

深入解析:OGNL表达式在Mybatis动态SQL中的实战应用

本文深入解析了OGNL表达式在MyBatis动态SQL中的核心应用。OGNL作为对象图导航语言,能够简化Java对象属性的访问,并支持方法调用、集合操作与逻辑判断,是实现动态条件查询、排序、字段选择等复杂SQL逻辑的强大工具。文章通过实战案例详细展示了其语法与高级用法,并强调了性能优化与安全使用的重要性。

tree8的博客 209

精雕软件(JDpaint) 5.5 绿色版

精雕软件(JDpaint) 5.5 绿色版精雕软件(JDpaint) 5.5 绿色版精雕软件(JDpaint) 5.5 绿色版

VB摄像头监控

该VB模块可对摄像头捕获的画面进行录像等,可在创建的窗口进行控制

深入解析 MyBatis 动态 SQL使用:高效构建灵活查询的指南(超详细)

在企业级应用开发的复杂场景中,持久层作为数据交互的关键枢纽,其设计面临着数据查询灵活性与 SQL 可维护性的双重核心挑战。当业务逻辑日益复杂,传统方式下的 SQL 拼接往往变得繁琐且容易出错,开发者常常需要花费大量精力处理条件判断、空格添加、逗号去除等细节问题,不仅效率低下,还极大地影响了代码的可读性和可维护性。​MyBatis 作为 Java 生态中主流的持久层框架,其动态 SQL功能犹如一把利刃,精准地切入了这一痛点。接下来,就让我们一同深看看MyBatis 动态 SQL 的标签是怎么使用的吧~

Young_深情不及里子的博客 1106

有关MyBatis的动态SQL

本文介绍了MyBatis中的动态SQL,介绍了其运行原理和常用标签的使用方法,以及使用时的注意事项!

weixin_68093610的博客 1597

【手把手带你玩转MyBatis】深入源码解读MyBatis系列(三):动态SQL与OGNL表达式

在实际开发中,业务需求往往复杂多变,静态SQL语句无法满足所有场景。为此,MyBatis提供了强大的动态SQL支持,允许开发者根据运行时条件动态生成SQL查询语句。通过使用等标签,可以编写出适应多种情况的SQL片段。

qq_58366795的博客 570

【MyBatis神技】动态SQL:告别硬编码,让SQL“活”起来!

根据。

2401_83194332的博客 1916

【MyBatis动态SQL终极指南】告别SQL拼接!9大标签让复杂查询如此简单

🍜静态SQL:固定菜单,不能调整配料(如:SELECT * FROM dishes)🍽️动态SQL:定制菜单,“不要香菜,多加辣”(如:SELECT … WHERE spicy_level > 3 AND no_coriander = true)动态SQL的价值避免拼接SQL字符串的繁琐防止SQL注入风险提升复杂查询的可维护性减少冗余SQL语句高级版where/set,可自定义前缀后缀</</</</灵活:9大标签覆盖所有复杂场景安全:自动处理预编译参数高效。

全栈开发工程师 1363

MyBatis中的OGNL教程

MyBatis中的OGNL教程

偶尔记一下 - mybatis.io 6万+

MyBatis——动态SQL(对应官方文档Dynamic SQL)

MyBatis——动态SQL(对应官方文档Dynamic SQL) 动态SQL是MyBatis强大特性之一。极大的简化我们拼装SQL的操作。 动态SQL元素和使用JSTL或其他类似基于XML的文本处理器相似。 MyBatis采用功能强大的基于OGNL的表达式来简化操作 if choose(when,otherwise) trim(where,set) foreach OGNL:...

qq_41425382的博客 3473
上一篇: ESP32 BLE SPP服务端架构与GATT服务初始化详解
下一篇: 【Typora 图片排版】掌握图片居中的终极技巧,提升Markdown文档美观度
普通网友
博客等级 码龄4年 95粉丝 1459原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符  | 博主筛选后可见
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值