1. 准备环境
为了新建一个 MyBatis 项目，首先需要准备好开发环境。确保你的计算机上已经安装了 Java 开发工具包（JDK），推荐使用 JDK 1.8 或更高版本。由于 MyBatis 是一个 Java ORM 框架，因此 Java 环境是必不可少的。
接下来，需要安装一个合适的 IDE（集成开发环境）。常用的 IDE 包括 IntelliJ IDEA 和 Eclipse。IntelliJ IDEA 在 MyBatis 开发方面的支持较好，因此推荐使用该工具。安装完成后，确保可以正常创建 Java 项目。
2. 创建项目
在 IDE 中创建一个新的 Maven 项目。选择 Maven 作为项目构建工具，使用默认的项目结构。这里将使用 IntelliJ IDEA 作为示例：
1. 在主界面点击 “File” -> “New” -> “Project”。
2. 选择 “Maven” 选项，点击 “Next”。
3. 输入项目名称、位置，点击 “Next”。
4. 输入 Group ID 和 Artifact ID，点击 “Finish”。
完成项目创建后，会自动生成一个 Maven 项目结构，包括 pom.xml 文件，用于管理依赖。
3. 添加依赖
在 pom.xml 文件中添加 MyBatis 和数据库驱动的依赖。你需要根据使用的数据库来选择合适的数据库驱动。例如，如果使用 MySQL 数据库，依赖配置如下：
<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.7</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.26</version>
</dependency>
</dependencies>
完成依赖的添加后，右击 pom.xml 文件并选择 “Maven” -> “Reload Project”，以便更新项目中的依赖。
4. 配置 MyBatis
创建 MyBatis 的配置文件 mybatis-config.xml，并保存在 src/main/resources 目录中。以下是一个简单的配置示例：
<?xml version="1.0" encoding="UTF-8"?>
<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/db_name?useSSL=false&serverTimezone=UTC"/>
<property name="username" value="username"/>
<property name="password" value="password"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="mappers/YourMapper.xml"/>
</mappers>
</configuration>
根据实际情况替换以上配置中的数据库信息和账户密码。
5. 创建 Mapper
在 src/main/resources/mappers 目录下创建一个 Mapper 文件（例如 YourMapper.xml），用于定义 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">
<mapper namespace="com.example.YourMapper">
<select id="selectUser" resultType="com.example.User">
SELECT * FROM users WHERE id = #{id}
</select>
</mapper>
在 Mapper 接口中，需要定义与 XML 中对应的方法，例如：
package com.example;
public interface YourMapper {
User selectUser(int id);
}
确保以上接口和 XML 中的 namespace 一致，避免出错。
6. 创建实体类
根据数据库表结构创建对应的实体类，例如 User 类如下：
package com.example;
public class User {
private int id;
private String name;
// getters and setters
}
确保实体类的属性能够与数据库中的字段对应。
7. 测试功能
在主程序中调用 MyBatis 的配置，启动一个 SqlSession 并进行数据库操作。例如：
package com.example;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
public class Main {
public static void main(String[] args) {
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder()
.build(Resources.getResourceAsStream("mybatis-config.xml"));
try (SqlSession sqlSession = sqlSessionFactory.openSession()) {
YourMapper mapper = sqlSession.getMapper(YourMapper.class);
User user = mapper.selectUser(1);
System.out.println(user.getName());
}
}
}
运行该程序，确保可以成功从数据库中读取用户信息，验证 MyBatis 是否配置成功。
问答环节
如何在 MyBatis 项目中配置数据库连接？
在 mybatis-config.xml 文件中设置 database 的 URL、用户名和密码等信息，具体可参考之前的配置示例。在 environments 标签下定义 environment，并用 dataSource 标签来配置数据源。
如何使用 MyBatis 进行数据库操作？
首先，需要创建一个 Mapper 接口，并在 XML 文件中编写对应的 SQL 语句。接着，通过 SqlSessionFactory 创建 SqlSession，利用 mapper 接口调用 SQL 方法即可。
如何调试 MyBatis 项目？
可以在 IDE 中设置断点，运行程序时观察 SqlSession 中执行的 SQL 语句。同时，可以通过在 XML 中配置日志插件来打印 SQL 日志，便于调试。
