MyBatis 环境搭建：从零开始，一行代码注释全覆盖

本教程将详细讲解 MyBatis 环境搭建步骤，从 Maven 项目创建到数据库操作，每行代码都附有注释，帮助你快速入门 MyBatis。

1. 创建 Maven 项目

使用 IDE（如 IntelliJ IDEA、Eclipse 等）创建一个新的 Maven 项目。

2. 在 pom.xml 中添加 MyBatis 依赖

打开 pom.xml 文件，并添加 MyBatis 的依赖配置。示例如下：

<dependencies>
    <!-- MyBatis 核心依赖 -->
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.7</version>
    </dependency>
    <!-- MyBatis 与数据库连接池整合 -->
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis-spring</artifactId>
        <version>2.0.7</version>
    </dependency>
    <!-- 数据库驱动依赖 -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.26</version>
    </dependency>
    <!-- 其他依赖... -->
</dependencies>

3. 创建 MyBatis 配置文件

在 src/main/resources 目录下创建一个名为 mybatis-config.xml 的文件，用于配置 MyBatis。
在 mybatis-config.xml 中可以进行数据库连接配置、映射器配置等。可以参考 MyBatis 官方文档进行配置。

<!DOCTYPE configuration>
<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/dbname'/>
                <property name='username' value='username'/>
                <property name='password' value='password'/>
            </dataSource>
        </environment>
    </environments>

    <!-- 映射器配置 -->
    <mappers>
        <mapper resource='mapper/UserMapper.xml'/>
    </mappers>
</configuration>

4. 创建映射器接口和映射器配置文件

在 src/main/java 目录下创建一个包，用于存放映射器接口和映射器配置文件。
在包中创建一个映射器接口，用于定义数据库操作的方法。例如，UserMapper.java。

package com.example.mapper;

import com.example.entity.User;
import java.util.List;

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

在包中创建一个与映射器接口同名的映射器配置文件，用于编写 SQL 语句和映射规则。例如，UserMapper.xml。

<!DOCTYPE mapper>
<mapper namespace='com.example.mapper.UserMapper'>

    <!-- 查询所有用户 -->
    <select id='findAll' resultType='com.example.entity.User'>
        SELECT * FROM user
    </select>

    <!-- 根据 ID 查询用户 -->
    <select id='findById' resultType='com.example.entity.User' parameterType='int'>
        SELECT * FROM user WHERE id = #{id}
    </select>

    <!-- 添加用户 -->
    <insert id='addUser' parameterType='com.example.entity.User'>
        INSERT INTO user (username, password, age) VALUES (#{username}, #{password}, #{age})
    </insert>

    <!-- 更新用户 -->
    <update id='updateUser' parameterType='com.example.entity.User'>
        UPDATE user SET username = #{username}, password = #{password}, age = #{age} WHERE id = #{id}
    </update>

    <!-- 删除用户 -->
    <delete id='deleteUser' parameterType='int'>
        DELETE FROM user WHERE id = #{id}
    </delete>
</mapper>

5. 使用 MyBatis 进行数据库操作

在代码中创建 SqlSessionFactory 对象，并使用 mybatis-config.xml 配置文件构建 SqlSessionFactory。

import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

import java.io.InputStream;

public class MyBatisExample {
    public static void main(String[] args) {
        // 加载 MyBatis 配置文件
        InputStream configStream = MyBatisExample.class.getResourceAsStream('/mybatis-config.xml');
        SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(configStream);

        // 创建 SqlSession
        try (SqlSession session = sessionFactory.openSession()) {
            // 获取映射器接口的实例
            UserMapper mapper = session.getMapper(UserMapper.class);

            // 调用映射器接口的方法，完成数据库操作
            // 示例代码省略...
        }
    }
}

这些步骤是搭建 MyBatis 环境的基本流程，根据实际需求可能会有一些额外的配置和操作。根据实际需求进行适当修改和扩展。