在Mybatis中 @Select注解中如何拼写动态sql

本文介绍如何在MyBatis Plus中使用@Select注解配合<script>标签实现动态SQL的功能,解决了多表查询时固定SQL带来的不便。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

现在随着mybatis plus的应用,越来越多的弱化了SQL语句,对于单表操作可以说几乎不需要进行自己编写SQL语句了,但对于多表查询操作目前mybatis plus还没有很好的支持,还需要自己编写SQL语句,如:

import java.util.List;

import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import org.apache.ibatis.annotations.Select;

import com.baomidou.mybatisplus.mapper.BaseMapper;
import com.shield.base.model.domain.MenuDO;
import com.shield.base.model.param.MenuTreeParam;

/**
 * 基础数据操作对象
 *
 * @author xxx
 * @date 2018/5/18
 */
@Mapper
public interface MenuDAO extends BaseMapper<MenuDO> {

    /**
     * 根据菜单编码获得所有下级菜单列表(包括本级)
     * @param menuId 菜单编码
     * @return 该菜单下的所有菜单列表(包括本级)
     */
    @Select("WITH menuTree"
        + " AS"
        + "("
        + " SELECT menu1.father_rowid as id,menu1.son_rowid as parentId,menu1.system_name as menuName,"
        + "menu1.system_full_rowid as menuTreeFlat,menu1.level_value as menuLevel,menu1.homepage_status as homeStatus,"
        + "menu1.menu_status as menuType,menu1.sort as sort,menu1.duty_name as createName,"
        + "menu1.duty_datetime as createDate,menu1.update_datetime as updateDate,menu1.stop_status as status"
        + " FROM system_menu_setup menu1 WHERE menu1.father_rowid = #{menuId}"
        + " UNION ALL"
        + " SELECT menu2.father_rowid as id,menu2.son_rowid as parentId,menu2.system_name as menuName,"
        + "menu2.system_full_rowid as menuTreeFlat,menu2.level_value as menuLevel,menu2.homepage_status as homeStatus,"
        + "menu2.menu_status as menuType,menu2.sort as sort,menu2.duty_name as createName,"
        + "menu2.duty_datetime as createDate,menu2.update_datetime as updateDate,menu2.stop_status as status"
        + " FROM system_menu_setup menu2"
        + " INNER JOIN menuTree T ON menu2.son_rowid = T.id"
        + ")"
        + " SELECT id,parentId,menuName,MenuTreeFlat,menuLevel,homeStatus,menuType,sort,createName,"
        + "createDate,updateDate,status  FROM menuTree")
    List<MenuDO> selectMenuTreeList(@Param(value = "menuId") Long menuId);

}
这样整个语句基本上都是写死的,没有办法通过参数动态拼接SQL语句,在对于 相同语句不同参数来拼接SQL语句是十分不便的,而如果使用xml来配置的话可以用
<where>
	<if test="stopStatus != null">
		and menu.stop_status=#{stopStatus} and roleMenu.stop_status=#{stopStatus}
	</if>
	<if test="menuSource != null">
		and menuSource.menu_source=#{menuSource}
	</if>
	<if test="userId != null">
 		and roleUser.operator_rowid=#{userId}
	</if>
</where>

但是现在很多公司可能会采用@Select注解方式来编写SQL语句,而非通过xml 的SQL Mapper,那对于@Select这种该如何做呢?其实很简单,只是需要用<script>标签包围,然后像xml语法一样书写即可,无须任何其他类或自定义注解类来完成,具体事例如下:

package com.szss.shield.base.dao;

import java.util.List;

import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import org.apache.ibatis.annotations.Select;

import com.baomidou.mybatisplus.mapper.BaseMapper;
import com.shield.base.model.domain.MenuDO;
import com.shield.base.model.param.MenuTreeParam;

/**
 * 基础数据操作对象
 *
 * @author xxxx
 * @date 2018/5/18
 */
@Mapper
public interface MenuDAO extends BaseMapper<MenuDO> {   

