MyBatis 是一个流行的Java持久层框架,它简化了数据库操作,使得开发者可以更加专注于业务逻辑的开发。在这个教程中,我们将从零开始,详细介绍如何配置和使用 MyBatis。
环境搭建
1. 系统要求
- 操作系统:Windows、Linux 或 macOS
- Java 版本:Java 8 或更高版本
- 数据库:MySQL 或其他兼容的数据库
2. 安装和配置数据库
以 MySQL 为例,以下是基本安装步骤:
- 下载 MySQL 安装包。
- 安装 MySQL,并设置 root 密码。
- 创建数据库和用户,并授予相应的权限。
3. 创建 Java 项目
使用你喜欢的 IDE(如 IntelliJ IDEA、Eclipse 等)创建一个 Java 项目。
MyBatis 依赖
在你的项目中添加以下依赖:
<dependencies>
<!-- MyBatis 依赖 -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.6</version>
</dependency>
<!-- MySQL 驱动依赖 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.22</version>
</dependency>
<!-- 单元测试依赖 -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.13.2</version>
<scope>test</scope>
</dependency>
</dependencies>
MyBatis 配置
1. 创建配置文件
在你的项目目录下创建一个名为 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/mydb?useSSL=false"/>
<property name="username" value="root"/>
<property name="password" value="your_password"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/StudentMapper.xml"/>
</mappers>
</configuration>
2. 配置数据源
在上面的配置文件中,我们设置了数据库连接信息,包括驱动、URL、用户名和密码。请确保替换 your_password 为你的 MySQL 密码。
编写 Mapper 文件
在你的项目目录下创建一个名为 com/example/mapper/StudentMapper.xml 的文件,并添加以下内容:
<?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.StudentMapper">
<select id="selectStudentById" resultType="com.example.entity.Student">
SELECT * FROM student WHERE id = #{id}
</select>
</mapper>
在上面的 Mapper 文件中,我们定义了一个查询学生信息的 SQL 语句,并将结果映射到 com.example.entity.Student 实体类。
使用 MyBatis
在你的 Java 代码中,可以使用以下方式使用 MyBatis:
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) {
try {
// 创建 SqlSessionFactory
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(
Resources.getResourceAsStream("mybatis-config.xml")
);
// 获取 SqlSession
SqlSession sqlSession = sqlSessionFactory.openSession();
// 获取 Mapper 接口
StudentMapper studentMapper = sqlSession.getMapper(StudentMapper.class);
// 执行查询
Student student = studentMapper.selectStudentById(1);
// 输出结果
System.out.println("Student Name: " + student.getName());
// 关闭 SqlSession
sqlSession.close();
} catch (Exception e) {
e.printStackTrace();
}
}
}
在上面的代码中,我们首先创建了一个 SqlSessionFactory,然后获取了一个 SqlSession。通过 SqlSession,我们可以获取到 Mapper 接口,并执行相应的操作。
总结
通过以上教程,你应该已经了解了如何配置和使用 MyBatis。MyBatis 可以大大简化数据库操作,使你的 Java 应用程序更加高效。希望这个教程对你有所帮助!
