当前位置：首页 > article >正文

如何在Spring Boot中配置和使用MyBatis-Plus

article 2025/3/12 21:45:24

在当今的Java开发中，Spring Boot已经成为了一个非常流行的框架，而MyBatis-Plus则是一个强大的ORM框架，为开发人员提供了更简便的数据库操作方式。很多开发者都在使用Spring Boot和MyBatis-Plus的组合来快速构建高效的应用。今天就来聊聊如何在Spring Boot项目中配置和使用MyBatis-Plus，帮助你更好地理解这两者的结合。

创建Spring Boot项目

首先，创建一个新的Spring Boot项目。如果你使用的是Spring Initializr网站，可以选择合适的依赖项。在这里，我们需要选择“Spring Web”和“MyBatis-Plus”相关的依赖。如果你在IDE（如IntelliJ IDEA或Eclipse）中创建项目，可以通过添加Maven或Gradle依赖来实现。

在pom.xml文件中添加MyBatis-Plus的依赖：

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.5.1</version> <!-- 版本可以根据需要调整 -->
</dependency>

同时，确保你有数据库驱动的依赖，例如MySQL：

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.23</version>
</dependency>

配置数据源

接下来，我们需要在application.yml或application.properties文件中配置数据源。以MySQL为例，配置如下：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/your_database?useUnicode=true&characterEncoding=utf-8&serverTimezone=GMT%2B8
    username: your_username
    password: your_password
    driver-class-name: com.mysql.cj.jdbc.Driver

在这里，把your_database、your_username和your_password替换为你自己的数据库名称和登录凭据。

创建实体类

在MyBatis-Plus中，实体类代表了数据库中的表。创建一个简单的实体类，比如User：

import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import lombok.Data;

@Data
@TableName("user") // 对应数据库中的user表
public class User {
    @TableId
    private Long id; // 主键
    private String name; // 用户名
    private Integer age; // 年龄
}

在这个实体类中，@TableName注解用来指定对应的数据库表名，@TableId注解指定字段为主键。

创建Mapper接口

接下来，需要创建Mapper接口。这个接口会继承MyBatis-Plus提供的BaseMapper，从而具备基本的CRUD操作：

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import org.apache.ibatis.annotations.Mapper;

@Mapper
public interface UserMapper extends BaseMapper<User> {
    // 这里可以添加自定义的查询方法
}

这个接口非常简单，继承BaseMapper后，它就具备了基本的增删改查能力。

配置MyBatis-Plus

虽然在大多数情况下，MyBatis-Plus的默认配置就能满足需求，但你可以通过配置文件进行一些定制化配置。在application.yml中，可以添加MyBatis-Plus的相关配置：

mybatis-plus:
  global-config:
    db-config:
      id-type: auto # 主键策略
      logic-delete-value: 1 # 逻辑删除值
      logic-not-delete-value: 0 # 逻辑未删除值

这里的配置项可以根据项目需要进行调整。比如，id-type设置为auto表示主键自增。

创建服务层

为了更好地组织代码，可以创建一个服务层，用于处理业务逻辑。创建一个UserService类：

import com.baomidou.mybatisplus.extension.service.IService;

public interface UserService extends IService<User> {
    // 这里可以添加自定义的业务方法
}

实现这个接口的类：

import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import org.springframework.stereotype.Service;

@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService {
    // 业务逻辑可以在这里实现
}

控制器层的创建

接下来，创建控制器层，用于处理HTTP请求。创建一个UserController类：

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.list();
    }

    @PostMapping
    public boolean createUser(@RequestBody User user) {
        return userService.save(user);
    }

    @PutMapping("/{id}")
    public boolean updateUser(@PathVariable Long id, @RequestBody User user) {
        user.setId(id);
        return userService.updateById(user);
    }

    @DeleteMapping("/{id}")
    public boolean deleteUser(@PathVariable Long id) {
        return userService.removeById(id);
    }
}