MyBatis---（第一部分）

MyBatis 知识点整理

一、MyBatis 介绍

1. 为什么使用 MyBatis？（JDBC 的缺点）

• 结果集遍历繁琐​ → MyBatis 通过反射自动映射结果集

• 手动创建和关闭连接​ → MyBatis 通过连接池管理数据库连接

• SQL 硬编码在 Java 代码中​ → MyBatis 将 SQL 分离到 XML 文件中配置

2. 什么是 MyBatis？

• 前身是 Apache 的 iBatis

• 封装了 JDBC 的持久层框架

• 开发者只需关注 SQL 语句编写，无需处理底层 JDBC 操作

二、MyBatis 入门案例

1. 项目依赖（pom.xml）

<dependencies>
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.9</version>
    </dependency>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.33</version>
    </dependency>
    <dependency>
        <groupId>log4j</groupId>
        <artifactId>log4j</artifactId>
        <version>1.2.17</version>
    </dependency>
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.13.2</version>
    </dependency>
</dependencies>

2. 日志配置（log4j.properties）

• 参考 Log4j 官方配置文档

3. POJO 实体类

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

4. Mapper 接口

public interface UserMapper {
    List<User> findAll();
}

5. Mapper 映射文件（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.hg.mapper.UserMapper">
    <!--
        id：必须和 mapper 接口方法名保持一致
        resultType：返回值的全类名
    -->
    <select id="findAll" resultType="com.hg.pojo.User">
        SELECT * FROM user
    </select>
</mapper>

6. MyBatis 核心配置文件（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/test"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/hg/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

7. 单元测试

public class UserMapperTest {
    @Test
    public void testFindAll() throws IOException {
        // 1. 加载配置文件
        InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
        // 2. 创建 SqlSessionFactory
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        // 3. 创建 SqlSession
        SqlSession sqlSession = sqlSessionFactory.openSession();
        // 4. 获取 Mapper 代理对象
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        // 5. 执行查询
        List<User> users = userMapper.findAll();
        // 6. 关闭资源
        sqlSession.close();
    }
}

三、MyBatis 运行原理【重点】

mybatis-config.xml
    |
    v
mapper.xml    mapper.xml    mapper.xml...
    |
    v
Resource → InputStream
    |
    v
SqlSessionFactoryBuilder → Map<namespace+id, MappedStatement(sql,resultType)>
    |
    v
SqlSessionFactory
    |
    v
SqlSession.getMapper(Mapper.class)
    |
    v
MapperProxy → MappedStatement
    |
    v
Executor
    |      |
    v      v
输入映射    输出映射

• 输入映射：通过反射调用 get 方法获取参数

• 输出映射：通过反射调用 set 方法设置结果

四、MyBatis 主键回填

方式一：使用 <selectKey>标签

<insert id="insertUser" parameterType="com.hg.pojo.User">
    <selectKey keyProperty="id" order="AFTER" resultType="java.lang.Integer">
        SELECT LAST_INSERT_ID()
    </selectKey>
    INSERT INTO user(username, password) VALUES(#{username}, #{password})
</insert>

• keyProperty="id"：回填到 User 的 id 属性上

• order="AFTER"：插入之后再主键回填

• resultType="java.lang.Integer"：返回值的全类名

方式二：使用 useGeneratedKeys 属性

<insert id="insertUser" parameterType="com.hg.pojo.User"
        useGeneratedKeys="true" keyProperty="id">
    INSERT INTO user(username, password) VALUES(#{username}, #{password})
</insert>

• useGeneratedKeys="true"：使用数据库自增主键

• keyProperty="id"：回填到 user 的 id 属性上

五、MyBatis 参数传递【重点】

1. 传递单个参数

User findUserById(Integer id);

<select id="findUserById" parameterType="java.lang.Integer" resultType="com.hg.pojo.User">
    SELECT * FROM user WHERE id = #{id}
</select>

• #{}是占位符，用于替换实际参数，等价于 JDBC 的 ?

2. 序号传参

User findUser(Integer id, String username);

<!-- 使用 param1, param2... -->
<select id="findUser" resultType="com.hg.pojo.User">
    SELECT * FROM user WHERE id = #{param1} AND username = #{param2}
</select>

<!-- 或使用 arg0, arg1... -->
<select id="findUser" resultType="com.hg.pojo.User">
    SELECT * FROM user WHERE id = #{arg0} AND username = #{arg1}
</select>

3. 注解传参

User findUser2(@Param("id") Integer id, @Param("sb") String username);

<select id="findUser2" resultType="com.hg.pojo.User">
    SELECT * FROM user WHERE id = #{id} AND username = #{sb}
</select>

• #{注解的属性值}

4. Map 传参

User findUser3(Map<String, Object> map);

<select id="findUser3" parameterType="java.util.Map" resultType="com.hg.pojo.User">
    SELECT * FROM user WHERE id = #{id} AND username = #{sb}
</select>

• #{map 的 key}

5. 对象传参

User findUser4(User userParam);

<select id="findUser4" parameterType="com.hg.pojo.User" resultType="com.hg.pojo.User">
    SELECT * FROM user WHERE id = #{id} AND username = #{username}
</select>

• #{对象的属性名}

---

总结：本文介绍了 MyBatis 的核心概念、使用方法和常见技巧，包括 MyBatis 的配置、映射文件编写、参数传递方式以及运行原理。通过合理使用 MyBatis 可以提高数据库操作的效率和可维护性。