【Spring Boot基础】MyBatis的基础操作：增删查改、列名和属性名匹配 -- XML实现

Code哈哈笑2025-04-23 9:21

MyBatis的基础操作

  • [1. MyBatis XML配置文件](#1. MyBatis XML配置文件)
    • [1.1 简单介绍](#1.1 简单介绍)
    • [1.2 配置连接字符串和MyBatis](#1.2 配置连接字符串和MyBatis)
    • [1.3 XMl文件实现--分层](#1.3 XMl文件实现--分层)
    • [1.4 XMl文件实现--举例](#1.4 XMl文件实现--举例)
  • 2.增删改查操作
    • [2.1 增（insert）](#2.1 增（insert）)
      • [2.1.1 不使用@Param](#2.1.1 不使用@Param)
      • [2.1.2 用@Param](#2.1.2 用@Param)
      • [2.1.3 返回自增键](#2.1.3 返回自增键)
    • [2.2 删（delete）](#2.2 删（delete）)
      • [2.2.1 传参 Integer](#2.2.1 传参 Integer)
      • [2.2.2 传参 对象](#2.2.2 传参 对象)
    • [2.3 改（update）](#2.3 改（update）)
    • [2.4 查（select）](#2.4 查（select）)
  • [3 列名和属性名匹配](#3 列名和属性名匹配)
    • [3.1 起别名 as](#3.1 起别名 as)
    • [3.2 结果映射\<resultMap>](#3.2 结果映射<resultMap>)
    • [3.3 配置文件中开启驼峰命令](#3.3 配置文件中开启驼峰命令)

1. MyBatis XML配置文件

1.1 简单介绍

使⽤Mybatis的注解方式，主要是来完成⼀些简单的增删改查功能.

如果需要实现复杂的SQL功能，建议使⽤XML来配置映射语句，也就是将SQL语句写在XML配置⽂件中。

MyBatis XML的⽅式需要以下两步：

1.配置数据库连接字符串和MyBatis

2.写持久层代码

1.2 配置连接字符串和MyBatis

此步骤需要进⾏两项设置，数据库连接字符串设置和 MyBatis 的 XML ⽂件配置。

application.yml⽂件, 配置内容如下:

java 复制代码 
# 配置 mybatis xml 的⽂件路径，在 resources/mapper 创建所有表的 xml ⽂件
mybatis:
  mapper-locations: classpath:mapper/**Mapper.xml

application.properties⽂件, 配置内容如下:

java 复制代码 
# 配置 mybatis xml 的⽂件路径，在 resources/mapper 创建所有表的 xml ⽂件
mybatis.mapper-locations=classpath:mapper/**Mapper.xml

1.3 XMl文件实现--分层

持久层代码分两部分：

（1）⽅法定义 Interface

（2）⽅法实现: XXX.xml

1.4 XMl文件实现--举例

举例：

（0）详细的准备工作请看MyBatis入门

在java/org.example.mybatis.model下创建一个实体类：

java 复制代码 
@Data
public class UserInfo {

    private Integer id;
    private String username;
    private String password;
    private Integer age;
    private Integer gender;
    private String phone;
    private Integer deleteFlag;
    private Date createTime;
    private Date updateTime;

}

（1）Mapper接口：

java 复制代码 
package org.example.mybatis.mapper;

import org.apache.ibatis.annotations.Mapper;
import org.example.mybatis.model.UserInfo;

import java.util.List;

@Mapper
public interface UserInfoXMLMapper {

    //定义接口
    List<UserInfo> queryAllUser();
}

（2）在resources下创建mapper目录

（3）在resources/mapper创建UserInfoXMLMapper.xml文件

如果创建的新文件中有内容，把文件中的内容全部删去，添加以下内容（数据持久成的实现，MyBatis 的固定 xml 格式）：

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="org.example.mybatis.mapper.UserInfoXMLMapper">

</mapper>

注意：<mapper namespace="org.example.mybatis.mapper.UserInfoXMLMapper"></mapper>中的namespace = 创建接口类的路径+接口名称

图解：

（4）查询所有⽤⼾的具体实现 ：

xml 复制代码 
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="org.example.mybatis.mapper.UserInfoXMLMapper">

    <select id="queryAllUser" resultType="org.example.mybatis.model.UserInfo">
        select id,username, password, age, gender, phone,delete_flag,
               create_time,update_time from user_info
    </select>

</mapper>

以下是对以上标签的说明：

（1）<Mapper>标签：需要指定 nemespace 属性，表示命名空间，值为 mapper 接⼝的全限定名，等于 括全包名.类名

（2）<select>查询标签：是⽤来执⾏数据库的查询操作的，其中的 id 和 Mapper接口中的方法名是一样的，表示对接口的具体实现方法。resultType是返回的数据类型，也就是开头我们定义的实体类。

测试代码：

java 复制代码 
@Slf4j
@SpringBootTest //启动Sring 容器
class UserInfoXMLMapperTest {

    @Autowired
    private UserInfoXMLMapper userInfoXMLMapper;

    @Test
    void queryAllUser() {
        userInfoXMLMapper.queryAllUser();
    }
}

运行结果：

2.增删改查操作

2.1 增（insert）

2.1.1 不使用@Param

UserInfoXMLMapper接口：

java 复制代码 
@Mapper
public interface UserInfoXMLMapper {

    //定义接口
    Integer insert(UserInfo userinfo);
}

UserInfoXMLMapper.xml文件：

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="org.example.mybatis.mapper.UserInfoXMLMapper">

	//插入
    <insert id = "insert" >
        insert into user_info (username, password, age, gender, phone)
        values(#{username}, #{password},#{age}, #{gender},#{phone})
    </insert>
    
</mapper>

接口中方法接收的参数会自动与 #{username}, #{password},#{age}, #{gender},#{phone} 匹配。

测试代码：

java 复制代码 
@Slf4j
@SpringBootTest //启动Sring 容器
class UserInfoXMLMapperTest {

    @Autowired
    private UserInfoXMLMapper userInfoXMLMapper;

    @Test
    void insert() {
        UserInfo userInfo= new UserInfo();
        userInfo.setUsername("6666");
        userInfo.setPassword("6666");
        userInfo.setAge(19);
        userInfo.setGender(1);
        userInfo.setPhone("6666666");

        userInfoXMLMapper.insert(userInfo);
    }
}

运行结果：

MySQL：

2.1.2 用@Param

UserInfoXMLMapper接口：

java 复制代码 
@Mapper
public interface UserInfoXMLMapper {

    //定义接口
    Integer insert(@Param("userInfo") UserInfo uInfo);
}

UserInfoXMLMapper.xml文件：

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="org.example.mybatis.mapper.UserInfoXMLMapper">

	//插入
    <insert id = "insert" >
        insert into user_info (username, password, age, gender, phone)
        values(#{username}, #{password},#{age}, #{gender},#{phone})
    </insert>
    
</mapper>

测试代码：

java 复制代码 
@Slf4j
@SpringBootTest //启动Sring 容器
class UserInfoXMLMapperTest {

    @Autowired
    private UserInfoXMLMapper userInfoXMLMapper;

    @Test
    void insert() {
        UserInfo userInfo= new UserInfo();
        userInfo.setUsername("6666");
        userInfo.setPassword("6666");
        userInfo.setAge(19);
        userInfo.setGender(1);
        userInfo.setPhone("6666666");

        userInfoXMLMapper.insert(userInfo);
    }
}

运行结果：

很明显，发生报错，报错的内容是：没有找到usernam参数，但是有可用的参数userInfo

说明：当使用@Param把传的参数改为userInfo后，#{username}, #{password},#{age}, #{gender},#{phone} 就不能自动从对象中匹配值，需要使用明确的指出数据来自哪。

修改后的xml文件：

java 复制代码 
<?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="org.example.mybatis.mapper.UserInfoXMLMapper">


    <insert id = "insert" >
        insert into user_info (username, password, age, gender, phone)
        values(#{userInfo.username}, #{userInfo.password},
               #{userInfo.age}, #{userInfo.gender},#{userInfo.phone})
    </insert>

</mapper>

测试代码：

java 复制代码 
@Slf4j
@SpringBootTest //启动Sring 容器
class UserInfoXMLMapperTest {

    @Autowired
    private UserInfoXMLMapper userInfoXMLMapper;

    @Test
    void insert() {
        UserInfo userInfo= new UserInfo();
        userInfo.setUsername("6666");
        userInfo.setPassword("6666");
        userInfo.setAge(19);
        userInfo.setGender(1);
        userInfo.setPhone("6666666");

        userInfoXMLMapper.insert(userInfo);
    }
}

运行结果：

MySQL：

2.1.3 返回自增键

UserInfoXMLMapper接口：

java 复制代码 
@Mapper
public interface UserInfoXMLMapper {

    //定义接口
    Integer insert(UserInfo userInfo);
}

UserInfoXMLMapper.xml文件：

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="org.example.mybatis.mapper.UserInfoXMLMapper">

	//插入
    <insert id = "insert" useGeneratedKeys="true" keyProperty="id">
        insert into user_info (username, password, age, gender, phone)
        values(#{username}, #{password},#{age}, #{gender},#{phone})
    </insert>
    
</mapper>

测试代码：

java 复制代码 
@Slf4j
@SpringBootTest //启动Sring 容器
class UserInfoXMLMapperTest {

    @Autowired
    private UserInfoXMLMapper userInfoXMLMapper;

    @Test
    void insert() {
        UserInfo userInfo= new UserInfo();
        userInfo.setUsername("6666");
        userInfo.setPassword("6666");
        userInfo.setAge(19);
        userInfo.setGender(1);
        userInfo.setPhone("6666666");

        Integer count = userInfoXMLMapper.insert(userInfo);
        log.info("影响的行数：" +count+"， 返回的主键：" +userInfo.getId());
    }
}

运行结果：

MySQL：

2.2 删（delete）

2.2.1 传参 Integer

UserInfoXMLMapper接口：

java 复制代码 
@Mapper
public interface UserInfoXMLMapper {

    //定义接口
    Integer delete(Integer id);
}

UserInfoXMLMapper.xml文件：

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="org.example.mybatis.mapper.UserInfoXMLMapper">

	//插入
    <delete id = "delete" >
        delete from user_info where id=#{id}
    </delete>
    
</mapper>

测试代码：

java 复制代码 
@Slf4j
@SpringBootTest //启动Sring 容器
class UserInfoXMLMapperTest {

    @Autowired
    private UserInfoXMLMapper userInfoXMLMapper;

    @Test
    void delete() {
        userInfoXMLMapper.delete(11);
    }
}

运行结果：

MySQL：

2.2.2 传参 对象

UserInfoXMLMapper接口：

java 复制代码 
@Mapper
public interface UserInfoXMLMapper {

    //定义接口
    Integer delete(UserInfo userInfo);
}

UserInfoXMLMapper.xml文件：

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="org.example.mybatis.mapper.UserInfoXMLMapper">

	//插入
    <delete id = "delete" >
        delete from user_info where id=#{id}
    </delete>
    
</mapper>

测试代码：

java 复制代码 
@Slf4j
@SpringBootTest //启动Sring 容器
class UserInfoXMLMapperTest {

    @Autowired
    private UserInfoXMLMapper userInfoXMLMapper;

    @Test
    void delete() {
        UserInfo userInfo= new UserInfo();
    	userInfo.setId(10);
        userInfoXMLMapper.delete(userInfo);
    }
}

运行结果：

MySQL：

2.3 改（update）

UserInfoXMLMapper接口：

java 复制代码 
@Mapper
public interface UserInfoXMLMapper {

    Integer update(UserInfo uerInfo);
}

UserInfoXMLMapper.xml文件：

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="org.example.mybatis.mapper.UserInfoXMLMapper">

    <update id ="update">
        update user_info set username=#{username} where id =#{id}
    </update>

</mapper>

测试代码：

java 复制代码 
@Slf4j
@SpringBootTest //启动Sring 容器
class UserInfoXMLMapperTest {

    @Autowired
    private UserInfoXMLMapper userInfoXMLMapper;

    @Test
    void update() {
        UserInfo userInfo= new UserInfo();
        userInfo.setUsername("9999999");
        userInfo.setId(9);

        userInfoXMLMapper.update(userInfo);

    }
}

运行结果：

MySQL:

2.4 查（select）

UserInfoXMLMapper接口：

java 复制代码 
@Mapper
public interface UserInfoXMLMapper {

    List<UserInfo> queryAllUser();
}

UserInfoXMLMapper.xml文件：

java 复制代码 
<?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="org.example.mybatis.mapper.UserInfoXMLMapper">

    <select id ="queryAllUser" resultType="org.example.mybatis.model.UserInfo">
        select id ,username, password, age, gender, phone,
               delete_flag,create_time,update_time from user_info
    </select>

</mapper>

运行结果：

上述是MySQL查询的结果，下面是映射到Java类的结果：

为什么 delete_flag,create_time,update_time 的值为空呢？

MyBatis 会根据方法的返回结果进⾏赋值.

方法用对象 UserInfo接收返回结果, MySQL 查询出来数据为⼀条, 就会自动赋值给对象.

方法用List接收返回结果, MySQL 查询出来数据为多条时, 也会⾃动赋值给List。

但是⽅法使⽤UserInfo接收，MySQL 查询返回的数据为多条时, MyBatis执⾏就会报错。

原因分析 :

当对象中有多个属性时，自动映射查询结果时，MyBatis 会获取结果中返回的列名并在 Java 类中查找相同名字的属性。 这意味着如果发现了 id 列和 id 属性，MyBatis 会将列 id的值赋给 id 属性，如果发现了delete_flag列和 deleteFlag属性，MyBatis 不会将delete_flag列的值赋给 deleteFlag属性。

解决方法在下面的章节

3 列名和属性名匹配

3.1 起别名 as

在SQL语句中，给列名起别名，保持别名和实体类属性名⼀样（XML文件）：

java 复制代码 
<?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="org.example.mybatis.mapper.UserInfoXMLMapper">

    <select id ="queryAllUser" resultType="org.example.mybatis.model.UserInfo">
        select id ,username, password, age, gender, phone,
               delete_flag as deleteFlag,create_time as createTime,
               update_time as updateTime from user_info
    </select>
</mapper>

测试代码：

java 复制代码 
@Slf4j
@SpringBootTest //启动Sring 容器
class UserInfoXMLMapperTest {

    @Test
    void queryAllUser() {
        List<UserInfo> u = userInfoXMLMapper.queryAllUser();
        for(Object it : u){
            log.info(it.toString());
        }
}

运行结果：

3.2 结果映射<resultMap>

需要使用<resultMap>标签进行映射（XML文件）：

java 复制代码 
<?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="org.example.mybatis.mapper.UserInfoXMLMapper">

   <resultMap id="baseMap" type="org.example.mybatis.model.UserInfo">
        <id column="id" property="id"></id>
        <result column="delete_flag" property="deleteFlag"></result>
        <result column="create_time" property="createTime"></result>
        <result column="update_time" property="updateTime"></result>
    </resultMap>

    <select id ="queryAllUser" resultType="org.example.mybatis.model.UserInfo" resultMap="baseMap">
        select id ,username, password, age, gender, phone,
               delete_flag, create_time ,
               update_time from user_info
    </select>

</mapper>

一个resultMap可以被重复使用，resultMap的id可以被很多的标签使用。

3.3 配置文件中开启驼峰命令

在配置文件Application.yml文件中添加如下的配置：

java 复制代码 
mybatis:
  configuration:
    map-underscore-to-camel-case: true #配置驼峰⾃动转换

在配置文件Application.properties文件中添加如下的配置：

java 复制代码 
mybatis.configuration.map-underscore-to-camel-case: true #配置驼峰⾃动转换

Mapper接口：

java 复制代码 
@Mapper
public interface UserInfoXMLMapper {
    List<UserInfo> queryAllUser();
}

XML文件对SQL语句的实现：

java 复制代码 
<?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="org.example.mybatis.mapper.UserInfoXMLMapper">

   <resultMap id="baseMap" type="org.example.mybatis.model.UserInfo">
        <id column="id" property="id"></id>
        <result column="delete_flag" property="deleteFlag"></result>
        <result column="create_time" property="createTime"></result>
        <result column="update_time" property="updateTime"></result>
    </resultMap>

    <select id ="queryAllUser" resultType="org.example.mybatis.model.UserInfo" resultMap="baseMap">
        select id ,username, password, age, gender, phone,
               delete_flag, create_time ,
               update_time from user_info
    </select>

</mapper>

测试代码：

java 复制代码 
@Slf4j
@SpringBootTest //启动Sring 容器
class UserInfoXMLMapperTest {

    @Test
    void queryAllUser() {
        List<UserInfo> u = userInfoXMLMapper.queryAllUser();
        for(Object it : u){
            log.info(it.toString());
        }
    }
}

运行结果：

数据库的字段名 => 类的属性名
驼峰命名规则： abc_xyz => abcXyz

表中字段名：abc_xyz

类中属性名：abcXyz

相关推荐
neoooo2 分钟前
别慌，Java只有值传递——一次搞懂“为啥我改了它还不变”！
java·后端·spring
秋难降2 分钟前
Python 知识 “八股”：给有 C 和 Java 基础的你😁😁😁
java·python·c
wuxuanok5 分钟前
Web后端开发-请求响应
java·开发语言·笔记·学习
用户7785371836966 分钟前
一力破万法：从0实现一个http代理池
后端·爬虫
livemetee13 分钟前
spring-ai 1.0.0 （3）交互增强：Advisor 顾问模块
java
DDDDDouble18 分钟前
＜二＞Sping-AI alibaba 入门-记忆聊天及持久化
java·人工智能
拖孩33 分钟前
微信群太多，管理麻烦？那试试接入AI助手吧~
前端·后端·微信
一切顺势而行37 分钟前
kafka总结
java
Humbunklung42 分钟前
Rust枚举：让数据类型告别单调乏味
开发语言·后端·rust
radient1 小时前
Golang-GMP 万字洗髓经
后端·架构
热门推荐
01Java学习第十五部分——MyBatis02集群聊天服务器---MySQL数据库的建立03Coze扣子平台完整体验和实践（附国内和国际版对比）04基于odoo17的设计模式详解---装饰模式05使用Ruby接入实时行情API教程06扣子（coze）实战|我用扣子搭建了一个自动分析小红薯笔记内容的AI应用|详细步骤拆解07Everything文件检索工具 几秒检索几百G的文件08基于odoo17的设计模式详解---单例模式09DeepSeek各版本说明与优缺点分析10【无标题】