mybatis-plus集成springboot实现XML映射器方式

更新时间：2026年03月15日 10:13:12 作者：一只游鱼

本文详细介绍了MyBatis-Plus中SQL映射配置的使用方法,包括动态SQL的支持和常见SQL操作的实现,通过XML映射器,可以灵活地定义复杂的查询语句,并处理动态条件和批量操作,文中还提供了具体的配置步骤和示例代码,帮助开发者更好地理解和应用这些功能

主要功能

SQL 映射配置

1、定义复杂的 SQL 查询语句

2、配置数据库操作与 Java 方法的映射关系

3、处理动态 SQL 语句

补充注解方式的不足

1、当 @Select、@Insert 等注解无法满足复杂 SQL 需求时

2、更好地管理长 SQL 语句，提高代码可读性

3、支持复杂的条件判断和循环操作

动态 SQL 支持

1、使用 <if>、<choose>、<when>、<otherwise> 等标签

2、实现条件查询和动态参数绑定

3、支持集合遍历等复杂操作

使用场景

1、复杂查询: 多表关联查询、嵌套查询等

2、动态条件: 根据不同参数构建不同的 SQL 语句

3、批量操作: 批量插入、更新等操作

4、自定义 SQL: 当 MyBatis-Plus 提供的通用方法无法满足需求时

XML 映射器本质上是 MyBatis 的特性，在 MyBatis-Plus 中同样适用，可以与通用 Mapper 方法并存使用。

应用

1.依赖

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.5.9</version>
</dependency>

2.配置

在application.properties文件中配置：

# 指定Mapper接口的xml文件位置

mybatis-plus.mapper-locations=classpath*:mapper/**/*.xml 

# 实体类包名

mybatis-plus.type-aliases-package=com.example.demo.pojo

3.创建xml文件

在mapper文件夹下新建xml包，新建UserMapper.xml文件，写入以下测试内容：

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"

        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">



<mapper namespace="com.example.demo.mapper.UserMapper" >



<!--这里写了一个方便区分的sql-->

    <delete id="deleteUserAaaaa">

        DELETE FROM user WHERE id = #{id}

    </delete>


</mapper>

4.声明方法

在UserMapper文件里声明：

//记得加上@mapper注解
@Mapper

public interface UserMapper extends BaseMapper<User> {

    int deleteUserAaaaa(@Param("id") Long id);



}

5.使用

这里在测试类里测试，

@Test

void testLogicDelete(){

    int affectedRows = userMapper.deleteUserAaaaa(4L);

    System.out.println("删除了" + affectedRows + "条记录");

}

运行后显示成功。。。。

常见SQL操作实现

（以下是官方的文档XML 映射器_MyBatis中文网）

1.Select

<select
  id="selectPerson"
  parameterType="int"
  parameterMap="deprecated"
  resultType="hashmap"
  resultMap="personResultMap"
  flushCache="false"
  useCache="true"
  timeout="10"
  fetchSize="256"
  statementType="PREPARED"
  resultSetType="FORWARD_ONLY">

属性：

