当前位置：首页 > news >正文

MyBatis 环境配置完整教程（从 0 到 1）

news 2026/5/12 3:16:30

一、什么是 MyBatis？

MyBatis是一个优秀的持久层（ORM）框架，它将 Java 对象与数据库表进行映射，通过XML 或注解的方式编写 SQL。

MyBatis 的特点

半自动 ORM（SQL 由程序员自己写）
支持动态 SQL
避免 JDBC 硬编码、减少样板代码
易学、可控性强

如果你学过 JDBC，可以把 MyBatis 理解为：
JDBC + 连接池 + SQL 映射 + 配置解耦

二、准备环境

1. 开发工具

JDK 8+
IntelliJ IDEA
Maven 3.6+
MySQL 5.7 / 8.0

三、创建 Maven 项目

1. 新建 Maven 工程

mybatis-demo

2.`pom.xml`引入依赖

<dependencies> <!-- MyBatis 核心 --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.5.16</version> </dependency> <!-- MySQL 驱动 --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-j</artifactId> <version>8.0.33</version> </dependency> <!-- 日志 --> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-simple</artifactId> <version>2.0.12</version> </dependency> </dependencies>

四、创建数据库与表

CREATE DATABASE mybatis_db; USE mybatis_db; CREATE TABLE user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50), password VARCHAR(50) );

五、项目目录结构（重点）

src └─ main ├─ java │ └─ com.example.mybatis │ ├─ entity │ │ └─ User.java │ ├─ mapper │ │ └─ UserMapper.java │ └─ test │ └─ MyBatisTest.java └─ resources ├─ mapper │ └─ UserMapper.xml └─ mybatis-config.xml

六、MyBatis 核心配置文件

1.`mybatis-config.xml`

<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "https://mybatis.org/dtd/mybatis-3-config.dtd"> <configuration> <!-- 环境配置 --> <environments default="dev"> <environment id="dev"> <transactionManager type="JDBC"/> <dataSource type="POOLED"> <property name="driver" value="com.mysql.cj.jdbc.Driver"/> <property name="url" value="jdbc:mysql://localhost:3306/mybatis_db?useSSL=false&serverTimezone=UTC"/> <property name="username" value="root"/> <property name="password" value="123456"/> </dataSource> </environment> </environments> <!-- Mapper 映射 --> <mappers> <mapper resource="mapper/UserMapper.xml"/> </mappers> </configuration>

说明

POOLED：MyBatis 内置连接池
transactionManager：使用 JDBC 事务
mappers：注册 SQL 映射文件

七、实体类（Entity）

`User.java`

package com.example.mybatis.entity; public class User { private Integer id; private String username; private String password; // getter / setter }

八、Mapper 接口

`UserMapper.java`

package com.example.mybatis.mapper; import com.example.mybatis.entity.User; public interface UserMapper { User selectById(int id); }

九、Mapper XML 映射文件

`UserMapper.xml`

<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "https://mybatis.org/dtd/mybatis-3-mapper.dtd"> <mapper namespace="com.example.mybatis.mapper.UserMapper"> <select id="selectById" parameterType="int" resultType="com.example.mybatis.entity.User"> SELECT * FROM user WHERE id = #{id} </select> </mapper>

核心规则

namespace必须是Mapper 接口全路径
id对应接口方法名
#{}是预编译参数

十、MyBatis 测试类

`MyBatisTest.java`

package com.example.mybatis.test; import com.example.mybatis.entity.User; import com.example.mybatis.mapper.UserMapper; import org.apache.ibatis.io.Resources; import org.apache.ibatis.session.*; import java.io.InputStream; public class MyBatisTest { public static void main(String[] args) throws Exception { // 1. 读取配置文件 InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml"); // 2. 构建 SqlSessionFactory SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(inputStream); // 3. 获取 SqlSession SqlSession sqlSession = factory.openSession(); // 4. 获取 Mapper UserMapper mapper = sqlSession.getMapper(UserMapper.class); // 5. 执行 SQL User user = mapper.selectById(1); System.out.println(user.getUsername()); // 6. 关闭资源 sqlSession.close(); } }