<!-- selectUserById: 查询用户 by ID -->
<!-- id: 必须与 Mapper 接口中的方法名一致 -->
<!-- parameterType: 方法参数类型 -->
<!-- resultType: 返回结果类型 (如果返回单个对象) -->
<select id="selectUserById" parameterType="java.lang.Integer" resultType="com.example.model.User">
    SELECT id, name, age
    FROM user
    WHERE id = #{id}
</select>

<!-- selectAllUsers: 查询所有用户 -->
<!-- resultType: 返回结果类型 (如果返回多个对象，则指定列表中元素的类型) -->
<select id="selectAllUsers" resultType="com.example.model.User">
    SELECT id, name, age
    FROM user
</select>

<!-- insertUser: 插入用户 -->
<!-- parameterType: 方法参数类型 -->
<!-- useGeneratedKeys="true" keyProperty="id": 获取数据库自动生成的主键并设置到 user 对象的 id 属性 -->
<insert id="insertUser" parameterType="com.example.model.User" useGeneratedKeys="true" keyProperty="id">
    INSERT INTO user (name, age)
    VALUES (#{name}, #{age})
</insert>

<!-- updateUser: 更新用户 -->
<update id="updateUser" parameterType="com.example.model.User">
    UPDATE user
    SET name = #{name}, age = #{age}
    WHERE id = #{id}
</update>

<!-- deleteUser: 删除用户 -->
<delete id="deleteUser" parameterType="java.lang.Integer">
    DELETE FROM user
    WHERE id = #{id}
</delete>

``
**注意：** 在mybatis-config.xml中的部分，如果你使用了的方式注册 Mapper，那么UserMapper.xml文件必须与UserMapper.java在同一个包下，并且文件名需要一致。如果你使用的方式，则只需要 resource 路径正确即可。推荐使用package方式，更简洁。请确保在mybatis-config.xml` 中配置了正确的 Mapper 注册方式。

3.8 添加日志配置 (logback.xml)

在 src/main/resources 目录下创建 logback.xml 文件，以便查看 MyBatis 执行的 SQL 语句。

“`xml

%d{HH:mm:ss.SSS} [%thread] %-5level %logger{50} – %msg%n

<!-- MyBatis logger -->
<!-- 设置 MyBatis 的日志级别为 DEBUG，可以打印出执行的SQL -->
<logger name="com.example.mapper" level="DEBUG"/>
<logger name="org.apache.ibatis" level="DEBUG"/>

<!-- Root Logger -->
<root level="INFO">
    <appender-ref ref="STDOUT"/>
</root>

``
这里配置了将日志输出到控制台，并将com.example.mapper包下的日志以及org.apache.ibatis` 包下的日志级别设置为 DEBUG，这样就能看到 MyBatis 打印出的 SQL 语句和参数。

第四部分：MyBatis 基本 CRUD 操作详解

有了上述环境，我们就可以编写代码来执行数据库操作了。

4.1 获取 SqlSessionFactory

加载配置文件并构建 SqlSessionFactory。由于 SqlSessionFactory 是重量级且线程安全的，通常只需要构建一次。

“`java
package com.example;

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

import java.io.IOException;
import java.io.InputStream;

public class MyBatisUtil {
private static SqlSessionFactory sqlSessionFactory;

static {
    try {
        // 指定核心配置文件的路径
        String resource = "mybatis-config.xml";
        // 读取配置文件
        InputStream inputStream = Resources.getResourceAsStream(resource);
        // 构建 SqlSessionFactory
        sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        System.out.println("SqlSessionFactory initialized successfully.");
    } catch (IOException e) {
        e.printStackTrace();
        throw new RuntimeException("Error initializing SqlSessionFactory.", e);
    }
}

// 提供获取 SqlSessionFactory 的静态方法
public static SqlSessionFactory getSqlSessionFactory() {
    return sqlSessionFactory;
}

}
``
将这段代码放在一个工具类中，方便在任何地方获取SqlSessionFactory`。

4.2 执行 Select 操作 (通过 Mapper 接口)

获取 SqlSession，然后获取 Mapper 实例，调用方法执行查询。

“`java
package com.example.test;

import com.example.MyBatisUtil;
import com.example.mapper.UserMapper;
import com.example.model.User;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;

import java.util.List;

public class UserMapperTest {

@Test
public void testSelectUserById() {
    // 获取 SqlSession
    SqlSession session = MyBatisUtil.getSqlSessionFactory().openSession();
    try {
        // 获取 Mapper 接口的代理实现类
        UserMapper userMapper = session.getMapper(UserMapper.class);

        // 调用 Mapper 方法执行查询
        Integer userId = 1;
        User user = userMapper.selectUserById(userId);

        // 打印结果
        System.out.println("查询结果: " + user);

        // 可以在 log 中看到执行的 SQL 语句

    } finally {
        // 务必关闭 SqlSession
        session.close();
    }
}

@Test
public void testSelectAllUsers() {
    SqlSession session = MyBatisUtil.getSqlSessionFactory().openSession();
    try {
        UserMapper userMapper = session.getMapper(UserMapper.class);

        List<User> userList = userMapper.selectAllUsers();

        System.out.println("所有用户:");
        for (User user : userList) {
            System.out.println(user);
        }

    } finally {
        session.close();
    }
}

}
“`
运行这两个 JUnit 测试方法，你应该能看到查询结果和 MyBatis 打印出的 SQL 语句。

4.3 执行 Insert 操作

插入新的用户记录。

“`java
@Test
public void testInsertUser() {
SqlSession session = MyBatisUtil.getSqlSessionFactory().openSession(); // 默认不自动提交事务
try {
UserMapper userMapper = session.getMapper(UserMapper.class);

    User newUser = new User("Charlie", 28);
    userMapper.insertUser(newUser);

    // 默认情况下，MyBatis 不会自动提交事务，需要手动提交
    session.commit();

    System.out.println("插入成功，新用户ID: " + newUser.getId()); // newUser.getId() 会包含自动生成的主键

} catch (Exception e) {
    session.rollback(); // 发生异常时回滚事务
    e.printStackTrace();
} finally {
    session.close();
}

}
``
**注意：** 对于 INSERT, UPDATE, DELETE 操作，MyBatis 默认情况下不会自动提交事务。你需要手动调用session.commit()方法来提交事务，或者在获取SqlSession时使用openSession(true)开启自动提交。在实际应用中，通常由服务层或框架（如 Spring）来管理事务。同时，要记得在发生异常时调用session.rollback()。useGeneratedKeys和keyProperty的作用是在插入成功后，将数据库自动生成的主键值设置回传入的user对象的id` 属性中。

4.4 执行 Update 操作

更新现有用户记录。

“`java
@Test
public void testUpdateUser() {
SqlSession session = MyBatisUtil.getSqlSessionFactory().openSession();
try {
UserMapper userMapper = session.getMapper(UserMapper.class);

    // 先查询出要更新的用户 (或者直接构建一个User对象，只要id有值)
    User userToUpdate = userMapper.selectUserById(1);
    if (userToUpdate != null) {
        userToUpdate.setName("Alice Updated");
        userToUpdate.setAge(26);

        userMapper.updateUser(userToUpdate);
        session.commit();
        System.out.println("更新成功!");
    } else {
        System.out.println("未找到要更新的用户");
    }

} catch (Exception e) {
    session.rollback();
    e.printStackTrace();
} finally {
    session.close();
}

}
“`

4.5 执行 Delete 操作

删除用户记录。

“`java
@Test
public void testDeleteUser() {
SqlSession session = MyBatisUtil.getSqlSessionFactory().openSession();
try {
UserMapper userMapper = session.getMapper(UserMapper.class);

    Integer userIdToDelete = 2;
    userMapper.deleteUser(userIdToDelete);
    session.commit();
    System.out.println("删除成功!");

} catch (Exception e) {
    session.rollback();
    e.printStackTrace();
} finally {
    session.close();
}

}
“`

4.6 SqlSession 的生命周期和资源管理

SqlSession 是一个重要的资源，它的生命周期应该尽可能短，通常与一次请求或一个业务操作对应。并且，使用完毕后必须关闭。使用 try-finally 或者 Java 7+ 的 try-with-resources 语句是确保 SqlSession 被关闭的推荐方式。

java
// 使用 try-with-resources 自动关闭 SqlSession (推荐)
@Test
public void testSelectUserByIdWithTryResources() {
// getSqlSessionFactory().openSession() 返回一个实现了 AutoCloseable 的 SqlSession
try (SqlSession session = MyBatisUtil.getSqlSessionFactory().openSession()) {
UserMapper userMapper = session.getMapper(UserMapper.class);
Integer userId = 1;
User user = userMapper.selectUserById(userId);
System.out.println("查询结果 (try-with-resources): " + user);
// 在 try-with-resources 块结束时，session 会自动关闭
// 如果是写操作，需要在 try 块内手动 session.commit() 或 session.rollback()
} catch (Exception e) {
e.printStackTrace();
// 这里无需 session.rollback() 因为 session 会在 finally 块或 try-with-resources 结束时处理
// 但如果是更复杂的事务管理，你可能需要在业务层处理异常并决定回滚
}
}
try-with-resources 语法简洁且安全，可以避免忘记关闭资源的问题。

第五部分：参数处理 #{} vs ${}

在 MyBatis 的 SQL 映射文件中，有两种常用的方式来处理动态参数：#{} 和 ${}。理解它们的区别至关重要，尤其涉及到安全性问题。

5.1 #{} 占位符

• 作用： #{} 是一个参数占位符，它会将对应的参数值作为 PreparedStatement 的参数设置进去。
• 原理： MyBatis 会将 #{} 替换成问号 (?)，然后在预编译语句中设置参数值。例如 SELECT * FROM user WHERE id = #{id} 会被转换为 SELECT * FROM user WHERE id = ?，然后 MyBatis 将 id 的值设置给这个问号。
• 优点：
  • 安全性： 能够有效地防止 SQL 注入攻击，因为参数值是独立于 SQL 语句传递的。
  • 类型转换： MyBatis 会根据参数类型进行自动转换。
  • 更强的缓存能力： 由于 SQL 语句模板是固定的（只有占位符），数据库可以更好地缓存执行计划。
• 使用场景： 绝大多数情况下都应该使用 #{} 来传递参数值。

5.2 ${} 字符串替换

• 作用： ${} 是一个简单的字符串替换，它会将对应的参数值直接拼接到 SQL 语句中。
• 原理： MyBatis 会将 ${} 直接替换成参数值的字符串形式。例如 SELECT * FROM user WHERE name = '${name}' (注意这里的引号，字符串参数需要手动加引号) 会被替换成 SELECT * FROM user WHERE name = 'Alice'。
• 缺点：
  • 安全性问题： 存在 SQL 注入风险。如果参数值来自用户输入且未经严格校验，恶意用户可以构造特定的字符串来改变 SQL 的执行逻辑。例如，如果用户输入 ' OR '1'='1，则 SQL 可能变成 SELECT * FROM user WHERE name = '' OR '1'='1'，导致查询出所有用户。
  • 性能问题： 每次参数不同，SQL 语句模板就会不同，数据库难以缓存执行计划。
  • 手动处理引号： 对于字符串类型的参数，需要手动在 SQL 中添加引号。
• 使用场景：
  • 用于动态地指定 SQL 关键字、表名、列名或排序规则等不应作为参数值的部分。例如：
    • 动态排序：ORDER BY ${columnName} ${sortOrder} (这里的 columnName 和 sortOrder 不应该来自用户输入，或者需要经过非常严格的白名单校验)。
    • 动态表名：SELECT * FROM ${tableName} (同样需要非常小心)。
    • 动态 SQL 片段：在某些高级动态 SQL 场景中可能会用到。

总结： 永远优先使用 #{}。只有当确实需要将参数值直接作为 SQL 的一部分（而不是参数值）时，才考虑使用 ${}，并且务必确保这些值是安全的，例如来自代码常量、配置或者经过严格的白名单过滤。切勿将用户直接输入的、未经校验的数据使用 ${} 拼接进 SQL。

第六部分：结果集映射 <resultMap>

当数据库表的列名与实体类的属性名不完全一致，或者需要映射复杂的对象关系（一对一、一对多）时，仅靠 resultType 就不够了。这时就需要使用 <resultMap> 进行更灵活的结果集映射。

6.1 resultType 的局限性

resultType 只能将结果集的列值直接映射到指定类型的对象属性上，要求：
* 列名与属性名一致（忽略大小写）。
* 如果是复合类型（如 POJO），其属性必须是基本类型或可以自动转换的类型。
* 不支持复杂的嵌套对象或关联关系映射。

6.2 <resultMap> 的作用

<resultMap> 允许你定义一个详细的映射规则，将数据库结果集的列映射到 Java 对象的属性上，解决 resultType 的局限性。

6.3 <resultMap> 基本结构

<resultMap> 定义在 Mapper XML 文件中，<mapper> 标签内。

“`xml

<!-- 复杂关联关系的映射，将在高级部分讲解 -->
<!-- <association property="..." column="..." javaType="..." select="..."/> -->
<!-- <collection property="..." column="..." ofType="..." select="..."/> -->

“`

6.4 在 <select> 中使用 <resultMap>

在 <select> 标签中，将 resultType 属性替换为 resultMap 属性，并引用之前定义的 <resultMap> 的 id。

“`xml

SELECT id, user_name, age
FROM user
WHERE id = #{id}

SELECT id, user_name, age
FROM user

“`
在 Mapper 接口中添加对应的方法：

java
public interface UserMapper {
// ... 其他方法 ...
User selectUserByIdWithMap(Integer id);
List<User> selectAllUsersWithMap();
}

通过使用 <resultMap>，即使数据库列名与实体属性名不一致（如 user_name vs name），MyBatis 也能正确地将结果映射到 User 对象。<resultMap> 是 MyBatis 进行复杂结果集映射的基础。

第七部分：MyBatis 基础设置与日志

7.1 mybatis-config.xml 中的 <settings>

<settings> 标签提供了许多全局配置选项，可以调整 MyBatis 的行为。一些常用的设置包括：

• cacheEnabled: 全局启用或禁用二级缓存 (boolean)。
• lazyLoadingEnabled: 全局启用或禁用延迟加载 (boolean)。
• aggressiveLazyLoading: 当启用延迟加载时，是否加载对象的所有属性 (boolean)。
• logImpl: 指定 MyBatis 使用的日志实现。常用的有 SLF4J (org.apache.ibatis.logging.slf4j.Slf4jImpl)、LOG4J2 (org.apache.ibatis.logging.log4j2.Log4j2Impl)、LOG4J (org.apache.ibatis.logging.log4j.Log4jImpl) 等。
• mapUnderscoreToCamelCase: 开启驼峰命名自动映射，即数据库列名 user_name 自动映射到 Java 属性 userName (boolean)。如果开启了这个设置，并且列名与属性名符合驼峰/下划线转换规则，就可以省略简单的 <result> 映射，但 <id> 仍建议明确映射。
• useGeneratedKeys: 全局设置是否允许JDBC支持获取由数据库生成的主键 (boolean)。
• defaultStatementTimeout: 设置 JDBC statement 超时时间 (秒)。
• defaultFetchSize: 设置 JDBC 的 fetch size。

例如，在 mybatis-config.xml 中开启驼峰命名自动映射：

xml
<settings>
<setting name="logImpl" value="org.apache.ibatis.logging.slf4j.Slf4jImpl"/>
<setting name="mapUnderscoreToCamelCase" value="true"/> <!-- 开启驼峰命名映射 -->
</settings>

7.2 配置日志输出 SQL

查看 MyBatis 执行的 SQL 是调试过程中非常重要的一步。如前文所述，通过在 mybatis-config.xml 的 <settings> 中配置 logImpl，并配合日志框架（如 Logback），可以将 MyBatis 执行的 SQL 打印到控制台或其他地方。

当 logImpl 配置为 Slf4jImpl 并且日志框架配置正确时，MyBatis 会将执行的 SQL 语句、参数以及结果集信息打印到日志中，级别通常为 DEBUG。

例如，在使用 Logback 时，确保 logback.xml 中有如下配置：

xml
<logger name="com.example.mapper" level="DEBUG"/> <!-- 针对特定 Mapper 包 -->
<logger name="org.apache.ibatis" level="DEBUG"/> <!-- 针对MyBatis核心 -->
这样，每次调用 com.example.mapper 包中的 Mapper 方法时，MyBatis 就会打印出对应的 SQL。

第八部分：总结与进阶方向

本文详细介绍了 MyBatis 的基础知识，包括：
* MyBatis 的定义、定位和优势，以及与 JDBC、ORM 的比较。
* MyBatis 的核心组件和工作流程。
* 如何搭建一个基本的 MyBatis 项目环境。
* 使用 Mapper 接口和 XML 文件实现基本的 CRUD 操作。
* 深入理解 #{} 与 ${} 参数处理的区别和注意事项。
* 使用 <resultMap> 进行灵活的结果集映射。
* MyBatis 的基础配置和日志设置。

通过阅读本文并动手实践，你应该已经掌握了使用 MyBatis 进行基本数据库操作的能力。

MyBatis 还有许多更强大的功能等待你去探索，例如：

• 动态 SQL： 使用 <if>, <where>, <set>, <foreach> 等标签根据条件动态生成 SQL 语句。
• 关联关系映射： 使用 <association> (一对一) 和 <collection> (一对多) 标签映射复杂的对象关系。
• 缓存机制： MyBatis 提供一级缓存（SqlSession 级别）和二级缓存（SqlSessionFactory 级别），可以有效提升查询性能。
• 事务管理： 在 Spring 等框架中，通常由框架来管理 MyBatis 的事务。
• 类型处理器 (Type Handlers)： 自定义 Java 类型与 JDBC 类型之间的转换。
• 插件机制 (Plugins)： 在 MyBatis 核心流程中插入自定义逻辑，实现拦截、日志、分页等功能。
• 注解配置： 除了 XML 方式，MyBatis 也支持使用注解在 Mapper 接口上直接定义 SQL 和映射规则。

掌握了基础，进一步学习这些高级特性将帮助你在更复杂的场景下更有效地使用 MyBatis。希望本文能成为你 MyBatis 学习之路上的坚实起点！