互联网轻量级框架整合之MyBatis动态SQL-动态SQL实例

<!-- 根据提供的字符串参数查询角色信息 -->
<select id="findRoles" parameterType="string" resultType="role">
	<!-- 基本查询语句,选取角色表中的id, role_name, note列 -->
	select id, role_name, note from t_role where 1=1
	<!-- 如果传入的roleName不为空且不为零长度字符串,则在查询条件中添加角色名的模糊匹配 -->
	<if test="roleName != null and roleName !=''">
		and role_name like concat('%', #{roleName}, '%')
	</if>
</select>

当参数roleName被传递给映射器时,如果参数不为空,则构造对roleName的模糊查询,否则不构造这个条件

    <!-- 根据条件查询角色信息 -->
    <!-- 参数说明:
         id: 角色的唯一标识符
         roleName: 角色名称
    -->
    <!-- 返回值:查询到的角色信息列表 -->
    <select id="findRoles2" parameterType="role" resultType="role">
        select id, role_name, note from t_role
        where 1=1
        <!-- 根据参数条件动态生成查询语句 -->
        <choose>
            <!-- 如果提供了id,则在查询条件中加入id的等于比较 -->
            <when test="id != null and id !=''">
                AND id = #{id}
            </when>
            <!-- 如果提供了roleName,则在查询条件中加入角色名称的模糊匹配 -->
            <when test="roleName != null and roleName !=''">
                AND role_name like concat('%', #{roleName}, '%')
            </when>
            <!-- 如果未提供id和roleName,则查询note字段不为空的角色信息 -->
            <otherwise>
                AND note is not null
            </otherwise>
        </choose>
    </select>

代码中使用了choose、when、otherwise元素,MyBatis会根据参数进行判断来动态组装SQL,以满足不同的也无需求

在之前的SQL中,都加入了一个条件1=1,其作用主要是为了不报错,顺带解释一下这个条件的几种作用:

  • 简化动态查询条件的拼接:当应用程序需要根据用户的选择或输入动态构建 SQL 查询时,WHERE 1=1 可作为初始条件,确保查询语句的语法完整性。这样,无论用户是否提供额外的筛选条件,查询都能正常执行。
    后续根据实际需要,可以在 WHERE 1=1 后面通过 AND 连接更多的具体条件。例如,如果用户指定了角色名称,可以追加 AND role_name = ‘用户指定的角色名’。由于 WHERE 子句已经存在且始终为真,添加其他条件时无需考虑是否存在初始条件。
  • 便于条件的增删与调试:
    开发过程中,程序员可能需要临时注释掉某些查询条件进行测试。如果查询开始于 WHERE 1=1,那么只需注释相应的 AND 后面的条件即可,无需调整 WHERE 子句本身。这使得代码更易于维护和调整。
  • 作为占位符或模板:
    在编写通用的 SQL 模板或框架代码时,WHERE 1=1 可作为一个标准起始点,待具体使用时再填充实际条件。这种做法有利于保持查询结构的一致性,尤其是在使用代码生成工具或预编译 SQL 语句的场景下。
  • 在特定上下文中表示“全选”:
    尽管直接省略 WHERE 子句也能达到查询全部记录的效果,但在一些特定情况下(比如需要动态添加条件的代码逻辑),保留 WHERE 1=1 可能有助于清晰表达查询意图为获取所有满足可能附加条件的数据。
  • 特殊情况下的特殊用途:
    在极少数情况下,WHERE 1=1 或类似的永真条件可能会用于特定的数据库操作,如某些数据库迁移脚本或数据复制任务中,用来仅复制表结构而不获取任何数据(如使用 CREATE TABLE AS SELECT … WHERE 1=0 创建空表结构)。

WHERE 1=1 主要作为一种编程技巧,用于简化动态查询条件的构造、维护和调试,以及在特定场景下作为查询条件的占位符或全选标志。尽管它本身对查询结果并无实际影响(因为 1=1 永远为真),但其在实际编程实践中具有一定的实用价值。

<!-- 根据角色名和备注信息查询角色信息 -->
<select id="findRoles3" parameterType="role" resultType="role">
    select id, role_name, note from t_role
    <where>
        <!-- 如果提供了角色名,则按角色名进行模糊查询 -->
        <if test="roleName != null and roleName !=''">
            and role_name like concat('%', #{roleName}, '%')
        </if>
        <!-- 如果提供了备注信息,则按备注信息进行模糊查询 -->
        <if test="note != null and note !=''">
            and note like concat('%', #{note}, '%')
        </if>
    </where>
</select>

只有当where条件成立时,才会加入“and”这个SQL关键字到组装的SQL执行,否则不加入,就相当于where 1=1的作用

有时候要去掉的是一些特殊的SQL语法,比如常见的and、or,使用trim元素也可以达到预期效果

<!-- 根据提供的字符串参数查询角色信息 -->
<select id="findRoles4" parameterType="string" resultType="role">
    <!-- 从t_role表中选择id, role_name, note列 -->
    select id, role_name, note from t_role
    <!-- 在where条件前添加前缀,并且忽略掉所有的and前缀,以防止多个条件连接时的语法错误 -->
    <trim prefix="where" prefixOverrides="and">
        <!-- 如果roleName不为空且不为零长度字符串,则添加like条件进行角色名的模糊匹配 -->
        <if test="roleName != null and roleName !=''">
            and role_name like concat('%', #{roleName}, '%')
        </if>
    </trim>
</select>

trim元素意味着要去掉一些特殊的字符串,prefix代表语句的前缀,prefixOverdridesd代表需要去掉的字符串

在Hibernate中,常常因为更新某一个对象,而发送全部字段给持久对象,但现实场景中可能只需要更新某一个字段,这个情况下如果发送所有字段那很可能造成过大的网络开销而降低了性能,最佳的办法是只对主键和要更新的字段进行操作

如果一个表需要更新两个字段,那写两条SQL又会降低可读性和增加代码冗余,Hibernate就是把全部字段发送给SQL,而避免多条SQL的情况

<!-- 更新角色信息的SQL语句 -->
<update id="updateRole" parameterType="role">
    update t_role
    <set>
        <!-- 如果角色名不为空,则更新角色名 -->
        <if test="roleName != null and roleName !=''">
            role_name = #{roleName},
        </if>
        <!-- 如果备注信息不为空,则更新备注信息 -->
        <if test="note != null and note != ''">
            note = #{note}
        </if>
    </set>
    <!-- 根据角色ID进行更新 -->
    where id = #{id}
</update>

MyBatis中,可以使用set元素,来避免这个问题,而且当set元素遇到了多余的逗号,会把对应的逗号去掉

foreach元素是一个循环语句,它的作用是遍历集合,它能够很好地支持数组和List、Set接口的集合,对此进行遍历功能,往往用于SQL中的in关键字场景

<!-- 根据角色id列表查询角色信息 -->
<select id="findRoleByIds" resultType="role">
    <!-- 使用foreach标签处理idList中的每个id,构建查询条件 -->
    select id, role_name, note from t_role where id in
    <foreach item="id" index="index" collection="idList" open="("
        separator="," close=")">
        #{id}
    </foreach>
</select>

  • item属性:属性值id作用:定义在循环体中用于引用当前迭代元素的变量名。在这个例子中,item=“id” 表示在循环内部,可以通过${id}#{id}引用来访问集合中当前迭代到的单个角色ID。
  • index属性:属性值index作用:定义在循环体中用于引用当前迭代索引(下标)的变量名。这里没有直接使用到index变量,但如果有需要,可以通过${index}在 SQL 中引用当前元素在 idList 集合中的位置。
  • collection属性:属性值idList作用:指定要遍历的集合或数组的名称。这是 <foreach>标签必须提供的属性,它指定了传入 SQL 语句的方法参数中所包含的集合或数组的变量名。在本例中,方法调用时应传入一个名为 idList 的 List 或数组,其中包含了要查询的角色ID列表。
  • open属性:属性值(作用:定义在循环开始时输出的文本内容。此处设置为(,表示在生成的 SQL 中,在 IN 子句的起始处插入一个左括号。
  • separator属性:属性值,作用:定义在每次迭代之间输出的分隔文本。这里设定为 ,,意味着在相邻两个角色ID之间插入逗号,以符合 SQL IN 子句中列举多个值时的语法要求。
  • close属性:属性值)作用:定义在循环结束时输出的文本内容。这里设置为),表示在所有角色ID循环完成后,在 IN 子句的末尾插入一个右括号,完成整个条件表达式的闭合。
  • #{id}:在<foreach>循环体内,使用 #{id}表达式来引用当前迭代元素(即item属性指定的变量)。MyBatis 将会将其替换为实际的值,并且会对该值进行预编译参数化,提供 SQL 注入攻击防护。
<!-- 根据提供的字符串参数查询角色信息 -->
<select id="getRoleTest" parameterType="string" resultType="role">"
	<!-- 从t_role表中选择id, role_name, note列 -->
	 select id, role_name, note from t_role
	 <!-- 如果参数type等于'Y',则添加where条件 -->
	 <if test="type=='Y'.toString()">
		 where 1=1
	 </if>
</select>
<!-- 
    查询满足特定条件的角色信息。
    参数:
    - id: 角色的唯一标识符。
    - parameterType: 参数类型,此处为字符串类型。
    - resultType: 查询结果类型,此处为角色类型。
    返回值:一个包含角色信息的结果集。
 -->
<select id="findRoles5" parameterType="string" resultType="role">
    <bind name="pattern" value="'%' + _parameter + '%'" /> <!-- 构造匹配模式,实现模糊搜索 -->
    select id, role_name as roleName, note FROM t_role
    where role_name like
    #{pattern}
</select>

bind 元素是 MyBatis 框架中的一个动态 SQL 标签,允许开发者定义一个变量并赋予其特定值,以便后续在 SQL 语句中作为参数值使用,在这个例子中,定义了一个名为 pattern 的变量,其值由表达式 ‘%’ + _parameter + ‘%’ 计算得出。其中 _parameter 是 MyBatis 中预定义的变量,代表传入方法的参数。这样,通过 bind 标签,我们创建了一个用于模糊查询的 SQL 模式

<!-- 
    查询同时满足角色名和备注信息条件的角色信息。
    参数:
    - resultType: 查询结果类型,此处为角色类型。
    返回值:一个包含满足条件的角色信息的结果集。
 -->
<select id="findRoles6" resultType="role">
    <bind name="pattern_roleName" value="'%' + roleName + '%'" /> <!-- 构造角色名的匹配模式,实现模糊搜索 -->
    <bind name="pattern_note" value="'%' + note + '%'" /> <!-- 构造备注信息的匹配模式,实现模糊搜索 -->
    SELECT id, role_name as roleName, note FROM t_role
    where role_name like #{pattern_roleName}
    and note like #{pattern_note}
</select>

因为MyBatis支持多个参数,因此,可是使用bind元素定义两个新的变量

如此看来,bind元素还带来了如下几个优点:

  • 简化复杂逻辑处理: 有时 SQL 查询可能涉及复杂的逻辑判断或字符串拼接,直接在 SQL 语句中编写可能会导致代码难以阅读和维护。使用 bind 标签可以在 XML 映射文件中以编程方式处理这些逻辑,将计算结果封装成变量,使得 SQL 语句保持简洁清晰。例如,根据不同的业务规则动态生成 WHERE 子句的条件部分。
  • 提高 SQL 可移植性: 不同数据库系统对于某些函数或操作可能存在语法差异。bind 标签可以通过在 Java 层处理这些差异,确保生成的 SQL 语句适应目标数据库。比如,使用 bind 来拼接字符串进行模糊查询,可以避免直接在 SQL 中使用特定数据库的字符串连接函数(如 MySQL 的 CONCAT() 或 Oracle 的 ||),从而增强 SQL 语句在跨数据库环境下的可移植性。
  • 防范 SQL 注入: MyBatis 使用预编译的 PreparedStatement 执行 SQL,其参数替换机制能够有效防止 SQL 注入攻击。当使用 bind 标签构造参数值时,即使表达式中包含了用户输入的部分(如 _parameter),生成的最终值也会被安全地传递给预编译的 SQL 语句,避免了原始数据直接拼接到 SQL 字符串中可能导致的安全风险。
  • 复用与组织: 对于需要在多个地方使用的相同逻辑或值,可以使用 bind 标签预先计算并绑定,避免重复书写。这有助于减少代码冗余,提高映射文件的结构化程度和可读性
上一篇:【Python】如何在Ubuntu上设置Python脚本开机自启


下一篇:Python实现将文件夹下的所有pdf文件合并成一个pdf文件,并用文件夹名字命名