前言
在Java开发中，MyBatis是一款轻量级且灵活的持久层框架，支持SQL语句和自定义映射，尤其适合需要复杂SQL操作的应用场景。结合Spring Boot，我们可以更加方便地使用MyBatis进行数据操作。本篇文章将手把手地介绍如何在Spring Boot项目中集成MyBatis，并实现基础的增删改查操作。我们会从依赖配置开始，到实体类、Mapper接口、Service和Controller的创建，最终形成一个简洁易用的应用结构。
1. 项目依赖配置
在Spring Boot项目中使用MyBatis的第一步，是在pom.xml文件中引入MyBatis的依赖。这里使用mybatis-spring-boot-starter来实现快速集成，同时加入MySQL驱动程序mysql-connector-java，实现与数据库的连接。
1.1 引入MyBatis和数据库驱动依赖
在pom.xml文件中加入以下依赖配置：
<dependencies>
<!-- MyBatis Spring Boot Starter 依赖 -->
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>2.2.0</version>
</dependency>
<!-- MySQL Connector 依赖 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<scope>runtime</scope>
</dependency>
</dependencies>
1.2 数据源配置
接下来，在application.properties中配置数据库连接信息，以便MyBatis能够正确访问数据库。在这里，我们设置数据库URL、用户名、密码及其他连接信息。
spring.datasource.url=jdbc:mysql://localhost:3306/testdb?useSSL=false&serverTimezone=UTC
spring.datasource.username=root
spring.datasource.password=password
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
# 指定MyBatis的Mapper XML文件位置
mybatis.mapper-locations=classpath:mapper/*.xml
2. 创建数据库映射实体类
MyBatis通过实体类来映射数据库表的字段。以User表为例，创建一个实体类User来表示用户信息，包含ID、用户名、邮箱等字段。
在com.example.demo.model包中创建User类，与数据库中的用户表结构相对应。该类包含属性及其getter和setter方法。
package com.example.demo.model;
public class User {
private Long id;
private String username;
private String email;
// Getter 和 Setter 方法
public Long getId() {
return id;
}
public void setId(Long id) {
this.id = id;
}
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
public String getEmail() {
return email;
}
public void setEmail(String email) {
this.email = email;
}
}
3. 创建Mapper层接口
Mapper层是MyBatis与数据库进行交互的核心。通过Mapper接口定义数据操作方法，使用MyBatis的@Select等注解书写SQL语句，实现增删改查等数据库操作。
在com.example.demo.mapper包中创建UserMapper接口，并用@Mapper注解标记。这里定义的接口方法将被MyBatis自动实现，完成相应的SQL操作。
package com.example.demo.mapper;
import com.example.demo.model.User;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Select;
import java.util.List;
@Mapper
public interface UserMapper {
@Select("SELECT * FROM user")
List<User> findAll();
@Select("SELECT * FROM user WHERE id = #{id}")
User findById(Long id);
}
此接口中的方法findAll()和findById()分别用于查询所有用户和根据ID查询特定用户的信息。
4. 创建Service层
Service层主要封装业务逻辑，进一步管理数据操作。通过Service层，我们可以将数据库操作与业务需求分离，提高代码的可读性和维护性。
4.1 定义Service接口
在com.example.demo.service包中创建UserService接口，定义获取所有用户和根据ID查找用户的方法：
package com.example.demo.service;
import com.example.demo.model.User;
import java.util.List;
public interface UserService {
List<User> getAllUsers();
User getUserById(Long id);
}
4.2 实现Service接口
在com.example.demo.service.impl包中创建UserServiceImpl类，实现UserService接口。使用@Service注解声明这是一个服务类，并通过@Autowired注入UserMapper，调用Mapper接口方法实现数据库操作。
package com.example.demo.service.impl;
import com.example.demo.mapper.UserMapper;
import com.example.demo.model.User;
import com.example.demo.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.util.List;
@Service
public class UserServiceImpl implements UserService {
@Autowired
private UserMapper userMapper;
@Override
public List<User> getAllUsers() {
return userMapper.findAll();
}
@Override
public User getUserById(Long id) {
return userMapper.findById(id);
}
}
在这里，我们通过UserServiceImpl实现具体的业务逻辑，进一步包装了Mapper中的数据库操作，使得Controller层能够更专注于接口设计。
5. 创建Controller层
Controller层是前端和后端交互的接口层，用于接收客户端请求，调用Service层的业务逻辑，并返回处理结果。我们使用Spring MVC的@RestController注解来创建控制器。
在com.example.demo.controller包中创建UserController类，用于处理用户相关的HTTP请求。通过@Autowired注入UserService，并定义接口方法实现获取用户列表和根据ID查找用户的功能。
package com.example.demo.controller;
import com.example.demo.model.User;
import com.example.demo.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
import java.util.List;
@RestController
@RequestMapping("/users")
public class UserController {
@Autowired
private UserService userService;
@GetMapping
public List<User> getAllUsers() {
return userService.getAllUsers();
}
@GetMapping("/{id}")
public User getUserById(@PathVariable Long id) {
return userService.getUserById(id);
}
}
上述代码实现了两个接口方法：
getAllUsers()：用于获取所有用户信息。getUserById(Long id)：根据用户ID获取特定用户信息。
6. 运行和测试项目
完成了以上步骤后，可以运行项目并测试接口，确认功能实现情况。
6.1 启动项目
运行Spring Boot项目的主类DemoApplication中的main方法，启动应用程序。
6.2 测试接口
可以使用Postman等工具测试API接口。例如，发送GET请求至http://localhost:8080/users即可获取所有用户信息，发送GET请求至http://localhost:8080/users/{id}则可以获取指定用户信息。
7. 总结
通过本教程，我们完成了在Spring Boot中集成MyBatis的全过程。从项目依赖配置、实体类、Mapper接口的创建，到Service层和Controller层的开发，逐步实现了数据库的基本操作。通过这种结构化的分层设计，项目代码清晰，业务逻辑和数据操作实现了分离，易于维护和扩展。MyBatis结合Spring Boot的方式能够高效地完成数据持久化操作，希望这篇文章能帮助大家更好地理解和使用这两者的集成。
