前言

在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的方式能够高效地完成数据持久化操作，希望这篇文章能帮助大家更好地理解和使用这两者的集成。