MyBatis 核心入门:从概念到实战,一篇掌握简单增删改查
目录
一、什么是 MyBatis?为什么要用它?
二、MyBatis 核心概念(通俗理解)
1.SqlSessionFactory
2.SqlSession
3.Mapper接口
4.映射文件(XML)
三、手把手搭建第一个 MyBatis 项目
1. 准备工作
2. 核心配置文件(mybatis-config.xml)
3. 编写实体类(User.java)
4. 编写 Mapper 接口(UserMapper.java)
5. 编写映射文件(UserMapper.xml)
6. 编写测试类(MyBatisTest.java)
四、核心知识点总结
1.参数传递
2.结果映射
一、什么是 MyBatis?为什么要用它?
MyBatis 是一款 Java 半自动化映射框架,核心作用是简化数据库操作。
对比传统 JDBC:
- 无需手动写 Connection、Statement、ResultSet 等重复代码 SQL 语句,减少了50%以上的代码量。
- 与 Java 代码分离,便于维护和优化 自动完成数据库字段与 Java 实体类的映射。
- 提供映射标签,支持对象与数据库的 ORM 字段关系映射。
简单说:用 MyBatis 写数据库操作,更简单、更灵活
二、MyBatis 核心概念(通俗理解)
1.SqlSessionFactory
- 数据库连接的 “工厂”,通过核心配置文件创建
- 作用:生产SqlSession(类似生产 “数据库连接”,同样也需要关闭资源)
2.SqlSession
- 数据库会话对象,相当于“数据库连接”
- 作用:获取Mapper接口,执行SQL操作
3.Mapper接口
- 定义数据库操作方法(如 selectUserById、insertUser)
- 无需实现类,MyBatis 会自动生成代理对象
4.映射文件(XML)
- 存放 SQL 语句,与 Mapper 接口一一对应
- 通过标签(select/insert 等)绑定接口方法
三、手把手搭建第一个 MyBatis 项目
1. 准备工作
数据库:MySQL,创建 user 表(附建表 SQL):
CREATE TABLE `user` (`id` int(11) PRIMARY KEY AUTO_INCREMENT,`username` varchar(50) NOT NULL,`age` int(3) DEFAULT NULL,`create_time` datetime DEFAULT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
项目:Maven 工程,引入依赖(pom.xml):
<!-- MyBatis 核心包 -->
<dependency><groupId>org.mybatis</groupId><artifactId>mybatis</artifactId><version>3.5.10</version>
</dependency>
<!-- MySQL 驱动 -->
<dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>8.0.30</version>
</dependency>
2. 核心配置文件(mybatis-config.xml)
放在 resources 目录下,配置数据库连接和映射文件路径:
<?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"><!-- 事务管理:JDBC 方式 --><transactionManager type="JDBC"/><!-- 数据源:连接池方式 --><dataSource type="POOLED"><property name="driver" value="com.mysql.cj.jdbc.Driver"/><property name="url" value="jdbc:mysql://localhost:3306/mybatis_demo?useSSL=false"/><property name="username" value="root"/> <!-- 你的数据库用户名 --><property name="password" value="123456"/> <!-- 你的数据库密码 --></dataSource></environment></environments><!-- 映射文件路径:指定 Mapper XML 位置 --><mappers><mapper resource="mapper/UserMapper.xml"/></mappers>
</configuration>
3. 编写实体类(User.java)
属性与表字段对应(建议用驼峰命名,如 createTime 对应表 create_time):
public class User {private Integer id;private String username;private Integer age;private LocalDateTime createTime;// 省略 getter、setter、toString 方法
}
4. 编写 Mapper 接口(UserMapper.java)
定义数据库操作方法:
public interface UserMapper {//查询所有用户List<User> selectAllUser();// 根据 ID 查询用户User selectById(Integer id);// 新增用户int insert(User user);// 根据 ID 修改用户int updateById(User user);// 根据 ID 删除用户int deleteById(Integer id);
}
5. 编写映射文件(UserMapper.xml)
放在 resources/mapper 目录下,绑定 Mapper 接口并写 SQL:
<?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">
<!-- namespace 必须与 Mapper 接口全类名一致 -->
<mapper namespace="com.example.mapper.UserMapper"><!-- 查询:id 与接口方法名一致,resultType 是返回类型 --><select id="selectById" resultType="com.example.pojo.User">select * from user where id = #{id}</select><!-- 新增:useGeneratedKeys 获取自增主键,keyProperty 绑定实体类属性 --><insert id="insert" useGeneratedKeys="true" keyProperty="id">insert into user(username, age, create_time)values(#{username}, #{age}, #{createTime})</insert><!-- 修改 --><update id="updateById">update user setusername = #{username},age = #{age}where id = #{id}</update><!-- 删除 --><delete id="deleteById">delete from user where id = #{id}</delete>
</mapper>
#{}是一种常见的占位符语法, 用于将变量或表达式的结果嵌入到双引号/单引号字符串中,自动转换为字符串类型。(能够有效防止sql注入问题)
6. 编写测试类(MyBatisTest.java)
通过SqlSession执行操作:
public class MyBatisTest {public static void main(String[] args) throws IOException {// 1. 读取核心配置文件InputStream is = Resources.getResourceAsStream("mybatis-config.xml");// 2. 创建 SqlSessionFactorySqlSessionFactory factory = new SqlSessionFactoryBuilder().build(is);// 3. 获取 SqlSession(true 表示自动提交事务)SqlSession session = factory.openSession(true);// 4. 获取 Mapper 接口代理对象UserMapper userMapper = session.getMapper(UserMapper.class);// 5. 执行 SQL 操作// 新增用户User user = new User();user.setUsername("张三");user.setAge(20);user.setCreateTime(LocalDateTime.now());int insert = userMapper.insert(user);System.out.println("新增成功,影响行数:" + insert);System.out.println("新增的用户 ID:" + user.getId()); // 自增 ID 会回显// 查询用户(用上面新增的 ID)User queryUser = userMapper.selectById(user.getId());System.out.println("查询结果:" + queryUser);// 修改用户queryUser.setAge(21);int update = userMapper.updateById(queryUser);System.out.println("修改成功,影响行数:" + update);// 删除用户int delete = userMapper.deleteById(user.getId());System.out.println("删除成功,影响行数:" + delete);// 6. 关闭会话session.close();}
}
四、核心知识点总结
1.参数传递
- 单个参数:直接用 #{参数名}(如 #{id})
- 多个参数:有两种方法:(1)传入参数时放入Map键值对,通过键名访问值,达到传入多个参数的目的;(2)传入参数时将要传入的值封装到实体类中,通过访问实体类属性名传入多个参数
- 实体类参数:用 #{属性名}(如 #{username} 对应 user.getUsername())
2.结果映射
- 表字段与实体属性名一致:用 resultType 直接指定实体类
- 符合Mybatis定义映射规则:用 resultType 直接指定实体类,并且在mybatis-config.xml里面配置驼峰映射
- 不一致:用 resultMap 手动映射
<settings><!--将数据库中的下划线映射为驼峰--><setting name="mapUnderscoreToCamelCase" value="true"/> </settings>位置放于mybatis-config.xml中<environments>前
<resultMap id="userMap" type="com.example.pojo.User"><id column="id" property="id"/> <!-- 主键 --><result column="username" property="username"/><result column="age" property="age"/><result column="create_time" property="createTime"/> <!-- 字段与属性映射 -->
</resultMap>