    /**
     * 根据当前用户权限获取所有权限内的菜单列表(不分页)
     * @param menuTreeParam 菜单参数
     * @return 当前用户权限获取所有权限内的菜单列表
     */
    @Select("<script>"
        + " WITH menuTree"
        + " AS"
        + " ("
        + " SELECT menu.father_rowid as id,menu.son_rowid as parentId,menu.system_name as menuName,\n"
        + " menu.level_value as menuLevel,menu.homepage_status as homeStatus,\n"
        + " menu.menu_status as menuType,menu.sort as sort,menu.stop_status as status,CAST(MAX(menuSource.menu_path_url) as VARCHAR) as menuUrl    \n"
        + "from system_menu_setup menu \n"
        + " LEFT JOIN system_menu_source_setup menuSource\n"
        + " ON menu.father_rowid=menuSource.system_menu_rowid \n"
        + " LEFT JOIN system_role_custom_menu_setup roleMenu \n"
        + " ON menu.father_rowid=roleMenu.system_menu_rowid \n"
        + " LEFT JOIN system_role_operator_setup roleUser \n"
        + " ON roleUser.system_role_setup_rowid=roleMenu.system_role_rowid  \n"
        + " LEFT JOIN system_role_setup role \n"
        + " ON roleUser.system_role_setup_rowid=role.rowid\n"
        + " LEFT JOIN system_department_menu_setup depMenu\n"
        + " ON menu.father_rowid=depMenu.system_menu_rowid\n"
        + "<where>"
        + "<if test='stopStatus != null'>"
        + " and menu.stop_status=#{stopStatus} and roleMenu.stop_status=#{stopStatus}\n"
        +"</if>"
        + "<if test='menuSource != null'>"
        + " and menuSource.menu_source=#{menuSource}"
        +"</if>"
        + "<if test='userId != null'>"
        + " and roleUser.operator_rowid=#{userId}\n"
        +"</if>"
        +"</where>"
        + " GROUP BY menu.father_rowid ,menu.son_rowid ,menu.system_name,menu.level_value,menu.homepage_status,\n"
        + " menu.menu_status,menu.sort,menu.duty_name,menu.duty_datetime,menu.update_datetime,menu.stop_status\n"
        + "  UNION ALL\n"
        + "  SELECT menu2.father_rowid as id,menu2.son_rowid as parentId,menu2.system_name as menuName,\n"
        + " menu2.level_value as menuLevel,menu2.homepage_status as homeStatus,\n"
        + " menu2.menu_status as menuType,menu2.sort as sort,menu2.stop_status as status,CAST('' as VARCHAR) as menuUrl\n"
        + "  FROM system_menu_setup menu2\n"
        + "  INNER JOIN menuTree T ON menu2.father_rowid= T.parentId\n"
        + " )\n"
        + "  SELECT id,parentId,menuName,menuLevel,homeStatus,menuType,sort,status,max(menuUrl) as menuUrl FROM menuTree\n"
        + " GROUP BY id,parentId,menuName,menuLevel,homeStatus,menuType,sort,status\n"
        + " ORDER BY menuLevel,sort"
        + " </script>")
    List<MenuDO> selectMenuTreeListByUserId(MenuTreeParam menuTreeParam);
}
至此我们就可以像在xml文件里面一样愉快的动态拼接你想要的SQL语句了!


注意:在@Select注解中采用<script>标签包围拼接SQL语句时不能在标签里有>大于或<小于符号出现,否则会报Caused by: org.xml.sax.SAXParseException: 元素内容必须由格式正确的字符数据或标记组成。需要对这样的标签符号进行转义即可。


