‍♂️深入解读MyBatis常用函数：从入门到精通！

开篇语

哈喽，各位小伙伴们，你们好呀，我是喵手。运营社区：C站/掘金/腾讯云/阿里云/华为云/51CTO；欢迎大家常来逛逛

  今天我要给大家分享一些自己日常学习到的一些知识点，并以文字的形式跟大家一起交流，互相学习，一个人虽可以走的更快，但一群人可以走的更远。

  我是一名后端开发爱好者，工作日常接触到最多的就是Java语言啦，所以我都尽量抽业余时间把自己所学到所会的，通过文章的形式进行输出，希望以这种方式帮助到更多的初学者或者想入门的小伙伴们，同时也能对自己的技术进行沉淀，加以复盘，查缺补漏。

小伙伴们在批阅的过程中，如果觉得文章不错，欢迎点赞、收藏、关注哦。三连即是对作者我写作道路上最好的鼓励与支持！

前言 🌈

Hi, 大家好！今天带来的是一篇关于 MyBatis 常用函数的使用介绍。相信很多Java开发者都接触过MyBatis，它可是数据库访问框架中的“扛把子”之一，帮助我们高效、灵活地操作数据库。MyBatis以其轻量级、高效的特性，受到广大开发者的青睐。不过，MyBatis提供了许多好用的函数，初学者可能会有点晕。所以今天，我们就来一场MyBatis函数的大扫盲！😎

MyBatis的强大之处就在于，它不仅仅是一个SQL Mapper工具，还可以极大简化数据库操作。接下来，我们会从常用的核心函数入手，并带上拓展内容和实际案例，帮助大家更深刻地理解这些函数的妙用。文章包含实例代码，确保看完能马上上手实践！✨

---

📝 目录

1. MyBatis 介绍：简而不凡的SQL Mapper框架 🌐
2. MyBatis 核心常用函数 📜
   • selectOne 🎯
   • selectList 📋
   • insert ➕
   • update 🔄
   • delete 🗑️
3. MyBatis 进阶函数 📈
   • 参数动态绑定 🔗
   • 返回主键（useGeneratedKeys） 🔑
   • 批量操作（Batch Processing） 📦
4. MyBatis 自定义扩展函数 🛠️
5. MyBatis 函数使用案例 🔧
6. 总结与延伸阅读 🌠

---

1. MyBatis 介绍：简而不凡的SQL Mapper框架 🌐

在正式开始之前，先简单介绍一下MyBatis。MyBatis是一个优秀的持久层框架，它与Hibernate等ORM（Object Relational Mapping）框架不同，不强求对象与数据库表一一对应。开发者可以直接在XML文件或注解中编写SQL，这让它既保持了数据库操作的灵活性，也让SQL的编写和管理变得轻松。

MyBatis主要通过Mapper接口和SQL映射文件来实现业务逻辑。Mapper是MyBatis的灵魂，而对数据库的增删查改等操作就都在Mapper中实现。接下来，我们就来看一看MyBatis的常用函数是如何在Mapper中“大显身手”的！

---

2. MyBatis 核心常用函数 📜

2.1 selectOne 🎯

selectOne 用于查询单条数据。常用于通过ID或唯一键查询数据。返回结果是单个对象，当结果超过一条时会抛出异常，务必确保查询条件只会返回一条数据。

User user = sqlSession.selectOne("com.example.mapper.UserMapper.selectUser", 1);

小Tips 🧩

• 当你确定返回结果是唯一时，selectOne 是首选函数。否则可能会报错！
• selectOne 可以方便地与业务逻辑结合，通过ID直接获取对象。

---

2.2 selectList 📋

selectList 用于查询多条数据，它返回的是一个List集合。常用于条件查询。

List<User> userList = sqlSession.selectList("com.example.mapper.UserMapper.selectUsersByName", "Alice");

小Tips 🧩

• selectList非常适合用在分页查询和条件查询中，因为它的返回结果是List，数据量大时，最好搭配分页插件使用。

---

2.3 insert ➕

insert用于插入数据，插入成功后返回的是影响的行数。通常在插入数据时使用动态SQL或占位符来插入多种类型的数据。

int rowsAffected = sqlSession.insert("com.example.mapper.UserMapper.insertUser", user);

小Tips 🧩

• 配合useGeneratedKeys参数可以让数据库生成的主键自动返回。
• 使用批量插入时，可以大幅提升插入效率（例如批量导入用户数据）。

---

2.4 update 🔄

update用于更新数据，执行完成后返回被影响的行数。常用于更新用户信息、订单状态等。

int rowsAffected = sqlSession.update("com.example.mapper.UserMapper.updateUser", user);

