news 2026/6/9 23:48:55

MyBatis 入门到实践:一篇文章带你掌握核心用法

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
MyBatis 入门到实践:一篇文章带你掌握核心用法

一、什么是 MyBatis?

MyBatis是一款优秀的Java 持久层框架,它通过XML 或注解的方式,将 SQL 语句与 Java 对象进行映射,简化了 JDBC 操作,同时又保留了 SQL 的灵活性。

一句话总结:

MyBatis = JDBC 封装 + SQL 可控

MyBatis 的优点

  • SQL 可控、可优化(比 Hibernate 更灵活)

  • 与 Spring 集成方便

  • 学习成本低,适合初学者

  • 支持动态 SQL,功能强大


二、MyBatis 的核心组成

MyBatis 的核心主要包括以下几个部分:

组件作用
SqlMapConfig.xml全局配置文件
Mapper.xmlSQL 映射文件
Mapper 接口定义数据库操作方法
SqlSessionFactory创建 SqlSession
SqlSession执行 SQL 的核心对象

三、MyBatis 开发环境搭建

1. 引入依赖(Maven)

<dependencies> <!-- MyBatis --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.5.13</version> </dependency> <!-- MySQL 驱动 --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.33</version> </dependency> </dependencies>

2. 创建 MyBatis 核心配置文件

SqlMapConfig.xml

<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd"> <configuration> <!-- 环境配置 --> <environments default="development"> <environment id="development"> <transactionManager type="JDBC"/> <dataSource type="POOLED"> <property name="driver" value="com.mysql.cj.jdbc.Driver"/> <property name="url" value="jdbc:mysql://localhost:3306/test"/> <property name="username" value="root"/> <property name="password" value="123456"/> </dataSource> </environment> </environments> <!-- 映射文件 --> <mappers> <mapper resource="mapper/UserMapper.xml"/> </mappers> </configuration>

四、创建实体类(Entity)

public class User { private Integer id; private String username; private String password; // getter / setter }

五、Mapper 映射文件

1. 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.qcby.mapper.UserMapper"> <select id="findAll" resultType="com.qcby.entity.User"> select * from user </select> <select id="findById" parameterType="int" resultType="com.qcby.entity.User"> select * from user where id = #{id} </select> <insert id="insertUser" parameterType="com.qcby.entity.User"> insert into user(username,password) values(#{username},#{password}) </insert> </mapper>

2. Mapper 接口

public interface UserMapper { List<User> findAll(); User findById(int id); void insertUser(User user); }

六、MyBatis 执行流程示例

public class MyBatisTest { public static void main(String[] args) throws Exception { // 1. 读取配置文件 InputStream in = Resources.getResourceAsStream("SqlMapConfig.xml"); // 2. 创建 SqlSessionFactory SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(in); // 3. 获取 SqlSession SqlSession sqlSession = factory.openSession(); // 4. 获取 Mapper 代理对象 UserMapper mapper = sqlSession.getMapper(UserMapper.class); // 5. 执行方法 List<User> users = mapper.findAll(); users.forEach(System.out::println); // 提交事务 sqlSession.commit(); // 关闭资源 sqlSession.close(); in.close(); } }

七、MyBatis 参数传递方式

1. 基本类型

where id = #{id}

2. 对象参数

where username = #{username}

3. 多参数(@Param)

User find(@Param("name") String name, @Param("pwd") String pwd);
where username = #{name} and password = #{pwd}

八、MyBatis 动态 SQL(重点)

1. if 标签

<select id="findUser" resultType="User"> select * from user <where> <if test="username != null"> and username = #{username} </if> <if test="password != null"> and password = #{password} </if> </where> </select>

2. foreach(批量操作)

<select id="findByIds" resultType="User"> select * from user where id in <foreach collection="list" item="id" open="(" close=")" separator=","> #{id} </foreach> </select>

九、MyBatis 常见问题总结

1. 找不到 Mapper.xml

  • 确认路径是否在resources

  • resource="mapper/UserMapper.xml"路径是否正确

2. Getter 错误

  • 实体类属性名与 SQL 返回字段不一致

  • 缺少 getter / setter 方法

3. 事务未提交

  • 增删改操作后记得sqlSession.commit()


十、总结

MyBatis 作为 Java 后端中使用最广泛的持久层框架之一,具有以下特点:

  • SQL 灵活、易于优化

  • 配置清晰、扩展性强

  • 非常适合学习数据库与 Java 持久层原理

建议学习路线:
JDBC → MyBatis → MyBatis + Spring → MyBatis Plus

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/6/9 22:17:41

【开题答辩全过程】以 基于微信小程序的医院自助挂号系统为例,包含答辩的问题和答案

个人简介一名14年经验的资深毕设内行人&#xff0c;语言擅长Java、php、微信小程序、Python、Golang、安卓Android等开发项目包括大数据、深度学习、网站、小程序、安卓、算法。平常会做一些项目定制化开发、代码讲解、答辩教学、文档编写、也懂一些降重方面的技巧。感谢大家的…

作者头像 李华
网站建设 2026/6/9 22:06:24

自动化测试脚本调试:Chrome Driver实用技巧

如何真正用好 Chrome Driver&#xff1f;一个测试工程师的实战手记 最近在做 CI/CD 流水线中的自动化回归测试&#xff0c;又一次被“元素找不到”、“页面加载超时”、“莫名其妙失败”这些老问题缠上。翻日志、截图、重跑脚本……一顿操作下来&#xff0c;时间过去了两小时&…

作者头像 李华
网站建设 2026/6/9 21:28:25

PyTorch-CUDA-v2.6镜像升级路线图及长期支持计划

PyTorch-CUDA-v2.6 镜像升级路线图及长期支持计划 在当今深度学习研发节奏日益加快的背景下&#xff0c;一个稳定、高效且开箱即用的开发环境已成为团队竞争力的关键组成部分。尤其是在大模型训练、多任务并行调度和跨平台部署场景下&#xff0c;环境一致性问题常常成为项目推进…

作者头像 李华
网站建设 2026/6/9 18:43:38

HuggingFace Pipeline零代码调用预训练模型示例

HuggingFace Pipeline零代码调用预训练模型示例 在当今AI技术快速渗透各行各业的背景下&#xff0c;越来越多开发者希望快速验证一个想法——比如让机器理解用户评论的情感倾向&#xff0c;或是从一段文本中提取关键信息。但现实往往是&#xff1a;环境配置卡住半天&#xff0c…

作者头像 李华
网站建设 2026/6/9 21:36:34

Java基础-类型转换以及易错点

在 Java 中&#xff0c;类型转换是不同数据类型之间赋值 / 运算时的类型适配方式&#xff0c;分为 ** 隐式转换&#xff08;自动类型提升&#xff09;和强制转换&#xff08;显式类型转换&#xff09;** 两类&#xff0c;核心区别是 “是否需要手动干预”&#xff0c;以下是详细…

作者头像 李华