如何在MyBatis XML中拼接表名?CRUD映射文件的表名位置解析
原MyBatis映射片段结构专业解析
先展示用户提供的待分析映射片段:
<select id = "xxxx" parameterType = "yyy" resultType = "zzz"> select count(*) <include refid = "aaa"/> </select>
逐段拆解逻辑组成:
<select>标签为统计查询的核心配置:id对应当前Mapper接口的方法标识,parameterType指定入参的Java类型,resultType指定查询返回值的类型。- 片段内的SQL逻辑当前仅写了查询投影部分
select count(*),未出现FROM子句与表名定义。 <include refid = "aaa"/>是MyBatis的公共SQL片段引用机制:该标签会把同映射文件内、id为aaa的<sql>标签定义的可复用SQL文本,原封不动拼接在当前位置。
当前片段中看不到表名的核心原因:所有和FROM子句、表名、过滤条件相关的公共逻辑,全部被封装在id为aaa的<sql>片段内,举个常规的aaa片段示例:
<sql id="aaa"> from sys_user where status = 1 </sql>
拼接后生成的完整SQL为select count(*) from sys_user where status =1,硬编码的静态表名sys_user就是需要改造的目标位置。
动态表名拼接的实现步骤
第一步:定位硬编码表名
在当前映射文件内搜索<sql id="aaa">标签,找到FROM子句后紧跟的硬编码表名字符串,完成改造点定位。
第二步:替换静态表名为动态占位
MyBatis中动态表名不能使用预编译占位符#{}(会将表名识别为字符串字面量,添加单引号导致SQL语法错误),必须使用字符串直接拼接的${}占位符:
- 将原来硬编码的表名替换为
${自定义表名参数名},示例改造后的aaa片段:
<sql id="aaa"> from ${dynamicTableName} where status = 1 </sql>
- 在对应Mapper接口方法的入参上,使用
@Param("dynamicTableName")注解指定需要传入的表名参数,运行时根据业务逻辑传入对应表名即可完成拼接。
第三步:常见注意事项
- 由于
${}为直接字符串拼接,必须对传入的表名做白名单合法性校验,避免引入SQL注入风险。 - 改造公共SQL片段前,需排查所有引用该
aaa片段的其他SQL语句,确认改造范围覆盖所有需要支持动态表名的查询,避免对无需动态表名的语句造成影响。 - 如果项目存在多租户、分库分表的全局动态表名需求,更推荐使用MyBatis拦截器实现统一表名替换,无需逐段修改SQL片段,降低侵入性。
内容的提问来源于stack exchange,提问作者Venkateshreddy Pala
相关产品推荐
相关产品推荐