<think>嗯,用户这次问的是MyBatis@Select注解是否能够指定SQL查询的id。这个问题挺技术性的,看起来用户应该是在用MyBatis做开发时遇到了具体问题。用户可能在使用Mapper接口进行数据库操作,想要通过指定id的方式来复用已有的SQL语句。我看看用户的上下文……用户引用了四段关于@Select注解的用法示例。第一段是错误的多语句写法,第二段展示了基本的@Select用法,第三段演示了动态SQL的脚本标签,第四段则涉及IN条件的简化写法。这些引用都是关于基础用法的,没提到指定id的情况。让我回忆一下MyBatis的文档……在XML映射文件中,每个SQL语句都可以有一个id,然后通过namespace.id来引用。但@Select是直接写在方法上的注解,通常用于定义新的SQL,而不是引用已有的。用户想要的可能是类似XML配置中通过id引用SQL的那种复用方式。用户真正的需求可能是想要复用SQL片段。在MyBatis中确实有办法做到这点。@Select确实不能直接指定id,但可以用@Lang注解配合动态SQL功能,或者使用SQL构建器。另外@SelectProvider也可以调用外部方法来生成SQL,这样就能复用代码了。需要提醒用户特别注意接口方法与XML的优先级问题。如果方法名和XML的id重复了,接口方法会优先执行,用户可能因此遇到调试困惑。这种情况最好统一用同一种配置方式。用户应该是有一定开发经验的,但可能对MyBatis注解的高级用法不太熟悉。我可以列举几种实现复用的具体方式,包括官方推荐的@Lang和ScriptDriver方式,以及@SelectProvider的方案。再补充说明优先级冲突的可能性和解决方案。</think> 在 MyBatis 框架中,**`@Select`注解本身没有直接等同于 XML 中 `<select id="xxx">` 的 `id` 属性来显式指定查询语句 ID 的用法**。它是直接在接口方法上定义 SQL 语句的注解方式。 但理解你可能的意图,这里有几种相关情况和解决思路: 1. **`@Select` 注解的作用就是定义查询语句:** * 当你在 Mapper 接口方法上使用 `@Select("SELECT ... FROM ...")` 时,MyBatis 会将注解中的 SQL 作为该方法的查询实现,**这个方法的名称本身就隐式成为了这条 SQL 语句的“ID”**。 * 你的需求(指定一个现成的 `id`)在 `@Select` 注解本身的使用范畴内不存在。`@Select` 是直接编写 SQL 的地方,而不是引用别处已定义的 SQL 的标签。 2. **如何复用 SQL 片段/引用其他已定义的 SQL:** 虽然不能在 `@Select` 中指定一个现成的 `id`,但 MyBatis 提供了在注解中**复用 SQL 片段**的机制,这与 XML 中的 `<sql>` + `<include>` 类似: * **使用 `@Lang` + 动态 SQL 驱动 + `@SelectProvider` (官方推荐):** * `@Lang` 指定使用 `org.apache.ibatis.scripting.xmltags.XMLLanguageDriver`(或其他支持动态语言的驱动)。 * 在 SQL 字符串中使用 `<script>` 包装。 * 在 `<script>` 内部使用 `<include refid="namespace.sqlId"/>` 标签来引用定义在 XML 映射文件中的 `<sql id="sqlId">...</sql>` 片段。 * 需要定义一个 `@SelectProvider` 方法返回这个组装好的 SQL 字符串(比直接写 `@Select` 复杂,但能复用)。 ```java @Lang(XMLLanguageDriver.class) @SelectProvider(type = YourSqlProvider.class, method = "yourSelectMethod") List<YourEntity> yourMapperMethod(); ``` ```java public class YourSqlProvider { public String yourSelectMethod() { return "<script>" + "SELECT col1, col2 FROM your_table " + "<where>" + " <if test='param != null'> AND col1 = #{param} </if>" + " <include refid='com.example.OtherMapper.commonFragment'/>" + "</where>" + "</script>"; } } ``` * 这里 `commonFragment` 必须在对应的 XML 文件中定义(如 `com/example/OtherMapper.xml` 里的 `<sql id="commonFragment">...</sql>`)。 * **使用 `@Select` + `<script>` + `<include>` (部分场景有效,但可能有限制):** * 直接在 `@Select` 内写 `<script>` 标签,然后在里面使用 `<include refid="namespace.sqlId"/>`。 * **需要注意:** MyBatis 默认的注解语言驱动可能不完全支持所有 XML 标签功能。`<include>` 可能会因配置或版本需要特定的语言驱动支持,不是所有环境都默认开启。安全做法还是搭配 `@Lang(XMLLanguageDriver.class)` 或直接使用第一种 `@SelectProvider` 方式。 3. **`@Select` 与 XML `<select>` 的优先级与冲突:** * 如果同一个 Mapper 接口中: * 存在一个方法(如 `selectById(int id)`)。 * 同时又存在一个 XML 映射文件,里面定义了一个 `<select id="selectById">...</select>`。 * **此时 MyBatis 的行为是:接口上的注解(`@Select`)会优先于 XML 映射文件中的定义。** * 如果你是想让 `@Select` 方法去“调用”同接口 XML 文件中另一个 `<select id="queryAllUsers">`,**在 MyBatis注解方式里是做不到的**。你需要: * 要么直接在 `@Select` 里复制需要的 SQL(简单但不复用)。 * 要么使用上面提到的复用机制(`<include>` + 显式驱动 或 `@SelectProvider`)来引用定义好的片段(定义在 XML 或 `@SqlProvider` 中)。 * 要么放弃这个接口方法上的 `@Select`,改为在 XML 文件中为这个方法写一个标准的 `<select id="selectById">...</select>`,然后在这个 XML 文件中用 `<include>` 去引用另一个 `<select>` 或 `<sql>` 中的 SQL。 **总结与答复你的问题:** * **直接指定“ID”用法不存在:** `@Select` 注解本身 **没有参数** 用于直接指定一个类似 XML `<select id="queryId">` 中的 `id` 值来引用另一个查询。 * **方法的签名即是ID:** 在注解方式下,**Mapper 接口方法的名称** 本身就承担了标识该查询的角色(相当于 XML 中的 `id`)。 * **复用 SQL 是可能的,但方式不同:** 如果你想在 `@Select` 中使用复用 SQL(这是你可能想通过指定 `id` 达到的目的),需要使用动态 SQL 支持(`<script>`标签)配合 `<include refid="...">` 标签,并可能需要通过 `@Lang` 指定 `XMLLanguageDriver` 或使用 `@SelectProvider` 方法。引用的片段(`<sql id="...">`)需要定义在 XML 映射文件中。 * **优先级的理解:** `@Select` 注解会覆盖同接口、同名方法的 XML 配置。 **相关问题:** 1. 如何在 MyBatis 注解方式 (`@Select`, `@Update`等) 下有效地复用 SQL 片段?推荐什么方式? 2. `@Select` 注解和 XML 配置中定义的同名查询方法冲突时,MyBatis 会执行哪一个?如何避免意外覆盖? 3. 使用 `@Lang(XMLLanguageDriver.class)` 配合 `@Select` 和 `<script>` 标签有哪些优势和需要注意的兼容性问题?[^1][^2][^3] 4. 相比直接在 `@Select` 中写 SQL,使用 `@SelectProvider` 的适用场景有哪些?它如何解决动态 SQLSQL 复用问题? 5. MyBatis 注解方式和 XML 配置方式在大型项目中应如何选择?各自的最佳实践是什么?[^4]
评论 2
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

apicescn

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值