id	在命名空间中唯一的标识符，可以被用来引用这条语句。
parameterType	将会传入这条语句的参数的类全限定名或别名。这个属性是可选的，因为 MyBatis 可以通过类型处理器（TypeHandler）推断出具体传入语句的参数，默认值为未设置（unset）。
parameterMap	用于引用外部 parameterMap 的属性，目前已被废弃。请使用行内参数映射和 parameterType 属性。
resultType	期望从这条语句中返回结果的类全限定名或别名。注意，如果返回的是集合，那应该设置为集合包含的类型，而不是集合本身的类型。 resultType 和 resultMap 之间只能同时使用一个。
resultMap	对外部 resultMap 的命名引用。结果映射是 MyBatis 最强大的特性，如果你对其理解透彻，许多复杂的映射问题都能迎刃而解。 resultType 和 resultMap 之间只能同时使用一个。
flushCache	将其设置为 true 后，只要语句被调用，都会导致本地缓存和二级缓存被清空，默认值：false。
useCache	将其设置为 true 后，将会导致本条语句的结果被二级缓存缓存起来，默认值：对 select 元素为 true。
timeout	这个设置是在抛出异常之前，驱动程序等待数据库返回请求结果的秒数。默认值为未设置（unset）（依赖数据库驱动）。
fetchSize	这是一个给驱动的建议值，尝试让驱动程序每次批量返回的结果行数等于这个设置值。默认值为未设置（unset）（依赖驱动）。
statementType	可选 STATEMENT，PREPARED 或 CALLABLE。这会让 MyBatis 分别使用 Statement，PreparedStatement 或 CallableStatement，默认值：PREPARED。
resultSetType	FORWARD_ONLY，SCROLL_SENSITIVE, SCROLL_INSENSITIVE 或 DEFAULT（等价于 unset）中的一个，默认值为 unset （依赖数据库驱动）。
databaseId	如果配置了数据库厂商标识（databaseIdProvider），MyBatis 会加载所有不带 databaseId 或匹配当前 databaseId 的语句；如果带和不带的语句都有，则不带的会被忽略。
resultOrdered	这个设置仅针对嵌套结果 select 语句：如果为 true，将会假设包含了嵌套结果集或是分组，当返回一个主结果行时，就不会产生对前面结果集的引用。这就使得在获取嵌套结果集的时候不至于内存不够用。默认值：false。

2.insert, update 和 delete

<insert
  id="insertAuthor"
  parameterType="domain.blog.Author"
  flushCache="true"
  statementType="PREPARED"
  keyProperty=""
  keyColumn=""
  useGeneratedKeys=""
  timeout="20">

<update
  id="updateAuthor"
  parameterType="domain.blog.Author"
  flushCache="true"
  statementType="PREPARED"
  timeout="20">

<delete
  id="deleteAuthor"
  parameterType="domain.blog.Author"
  flushCache="true"
  statementType="PREPARED"
  timeout="20">

属性：

id	在命名空间中唯一的标识符，可以被用来引用这条语句。
parameterType	将会传入这条语句的参数的类全限定名或别名。这个属性是可选的，因为 MyBatis 可以通过类型处理器（TypeHandler）推断出具体传入语句的参数，默认值为未设置（unset）。
parameterMap	用于引用外部 parameterMap 的属性，目前已被废弃。请使用行内参数映射和 parameterType 属性。
flushCache	将其设置为 true 后，只要语句被调用，都会导致本地缓存和二级缓存被清空，默认值：（对 insert、update 和 delete 语句）true。
timeout	这个设置是在抛出异常之前，驱动程序等待数据库返回请求结果的秒数。默认值为未设置（unset）（依赖数据库驱动）。
statementType	可选 STATEMENT，PREPARED 或 CALLABLE。这会让 MyBatis 分别使用 Statement，PreparedStatement 或 CallableStatement，默认值：PREPARED。
useGeneratedKeys	（仅适用于 insert 和 update）这会令 MyBatis 使用 JDBC 的 getGeneratedKeys 方法来取出由数据库内部生成的主键（比如：像 MySQL 和 SQL Server 这样的关系型数据库管理系统的自动递增字段），默认值：false。
keyProperty	（仅适用于 insert 和 update）指定能够唯一识别对象的属性，MyBatis 会使用 getGeneratedKeys 的返回值或 insert 语句的 selectKey 子元素设置它的值，默认值：未设置（unset）。如果生成列不止一个，可以用逗号分隔多个属性名称。
keyColumn	（仅适用于 insert 和 update）设置生成键值在表中的列名，在某些数据库（像 PostgreSQL）中，当主键列不是表中的第一列的时候，是必须设置的。如果生成列不止一个，可以用逗号分隔多个属性名称。
databaseId	如果配置了数据库厂商标识（databaseIdProvider），MyBatis 会加载所有不带 databaseId 或匹配当前 databaseId 的语句；如果带和不带的语句都有，则不带的会被忽略。

3.动态SQL

<!--    if标签-->

    <select id="selectUsers" resultType="User">

        SELECT * FROM user

        WHERE 1=1

        <if test="name != null">

            AND name = #{name}

        </if>

        <if test="age != null">

            AND age = #{age}

        </if>

    </select>



