1. 添加依赖(Maven项目)
在 pom.xml
中添加 MyBatis 和数据库驱动的依赖(以 MySQL 为例):
<dependencies><!-- MyBatis 核心库 --><dependency><groupId>org.mybatis</groupId><artifactId>mybatis</artifactId><version>3.5.13</version> <!-- 使用最新版本 --></dependency><!-- MySQL 驱动 --><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>8.0.33</version></dependency>
</dependencies>
2. 配置 MyBatis 核心文件
在 resources
目录下创建 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/your_database?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>
3. 创建实体类
定义与数据库表对应的实体类,例如 User
:
public class User {private Integer id;private String name;private String email;// 省略构造方法、getter/setter 和 toString()
}
4. 创建 Mapper 接口
public interface UserMapper {User selectUserById(int id);
}
5. 编写 Mapper XML 映射文件
在 resources/mapper
目录下创建 UserMapper.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.mapper.UserMapper"><select id="selectUserById" resultType="com.example.entity.User">SELECT * FROM user WHERE id = #{id}</select>
</mapper>
6. 使用 MyBatis 执行操作
通过 SqlSessionFactory
获取 SqlSession
并操作数据库:
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;public class MyBatisDemo {public static void main(String[] args) {try {// 加载 MyBatis 配置文件String resource = "mybatis-config.xml";InputStream inputStream = Resources.getResourceAsStream(resource);// 创建 SqlSessionFactorySqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);// 获取 SqlSessiontry (SqlSession sqlSession = sqlSessionFactory.openSession()) {// 获取 Mapper 接口实例UserMapper userMapper = sqlSession.getMapper(UserMapper.class);// 执行查询User user = userMapper.selectUserById(1);System.out.println(user);}} catch (Exception e) {e.printStackTrace();}}
}
关键注意事项
1.驱动和 URL 格式:
-
MySQL 8+ 驱动类名为
com.mysql.cj.jdbc.Driver
,URL 需指定时区(如serverTimezone=UTC.
2. XML 文件位置:
3.事务管理:
-
默认使用
JDBC
事务管理器,执行写操作后需调用sqlSession.commit()
提交事务。
4.日志配置:
-
如需查看 SQL 日志,可在
mybatis-config.xml
中添加日志实现(如 SLF4J)。
常见问题排查
-
配置文件未找到:检查文件是否在
resources
目录下,且路径正确。 -
驱动类异常:确认驱动依赖已正确添加,版本兼容。
-
Mapper 未绑定:检查
mybatis-config.xml
中<mappers>
的配置是否指向正确的 XML 文件 -
通过以上步骤,即可完成 MyBatis 与数据库的基本连接和操作。