MyBatis 是一款优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java 对象)映射成数据库中的记录。下面,我们就一起从零开始,手把手教你玩转 MyBatis,轻松实现数据库操作。
第一部分:MyBatis 简介
1.1 什么是 MyBatis?
MyBatis 是一个半自动化持久层框架,它将 SQL 语句和 Java 代码分离,使得开发人员只需要关注 SQL 语句的编写,而无需关心如何将 SQL 语句映射到 Java 对象上。
1.2 MyBatis 的特点
- 简单的 XML 或注解配置:通过 XML 或注解的方式配置 SQL 语句和 Java 对象的映射关系。
- 灵活的映射机制:支持复杂的 SQL 语句映射,如一对一、一对多、多对多等。
- 支持多种数据库:支持 MySQL、Oracle、SQL Server 等多种数据库。
- 易于扩展:可以通过自定义 SQL 语句、映射器等来扩展 MyBatis 的功能。
第二部分:MyBatis 环境搭建
2.1 安装 Java 开发环境
首先,确保你的计算机上已经安装了 Java 开发环境。你可以从 Oracle官网 下载并安装 Java。
2.2 安装 Maven
Maven 是一个项目管理工具,可以帮助我们管理项目依赖。你可以从 Maven 官网 下载并安装 Maven。
2.3 创建 Maven 项目
使用 Maven 创建一个新的 Java 项目,并添加以下依赖:
<dependencies>
<!-- MyBatis 核心依赖 -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.6</version>
</dependency>
<!-- 数据库驱动依赖 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.47</version>
</dependency>
<!-- JDBC 依赖 -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>4.0.1</version>
<scope>provided</scope>
</dependency>
</dependencies>
第三部分:编写 MyBatis 映射文件
3.1 创建 MyBatis 配置文件
在项目的 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.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>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
3.2 编写 Mapper 映射文件
在 src/main/resources/com/example/mapper 目录下创建一个名为 UserMapper.xml 的 Mapper 映射文件,配置 SQL 语句和 Java 对象的映射关系。
<?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.3 编写接口
在 src/main/java/com/example/mapper 目录下创建一个名为 UserMapper.java 的接口,声明 MyBatis 映射方法。
package com.example.mapper;
public interface UserMapper {
User selectById(Integer id);
}
第四部分:使用 MyBatis 操作数据库
4.1 创建实体类
在 src/main/java/com/example/entity 目录下创建一个名为 User.java 的实体类,对应数据库中的 user 表。
package com.example.entity;
public class User {
private Integer id;
private String name;
private Integer age;
// 省略 getter 和 setter 方法
}
4.2 使用 MyBatis
在 src/main/java/com/example/service 目录下创建一个名为 UserService.java 的服务类,使用 MyBatis 操作数据库。
package com.example.service;
import com.example.entity.User;
import com.example.mapper.UserMapper;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
public class UserService {
private static SqlSessionFactory sqlSessionFactory;
static {
try {
sqlSessionFactory = new SqlSessionFactoryBuilder().build(
Resources.getResourceAsStream("mybatis-config.xml"));
} catch (IOException e) {
e.printStackTrace();
}
}
public User selectById(Integer id) {
try (SqlSession session = sqlSessionFactory.openSession()) {
UserMapper mapper = session.getMapper(UserMapper.class);
return mapper.selectById(id);
}
}
}
4.3 测试
在 src/main/java/com/example/test 目录下创建一个名为 UserTest.java 的测试类,测试 MyBatis 功能。
package com.example.test;
import com.example.entity.User;
import com.example.service.UserService;
import org.junit.Test;
public class UserTest {
@Test
public void testSelectById() {
UserService userService = new UserService();
User user = userService.selectById(1);
System.out.println(user);
}
}
通过以上步骤,你已经成功地从零开始玩转了 MyBatis,并实现了数据库操作。接下来,你可以根据自己的需求,进一步学习 MyBatis 的高级特性,如动态 SQL、插件等。祝你学习愉快!
