mybatis的mapper对应的xml写法及配置详解

 更新时间:2025年05月29日 10:45:07   作者:abcnull  
这篇文章给大家介绍mybatis的mapper对应的xml写法及配置详解,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧

前置

你使用

  • java
  • mybatis/mybatis plus

如果你使用 mybatis plus,也是会向下兼容 mybatis 的

mapper 对应 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.mapper.UserMapper">
    <!-- SQL 映射语句 -->
</mapper>

简单查询:

<!-- 简单查询 -->
<select id="getUserById" resultType="com.example.model.User">
	SELECT * FROM user WHERE id = #{id}
</select>
  • id:与 Mapper 接口中的方法名一致
  • resultType:返回值类型(Java 类的全限定名或别名)
  • #{id}:预编译参数,防止 SQL 注入
  • 如果返回 List,直接使用 resultType 即可,无需额外配置

简单插入:

<insert id="insertUser" parameterType="com.example.model.User">
    INSERT INTO user (name, age) VALUES (#{name}, #{age})
</insert>

parameterType:输入参数类型(可选,MyBatis 可自动推断)

简单更新:

<update id="updateUser" parameterType="com.example.model.User">
    UPDATE user SET name = #{name}, age = #{age} WHERE id = #{id}
</update>

简单删除:

<delete id="deleteUserById" parameterType="int">
    DELETE FROM user WHERE id = #{id}
</delete>

mapper 对应 xml 复杂配置

resultMap 配置
当数据库字段名与 Java 对象属性名不一致时,需使用 映射。一般都需要配置

<resultMap id="userResultMap" type="com.example.model.User">
    <id property="id" column="user_id"/>       <!-- 主键映射 -->
    <result property="name" column="user_name"/> <!-- 字段映射 -->
    <result property="age" column="user_age"/>
</resultMap>
<select id="getUserById" resultMap="userResultMap">
    SELECT user_id, user_name, user_age FROM user WHERE user_id = #{id}
</select>

if 条件

<select id="searchUsers" resultType="com.example.model.User">
    SELECT * FROM user
    <where>
        <if test="name != null anconcatd name != ''">
            AND name LIKE CONCAT('%', #{name}, '%')
        </if>
        <if test="age != null">
            AND age = #{age}
        </if>
    </where>
</select>

在MyBatis中,如果不写这样的条件判断,如果是对表的写操作,如 update,其中的 set 中当name参数为null时,生成的SQL语句会直接包含name = null,从而将数据库中的对应字段更新为NULL。这是MyBatis的默认行为,需要开发者显式控制是否要过滤null值

多条件选择 choose
类似于 Java 中的 switch-case 或 if-else 逻辑
<choose><when> 是按顺序判断的,一旦某个条件满足,后续条件不再判断

<select id="findUser" resultType="com.example.model.User">
    SELECT * FROM user
    <where>
        <choose>
            <when test="type == 'name'">
                AND name = #{value}
            </when>
            <when test="type == 'email'">
                AND email = #{value}
            </when>
            <otherwise>
                AND status = 'active'
            </otherwise>
        </choose>
    </where>
</select>

<otherwise> 是可选的,但如果省略且所有 <when> 条件都不满足,会导致 SQL 语句不完整或无效

遍历集合 foreach

<select id="getUsersByIds" resultType="com.example.model.User">
    SELECT * FROM user
    WHERE id IN
    <foreach item="id" collection="ids" open="(" separator="," close=")">
        #{id}
    </foreach>
</select>

分页查询

<select id="getUsersByPage" resultType="com.example.model.User">
    SELECT * FROM user
    LIMIT #{offset}, #{limit}
</select>

你也可以使用 pagehelper 工具,更常用,那就不需要 limit offset

如果你使用 mybatis plus,也有自己的方式,可以使用 IPage 来分页

Mapper 中的相关注解

@Param注解

@Select("SELECT * FROM user WHERE name = #{user_name} AND age = #{user_age}")
User getUserByNameAndAge(@Param("user_name") String userName, @Param("user_age") int userAge);

如果没写 @Param,MyBatis 默认将未使用 @Param 注解的参数封装为 Map,键名为 param1、param2、…、paramN(按参数顺序递增),也就是说 sql 中应该写 #{param1}#{param2}

其他

如果你不想使用 resultMap 来映射 mysql column 和 entity 的 field,还有其他办法吗?
方法一,使用 mybatis plus 的 @TableField 注解来指定 column 和 field 的映射
方法二:xml 中使用别名

<select id="getUserById" resultType="com.example.model.User">
    SELECT user_id AS id, user_name AS name, user_age AS age FROM user
</select>

choose when 和 if 区别
if 是独立的判断,而 choose when 更像 ifelse 逻辑,一旦判断一个满足,后续的 when 就不执行了!

到此这篇关于mybatis的mapper对应的xml写法的文章就介绍到这了,更多相关mybatis mapper对应的xml写法内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 图解Java经典算法希尔排序的原理与实现

    图解Java经典算法希尔排序的原理与实现

    希尔排序是希尔(Donald Shell)于1959年提出的一种排序算法。希尔排序也是一种插入排序,它是简单插入排序经过改进之后的一个更高效的版本,也称为缩小增量排序,同时该算法是冲破O(n2)的第一批算法之一。本文会以图解的方式详细介绍希尔排序的基本思想及其代码实现
    2022-09-09
  • JEE与Spring Boot代码性能比较分析

    JEE与Spring Boot代码性能比较分析

    JavaEE与Spring Boot其实很难比较测试,前者适合单体SOA架构,后者适合微服务,但是还是有好事者把两者放在一起比较性能。这篇文章主要介绍了JEE与Spring Boot代码性能比较,需要的朋友可以参考下
    2018-11-11
  • 从零开始学java之二叉树和哈希表实现代码

    从零开始学java之二叉树和哈希表实现代码

    这篇文章主要介绍了java之二叉树和哈希表实现的相关资料,二叉查找树和平衡二叉树是二叉树的两种特殊形式,哈希表是一种通过哈希函数将数据与哈希值关联起来的数据结构,可以快速查找数据,文中通过代码介绍的非常详细,需要的朋友可以参考下
    2025-04-04
  • Maven及Springboot配置JDK版本,编码,源码打包等方式

    Maven及Springboot配置JDK版本,编码,源码打包等方式

    这篇文章主要介绍了Maven及Springboot配置JDK版本,编码,源码打包等方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2023-12-12
  • SpringBoot后端进行数据校验JSR303的使用详解

    SpringBoot后端进行数据校验JSR303的使用详解

    这篇文章主要介绍了SpringBoot后端进行数据校验JSR303的使用详解,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-03-03
  • 线程池的七大核心参数以及常用的四种线程池详解

    线程池的七大核心参数以及常用的四种线程池详解

    这篇文章主要介绍了线程池的七大核心参数以及常用的四种线程池使用方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2025-05-05
  • Java 注解学习笔记

    Java 注解学习笔记

    这篇文章主要介绍了Java 注解的相关资料,帮助大家更好的理解和学习使用Java,感兴趣的朋友可以了解下
    2021-03-03
  • java基于UDP实现在线聊天功能

    java基于UDP实现在线聊天功能

    这篇文章主要为大家详细介绍了java基于UDP实现在线聊天功能,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-09-09
  • 关于jackson序列化和feign返回值的问题

    关于jackson序列化和feign返回值的问题

    这篇文章主要介绍了关于jackson序列化和feign返回值的问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-03-03
  • 用Java将字符串的首字母转换大小写

    用Java将字符串的首字母转换大小写

    在项目开发的时候会需要统一字符串的格式,比如首字母要求统一大写或小写,那用Java如何实现这一功能?下面一起来学习学习。
    2016-08-08

最新评论