MyBatis动态<if>标签使用避坑指南

更新时间：2023年03月07日 09:18:16 作者：半夏之沫

这篇文章主要为大家介绍了MyBatis动态<if>标签使用避坑指南，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪

前言

MyBatis中的<if>动态SQL标签，常用场景是根据条件添加WHERE子句。本篇文章将对<if>动态SQL标签使用中的常见问题进行演示和总结。

演示的场景有：if判断字符串，if判断数字。

MyBatis版本：3.5.6

正文

一. if标签判断字符串

查询参数Param如下。

public class Param {
    private int id;
    private String level;
    private int times;
    private String timestamp;
    // 省略get和set
}

语句如下。

<select id="queryEvents" resultMap="eventResultMap">
    SELECT
        id,
        e_name,
        e_times,
        e_level
    FROM event
    WHERE id=#{id}
    <if test="level != null and level != ''">
        AND e_level=#{level}
    </if>
</select>

上述是判断字符串是否为空（null或者空串），不为空时，为WHERE子句添加额外的条件。

通过<if>标签判断字符串是否为空，是<if>标签使用频率最高的用法，但是有时也会通过<if>标签来判断字符串的值，这里有多种写法，下面给出正确写法，推荐写法和错误写法。

正确写法1

<select id="queryEvents" resultMap="eventResultMap">
    SELECT
        id,
        e_name,
        e_times,
        e_level
    FROM event
    WHERE id=#{id}
    <if test="level == 'secondary'">
        AND e_times>10
    </if>
</select>

注意''单引号中一定需要是多个字符，如果只有一个字符，会报错。

正确写法2

<select id="queryEvents" resultMap="eventResultMap">
    SELECT
        id,
        e_name,
        e_times,
        e_level
    FROM event
    WHERE id=#{id}
    <if test="level == 'secondary'.toString()">
        AND e_times>10
    </if>
</select>

这种写法不限制''单引号中的字符个数，一个或多个都可以。

推荐写法

<select id="queryEvents" resultMap="eventResultMap">
    SELECT
        id,
        e_name,
        e_times,
        e_level
    FROM event
    WHERE id=#{id}
    <if test='level == "secondary"'>
        AND e_times>10
    </if>
</select>

推荐外层用单引号，内层用双引号的写法，能少踩很多坑。

特别注意：错误写法

<select id="queryEvents" resultMap="eventResultMap">
    SELECT
        id,
        e_name,
        e_times,
        e_level
    FROM event
    WHERE id=#{id}
    <if test="level == 'A'">
        AND e_times>10
    </if>
</select>

这种写法会报错，因为像'A'这种单个字符的情况会被判定为字符，所以MyBatis认为字符串在与字符做比较，从而报错。但是如果是'AA'或者'A'.toString() 这种，就会被判定为字符串，就正常。

二. if标签判断数字

查询参数Param如下。

public class Param {
    private int id;
    private String level;
    private int times;
    private String timestamp;
    // 省略get和set
}

语句如下。

<select id="queryEvents3" resultMap="eventResultMap">
    SELECT
        id,
        e_name,
        e_times,
        e_level
    FROM event
    WHERE e_level=#{level}
    <if test="times != null">
        AND e_times>#{times}
    </if>
</select>

通过<if>标签也可以对数字判空，同时<if>标签也可以判断数字的值，这里有多种写法，下面给出正确写法，推荐写法和错误写法。

正确写法1

<select id="queryEvents2" resultMap="eventResultMap">
    SELECT
        id,
        e_name,
        e_times,
        e_level
    FROM event
    WHERE e_level=#{level}
    <if test="times > '10'">
        AND e_times>#{times}
    </if>
</select>

注意''单引号中一定需要是多个数字。

正确写法2

<select id="queryEvents2" resultMap="eventResultMap">
    SELECT
        id,
        e_name,
        e_times,
        e_level
    FROM event
    WHERE e_level=#{level}
    <if test="times > '0'.toString()">
        AND e_times>#{times}
    </if>
</select>

这种写法不限制''单引号中的数字个数，一个或多个都可以。

正确写法3

<select id="queryEvents" resultMap="eventResultMap">
    SELECT
        id,
        e_name,
        e_times,
        e_level
    FROM event
    WHERE e_level=#{level}
    <if test="times > 0">
        AND e_times>#{times}
    </if>
</select>

判断条件可以直接写数字。

