Java 中怎么使用 MyBatis 的 XML 映射文件配置复杂的 SQL 查询语句

星墨小哥_1632

星墨小哥_1632

2026-08-17

559人浏览

原创

mybatis xml映射文件通过处理复杂结果映射,用和支持一对一、一对多嵌套;借助、、等动态sql标签构建安全灵活查询;利用与复用sql片段;参数用#{}预编译防注入,批量操作依赖。

java 中怎么使用 mybatis 的 xml 映射文件配置复杂的 sql 查询语句

MyBatis 的 XML 映射文件是处理复杂 SQL 查询的核心方式,尤其适合动态条件、多表关联、嵌套结果等场景。关键在于合理使用 <select></select> 标签配合动态 SQL 元素(如 <if></if>、<choose></choose>、<foreach></foreach>、<resultmap></resultmap>)和 SQL 片段复用。

定义 resultMap 处理复杂结果映射

当查询涉及多表关联、字段名与属性名不一致、或存在嵌套对象/集合时,不能依赖自动映射,需显式定义 <resultmap></resultmap>。

  • 用 id 属性唯一标识 resultMap,type 指定返回的 Java 类型
  • 用 <id></id> 映射主键字段(提升性能),<result></result> 映射普通字段
  • 用 <association></association> 映射一对一关系(如订单 → 用户),支持嵌套 select 或嵌套 resultMap
  • 用 <collection></collection> 映射一对多关系(如用户 → 订单列表),同样支持嵌套查询或嵌套 resultMap

示例:查用户及其所有订单(一对多)

<resultmap id="UserWithOrdersResultMap" type="User"><id property="id" column="user_id"></id><result property="name" column="user_name"></result><collection property="orders" oftype="Order" resultmap="OrderResultMap"></collection></resultmap><p><resultmap id="OrderResultMap" type="Order"><id property="id" column="order_id"></id><result property="amount" column="order_amount"></result></resultmap></p>

用动态 SQL 构建灵活查询条件

避免拼接字符串,用 MyBatis 提供的标签实现安全、可读的条件组装。

  • <where></where> 自动处理 WHERE 关键字和首条件前的 AND/OR —— 推荐替代手写 WHERE 1=1
  • <if test="xxx != null and xxx != ''"></if> 判断单个参数是否满足条件
  • <choose><when test="..."></when><otherwise></otherwise></choose> 实现类似 switch-case 的多分支逻辑
  • <foreach collection="list" item="item" open="(" separator="," close=")"></foreach> 遍历集合生成 IN 语句

示例:根据用户名、状态、创建时间范围动态查询

<select id="findUsers" resultmap="UserResultMap">
  SELECT * FROM user u
  <where><if test="username != null and username != ''">
      u.username LIKE CONCAT('%', #{username}, '%')
    </if><if test="status != null">
      AND u.status = #{status}
    </if><if test="startTime != null">
      AND u.create_time >= #{startTime}
    </if><if test="endTime != null">
      AND u.create_time 
  </if></where>
  ORDER BY u.create_time DESC
</select>

复用 SQL 片段减少重复

用 <sql></sql> 定义可重用的 SQL 片段(如常用字段、JOIN 子句),再通过 <include></include> 引入。

  • 片段中可用 <bind></bind> 创建新变量,例如格式化模糊查询值
  • 支持传参:在 <include></include> 中用 <property></property> 传递别名或表前缀

示例:

<sql id="userColumns">
  u.id AS user_id,
  u.username AS user_name,
  u.email AS user_email
</sql><p><select id="getUserById" resulttype="map">
SELECT <include refid="userColumns"></include>
FROM user u
WHERE u.id = #{id}
</select></p>

执行带参数的复杂查询(含分页、批量操作)

XML 中可通过 #{} 绑定参数(预编译,防注入),${} 仅作字符串替换(慎用,如动态表名)。

  • 分页建议交由插件(如 PageHelper)处理,XML 写基础查询即可
  • 批量插入用 <foreach></foreach> 生成多值 INSERT(注意数据库限制)
  • 批量更新/删除同理,用 IN 或 foreach 构造条件

示例:批量插入订单

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

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

10657

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

7782

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

6772

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1144

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

948

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1396

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2809

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20111

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1235

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习