引言
MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
在这个快速入门指南中,我们将从搭建环境开始,逐步教你如何使用 MyBatis 实现数据交互。
1. 搭建环境
1.1 系统要求
- Java Development Kit (JDK) 1.6 或更高版本
- Integrated Development Environment (IDE) 如 IntelliJ IDEA 或 Eclipse
- Maven 或 Gradle 构建工具
1.2 创建项目
- 打开你的 IDE,创建一个新的 Java 项目。
- 在项目中添加以下依赖到
pom.xml文件(如果你使用 Maven):
<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>
- 配置数据库连接信息。在
src/main/resources目录下创建一个名为application.properties的文件,并添加以下内容:
# 数据库配置
db.url=jdbc:mysql://localhost:3306/mybatis_example
db.user=root
db.password=root
db.driver=com.mysql.cj.jdbc.Driver
2. 创建实体类和映射文件
2.1 实体类
创建一个名为 User 的实体类,代表数据库中的用户表:
public class User {
private Integer id;
private String name;
private String email;
// 省略 getter 和 setter 方法
}
2.2 映射文件
在 src/main/resources 目录下创建一个名为 UserMapper.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.UserMapper">
<select id="selectById" resultType="com.example.entity.User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
3. 创建接口
创建一个名为 UserMapper 的接口,并添加以下内容:
public interface UserMapper {
User selectById(Integer id);
}
4. 使用 MyBatis
4.1 创建 SqlSessionFactory
在 src/main/java 目录下创建一个名为 MyBatisConfig.java 的文件,并添加以下内容:
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.apache.ibatis.type.JdbcType;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
@Configuration
@MapperScan("com.example.mapper")
public class MyBatisConfig {
@Bean
public SqlSessionFactory sqlSessionFactory() throws Exception {
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(
Resources.getResourceAsStream("mybatis-config.xml")
);
return sqlSessionFactory;
}
}
4.2 使用 MyBatis
在需要使用 MyBatis 的类中,注入 UserMapper:
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
@Service
public class UserService {
@Autowired
private UserMapper userMapper;
public User getUserById(Integer id) {
return userMapper.selectById(id);
}
}
5. 总结
通过以上步骤,你已经成功搭建了 MyBatis 开发环境,并实现了数据交互。MyBatis 是一个功能强大的持久层框架,可以帮助你简化数据库操作,提高开发效率。希望这个快速入门指南对你有所帮助!
