MyBatis 新手入门教程：基础操作篇

---

MyBatis 新手入门教程：基础操作篇

适合人群：无 MyBatis 使用经验者

---

（完整版3.3准时发，此篇为新手入门的基础操作）

一、MyBatis 是什么？

1. 简单理解：
   MyBatis 是一个帮你操作数据库的工具，能让你用 Java 代码更方便地执行 SQL 语句，把数据库数据自动转换成 Java 对象。

2. 核心特点：

   • 不用写 JDBC 繁琐代码（如手动关闭连接）
   • SQL 写在 XML 文件里，和 Java 代码分开
   • 自动映射结果：数据库表字段 → Java 对象属性

---

二、快速搭建环境（IDEA 版）

步骤 1：创建 Maven 项目

1. 打开 IDEA → File → New → Project
2. 选择 Maven → 设置项目名（如 MyBatisDemo）→ 完成

步骤 2：添加依赖（pom.xml）

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

步骤 3：准备数据库（Navicat 操作）

-- 创建数据库
CREATE DATABASE mybatis_demo;

-- 创建用户表
CREATE TABLE user (
    id INT PRIMARY KEY AUTO_INCREMENT,
    name VARCHAR(50),
    age INT
);

步骤 4：配置文件（mybatis-config.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/mybatis_demo"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
</configuration>

---

三、第一个增删改查程序

1. 创建实体类（User.java）

public class User {
    private Integer id;
    private String name;
    private Integer age;
    
    // 生成 Getter 和 Setter（IDEA快捷键 Alt+Insert）
}

2. 编写 Mapper 接口（UserMapper.java）

public interface UserMapper {
    // 插入用户
    int insert(User user);
    
    // 根据ID查询用户
    User selectById(int id);
}

3. 编写 XML 映射（UserMapper.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.dao.UserMapper">
    
    <!-- 插入用户 -->
    <insert id="insert" parameterType="User" useGeneratedKeys="true" keyProperty="id">
        INSERT INTO user(name, age) VALUES(#{name}, #{age})
    </insert>
    
    <!-- 根据ID查询 -->
    <select id="selectById" resultType="User">
        SELECT * FROM user WHERE id = #{id}
    </select>
</mapper>

4. 工具类（MyBatisUtils.java）

public class MyBatisUtils {
    private static SqlSessionFactory sqlSessionFactory;
    
    static {
        try {
            String resource = "mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            throw new RuntimeException(e);
        }
    }
    
    public static SqlSession getSqlSession() {
        return sqlSessionFactory.openSession();
    }
}

5. 测试代码

public class TestDemo {
    public static void main(String[] args) {
        try (SqlSession session = MyBatisUtils.getSqlSession()) {
            UserMapper mapper = session.getMapper(UserMapper.class);
            
            // 插入测试
            User user = new User();
            user.setName("小明");
            user.setAge(20);
            mapper.insert(user);
            System.out.println("插入成功，ID：" + user.getId());
            
            // 查询测试
            User dbUser = mapper.selectById(user.getId());
            System.out.println("查询结果：" + dbUser.getName());
            
            session.commit(); // 提交事务
        }
    }
}

---

四、新手常见问题

问题 1：XML 文件找不到

解决：在 pom.xml 中添加资源过滤：

<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <includes>
                <include>**/*.xml</include>
            </includes>
        </resource>
    </resources>
</build>

问题 2：中文乱码

解决：在数据库连接 URL 后添加参数：

jdbc:mysql://localhost:3306/mybatis_demo?useUnicode=true&characterEncoding=utf8

问题 3：字段名和属性名不一致

解决：在 SQL 中使用别名：

<select id="selectById" resultType="User">
    SELECT id, name, age AS userAge FROM user WHERE id = #{id}
</select>

---

五、下一步学习建议

1. 掌握动态 SQL：学习 <if>、<foreach> 标签
2. 理解结果映射：学习 <resultMap> 处理复杂对象
3. 尝试 Spring 整合：学习 MyBatis-Spring 简化配置
4. 实战练习：用 MyBatis 实现一个简单的学生管理系统

---

通过这个基础教程，你已经能够用 MyBatis 完成简单的数据库操作！接下来通过实际项目练习巩固知识，逐步探索更多高级功能吧！