引言
MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。对于新手来说,掌握 MyBatis 可以大大提高开发效率。本文将带领你从搭建环境到实践应用,轻松掌握 MyBatis。
一、环境搭建
1.1 系统环境
- 操作系统:Windows/Linux/MacOS
- JDK:1.8 或更高版本
- 数据库:MySQL/Oracle/SQL Server 等
- IDE:IntelliJ IDEA/Eclipse 等
1.2 添加依赖
在项目的 pom.xml 文件中添加 MyBatis 的依赖:
<dependencies>
<!-- MyBatis -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.7</version>
</dependency>
<!-- MySQL 驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.26</version>
</dependency>
<!-- 其他依赖(如:日志、数据库连接池等) -->
</dependencies>
二、配置 MyBatis
2.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/test"/>
<property name="username" value="root"/>
<property name="password" value=""/>
</dataSource>
</environment>
</environments>
<!-- 映射器配置 -->
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
2.2 创建 Mapper 接口
创建 UserMapper.java 接口,定义数据库操作方法。
package com.example.mapper;
public interface UserMapper {
void addUser(User user);
User getUserById(Integer id);
}
2.3 创建 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">
<insert id="addUser" parameterType="User">
INSERT INTO user (name, age) VALUES (#{name}, #{age})
</insert>
<select id="getUserById" resultType="User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
三、实践应用
3.1 创建实体类
创建 User.java 实体类,对应数据库中的用户表。
package com.example.entity;
public class User {
private Integer id;
private String name;
private Integer age;
// 省略 getter 和 setter 方法
}
3.2 创建 Service 层
创建 UserService.java 服务层,实现业务逻辑。
package com.example.service;
import com.example.entity.User;
import com.example.mapper.UserMapper;
public class UserService {
private UserMapper userMapper;
public UserService(UserMapper userMapper) {
this.userMapper = userMapper;
}
public void addUser(User user) {
userMapper.addUser(user);
}
public User getUserById(Integer id) {
return userMapper.getUserById(id);
}
}
3.3 创建 Controller 层
创建 UserController.java 控制器,处理 HTTP 请求。
package com.example.controller;
import com.example.entity.User;
import com.example.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
@RestController
@RequestMapping("/user")
public class UserController {
@Autowired
private UserService userService;
@PostMapping("/add")
public String addUser(@RequestBody User user) {
userService.addUser(user);
return "添加成功";
}
@GetMapping("/get/{id}")
public User getUserById(@PathVariable Integer id) {
return userService.getUserById(id);
}
}
3.4 启动项目
启动项目后,可以通过 RESTful API 进行测试。
结语
通过以上步骤,你已成功搭建 MyBatis 环境,并实现了基本的增删改查操作。MyBatis 是一个功能强大的持久层框架,掌握它将有助于提高你的开发效率。希望本文能帮助你轻松入门 MyBatis。