推荐写法

<select id="queryEvents2" resultMap="eventResultMap">
    SELECT
        id,
        e_name,
        e_times,
        e_level
    FROM event
    WHERE e_level=#{level}
    <if test='times > "0"'>
        AND e_times>#{times}
    </if>
</select>

推荐外层用单引号，内层用双引号的写法，能少踩很多坑。

错误写法

<select id="queryEvents" resultMap="eventResultMap">
    SELECT
        id,
        e_name,
        e_times,
        e_level
    FROM event
    WHERE e_level=#{level}
    <if test="times > '0'">
        AND e_times>#{times}
    </if>
</select>

'0'这种单个数字会被判定为字符，而字符'0'的ASCII值是48，所以times为49及以上时，才满足times > '0'，所以这里有坑，切记。

总结

<if>标签的test判断中，外层用双引号，内层用单引号时，有如下比较规则。

允许数字与字符串做比较；
允许数字与字符做比较，但不推荐。数字与字符做比较时，数字会与字符的ASCAII值做比较，容易出错；
不允许包含字母的字符串与字符做比较。这种情况MyBatis会直接报错；
允许全是数字的字符串与字符做比较，但不推荐。这种情况全是数字的字符串会作为数字来与字符的ASCII值来做比较，容易出错。

而在OGNL表达式中，如果单引号''中只有一个数字或者字母，那么就会被解析为字符，这时就会导致MyBatis或者比较结果错误。

因此推荐<if>标签的test判断中，外层用单引号，内层用双引号，能够避免踩坑。

以上就是MyBatis动态<if>标签使用避坑指南的详细内容，更多关于MyBatis动态<if>标签的资料请关注脚本之家其它相关文章！

您可能感兴趣的文章:

Mybatis动态SQL foreach批量操作方法
这篇文章主要介绍了Mybatis动态SQL foreach批量操作方法,本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2023-03-03
Spring Bean Scope 有状态的Bean与无状态的Bean
这篇文章主要介绍了Spring Bean Scope 有状态的Bean与无状态的Bean,每个用户有自己特有的一个实例，在用户的生存期内，bean保持了用户的信息,下面来了解有状态和无状态的区别吧
2022-01-01
Java数据结构之图的基础概念和数据模型详解
在现实生活中，有许多应用场景会包含很多点以及点点之间的连接，而这些应用场景我们都可以用即将要学习的图这种数据结构去解决。本文主要介绍了图的基础概念和数据模型，感兴趣的可以了解一下
2022-11-11
Java使用Runnable接口创建线程的示例代码
在Java中,多线程编程是实现并发操作的重要手段之一,通过多线程,程序可以同时执行多个任务,从而提高应用程序的效率和响应速度,Java提供了多种创建线程的方式,其中实现Runnable接口是最常见且推荐的方式之一,本文将详细介绍如何使用Runnable接口创建线程
2025-02-02
java进制转换工具类实现减少参数长度
这篇文章主要为大家介绍了java进制转换工具类实现减少参数长度示例详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2023-02-02
springboot升级到jdk21最新教程(2023年)
你还在使用jdk8?快来看看最新出炉的SpringBoot+jdk21如何使用,下面这篇文章主要给大家介绍了关于springboot升级到jdk21的相关资料,文中通过代码介绍的非常详细,需要的朋友可以参考下
2023-10-10
Map集合中获取key-value值的实现方法
这篇文章主要介绍了Map集合中获取key-value值的实现方法，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2023-03-03
九个动画组图轮播总结全栈数据结构数组链表
数据结构和算法是密不可分的，两者往往是相辅相成的存在，所以在学习数据结构过程中，不免会遇到各种算法，数据结构常用操作一般为：增删改查。基本上所有的数据结构都是围绕这几个操作进行展开，本文用九张动图来阐述先进后出的数据结构
2021-08-08
Java使用@Retryable注解实现HTTP请求重试
HTTP调用是Java应用与外部API进行交互时重要的访问方式之一,为了确保在遇到临时性问题时能自动重试,我们可以设计一个灵活的重试机制,在Java中,我们可以通过注解来实现这一功能,文将介绍如何使用注解@Retryable来实现HTTP调用的重试机制,需要的朋友可以参考下
2024-10-10
Maven的pom.xml文件结构中的build
本文主要介绍了Maven的pom.xml文件结构中的build，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2023-07-07