MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
MyBatis 简介
MyBatis 遵循约定优于配置( Convention Over Configuration)的原则,这意味着大部分情况下,你不需要进行繁琐的配置,MyBatis 会根据约定来配置数据库连接、映射语句等。这使得 MyBatis 在易用性和性能上都非常出色。
环境搭建
1. 创建 Maven 项目
首先,你需要创建一个 Maven 项目。在 pom.xml 文件中添加以下依赖:
<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.6</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.26</version>
</dependency>
</dependencies>
2. 配置数据库连接
在 src/main/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"/>
<property name="username" value="your_username"/>
<property name="password" value="your_password"/>
</dataSource>
</environment>
</environments>
</configuration>
3. 创建实体类和 Mapper 接口
假设我们有一个名为 User 的实体类,以及一个对应的 UserMapper 接口:
public class User {
private Integer id;
private String name;
private String email;
// 省略 getter 和 setter 方法
}
public interface UserMapper {
User getUserById(Integer id);
}
编写 Mapper 映射文件
在 src/main/resources 目录下创建一个名为 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="getUserById" resultType="com.example.User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
使用 MyBatis
1. 创建 SqlSessionFactory
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
2. 获取 SqlSession
SqlSession sqlSession = sqlSessionFactory.openSession();
3. 调用 Mapper 接口方法
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
User user = mapper.getUserById(1);
System.out.println(user.getName());
4. 关闭 SqlSession
sqlSession.close();
总结
通过以上步骤,你已经成功搭建了一个基于 MyBatis 的 Java 项目,并实现了对数据库的连接和操作。MyBatis 的易用性和高性能使得它在 Java 开发中得到了广泛的应用。希望这篇指南能帮助你更好地学习和使用 MyBatis。