小Tips 🧩

• update语句要注意条件设置，避免无条件更新造成大量数据被错误修改。
• set和where条件的使用要合理，动态SQL在这时能派上大用场。

---

2.5 delete 🗑️

delete用于删除数据，返回值是被删除的行数。常用于通过ID删除记录或批量删除数据。

int rowsAffected = sqlSession.delete("com.example.mapper.UserMapper.deleteUserById", 1);

小Tips 🧩

• 删除操作一定要慎重，尤其是在大数据表中操作，最好先测试删除条件。
• 可以在删除操作之前加一层逻辑判断，避免误删。

---

3. MyBatis 进阶函数 📈

3.1 参数动态绑定 🔗

动态SQL是MyBatis的一大特色，它可以帮助我们根据条件动态生成SQL。通过<if>、<where>、<foreach>等标签，MyBatis让SQL更具备灵活性。

<select id="selectUsersByCriteria" parameterType="Map" resultType="User">
  SELECT * FROM users
  <where>
    <if test="name != null">
      name = #{name}
    </if>
    <if test="age != null">
      AND age = #{age}
    </if>
  </where>
</select>

---

3.2 返回主键（useGeneratedKeys）🔑

当我们进行插入操作时，可以让数据库自动生成主键，并将其返回。只需在Mapper XML配置中添加useGeneratedKeys="true"即可。

<insert id="insertUser" parameterType="User" useGeneratedKeys="true" keyProperty="id">
  INSERT INTO users(name, age) VALUES(#{name}, #{age})
</insert>

---

3.3 批量操作 📦

批量操作可以显著提升性能，特别是在批量插入、更新数据时。MyBatis支持批量操作配置，方法是设置SQL会话模式为批处理（Batch）。

sqlSession.insert("com.example.mapper.UserMapper.insertUser", user);
sqlSession.insert("com.example.mapper.UserMapper.insertUser", user2);
sqlSession.flushStatements(); // 手动提交批量操作

---

4. MyBatis 自定义扩展函数 🛠️

MyBatis允许开发者通过插件机制进行自定义扩展。比如，我们可以定义一个分页查询的插件，让MyBatis自动处理分页逻辑。以下是一个简单的分页插件例子：

public class PaginationInterceptor implements Interceptor {
    @Override
    public Object intercept(Invocation invocation) throws Throwable {
        // 分页逻辑
        // 可以添加对SQL的封装，例如通过limit和offset实现分页
        return invocation.proceed();
    }
}

这样，通过插件方式，可以将分页逻辑统一在拦截器中实现，不需要在Mapper层面手动编写分页逻辑，提升了代码的整洁度和复用性。

---

5. MyBatis 函数使用案例 🔧

为了更直观地展示这些MyBatis函数的效果，我们来实现一个简单的“用户管理”功能，包括用户的增删查改。假设我们有一个User类，包含字段id、name和age。

1. 添加用户

User newUser = new User();
newUser.setName("Alice");
newUser.setAge(25);
sqlSession.insert("com.example.mapper.UserMapper.insertUser", newUser);

2. 查询用户

User user = sqlSession.selectOne("com.example.mapper.UserMapper.selectUser", 1);
System.out.println("查询结果：" + user.getName());

3. 更新用户信息

user.setAge(26);
sqlSession.update("com.example.mapper.UserMapper.updateUser", user);
System.out.println("用户信息已更新！");

4. 删除用户

sqlSession.delete("com.example.mapper.UserMapper.deleteUserById", user.getId());
System.out.println("用户已删除！");

通过这个简单的案例演示，相信大家对MyBatis的常用函数有了更直观的理解。只需要几行代码，我们就能完成数据的增删查改操作。

---

6. 总结与延伸阅读 🌠

MyBatis作为一款轻量级的持久层框架，凭借其灵活性和强大的SQL操作能力，帮助我们高效管理数据。在本文中，我们从基础的selectOne、selectList到进阶的批量操作、动态绑定，逐步深入MyBatis的核心功能。当然，MyBatis的应用远不止于此，像自定义插件、缓存机制等也是它的亮点，值得深入研究。

希望这篇文章能为你打开MyBatis的新世界，接下来就去代码里实践吧！

… …

文末

好啦，以上就是我这期的全部内容，如果有任何疑问，欢迎下方留言哦，咱们下期见。

… …

学习不分先后，知识不分多少；事无巨细，当以虚心求教；三人行，必有我师焉！！！

wished for you successed ！！！

---

⭐️若喜欢我，就请关注我叭。

⭐️若对您有用，就请点赞叭。

⭐️若有疑问，就请评论留言告诉我叭。