<!--    choose/when/otherwise 标签-->

    <select id="selectUsers" resultType="User">

        SELECT * FROM user

        WHERE 1=1

        <choose>

            <when test="name != null">

                AND name = #{name}

            </when>

            <when test="email != null">

                AND email = #{email}

            </when>

            <otherwise>

                AND status = 1

            </otherwise>

        </choose>

    </select>



<!--    where 标签 (自动处理 WHERE 和 AND/OR)-->

    <select id="selectUsers" resultType="User">

        SELECT * FROM user

        <where>

            <if test="name != null">

                AND name = #{name}

            </if>

            <if test="age != null">

                AND age = #{age}

            </if>

        </where>

    </select>



<!--    set 标签 (用于 UPDATE 语句)-->

    <update id="updateUser">

        UPDATE user

        <set>

            <if test="name != null">name=#{name},</if>

            <if test="age != null">age=#{age},</if>

            <if test="email != null">email=#{email},</if>

        </set>

        WHERE id=#{id}

    </update>

4.常见问题解决

参数为 null 的判断

<if test="name != null and name != ''">  <!-- 同时检查null和空字符串 -->

  AND name = #{name}

</if>

集合判空

<if test="ids != null and ids.size() > 0">

  AND id IN

  <foreach collection="ids" item="id" open="(" separator="," close=")">

    #{id}

  </foreach>

</if>

动态排序

<if test="orderBy != null">

  ORDER BY ${orderBy}

  <if test="asc != null and asc">

    ASC

  </if>

  <if test="asc != null and !asc">

    DESC

  </if>

</if>

总结

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

教你怎么用IDEA快速生成注释文档
这篇文章主要介绍了教你怎么用IDEA快速生成注释文档,文中有非常详细的代码示例,对正在学习IDEA操作的小伙伴们有很好地帮助,需要的朋友可以参考下
2021-05-05
Spring配置使用之Bean生命周期详解
这篇文章主要介绍了Spring配置使用之Bean生命周期详解，具有一定参考价值，需要的朋友可以了解下。
2017-10-10
JAVA缓存的使用RedisCache、LocalCache、复合缓存的操作
RedisCache是基于Redis的缓存,数据存储在内存中,并且可以被多个应用实例共享,属于分布式缓存,本文给大家介绍JAVA缓存的使用RedisCache、LocalCache、复合缓存的相关操作,感兴趣的朋友跟随小编一起看看吧
2026-02-02
Java中JUC 的 Exchange 交换器详情
这篇文章主要介绍了Java中JUC 的 Exchange 交换器详情，文章基于Java的相关资料展开详细的内容介绍，需要的小伙伴可以参考一下
2022-05-05
18个Java8日期处理的实践(太有用了)
这篇文章主要介绍了18个Java8日期处理的实践(太有用了)，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2020-01-01
Java中的@Conditional条件注解详细解析
这篇文章主要介绍了Java中的@Conditional条件注解详细解析,@Conditional是Spring4新提供的注解,它的作用是按照一定的条件进行判断,满足条件给容器注册bean,需要的朋友可以参考下
2023-11-11
SpringBoot Actuator监控的项目实践
本文主要结合 Spring Boot Actuator,跟大家一起分享微服务Spring Boot Actuator 的常见用法,方便我们在日常中对我们的微服务进行监控治理,感兴趣的可以了解一下
2024-01-01
Java Jenkins、Dockers和Kubernetes有什么区别详细总结
这篇文章主要介绍了Java Jenkins、Dockers和Kubernetes有什么区别的相关资料,Jenkins、Docker和Kubernetes分别在自动化流程、容器化封装与容器编排三个关键层面发挥着重要作用,需要的朋友可以参考下
2025-11-11
java精度计算代码 java指定精确小数位
这篇文章主要为大家详细介绍了java精度计算代码，java指定精确小数位，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2017-02-02
解决mybatis plus 驼峰式命名规则问题
这篇文章主要介绍了解决mybatis plus 驼峰式命名规则,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2020-09-09