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

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

article 2026/3/16 3:06:39

在当今的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%2B8username: your_usernamepassword: your_passworddriver-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 {@TableIdprivate 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 {@Autowiredprivate UserService userService;@GetMappingpublic List<User> getAllUsers() {return userService.list();}@PostMappingpublic 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);}
}

在这个控制器中，我们定义了一些基本的RESTful API，用于获取、创建、更新和删除用户信息。

测试功能

一切准备就绪后，可以使用Postman或其他工具测试API。启动Spring Boot应用后，访问http://localhost:8080/users可以获取用户列表，使用POST请求添加用户，PUT请求更新用户，DELETE请求删除用户。

总结

通过以上步骤，你已经成功配置并使用了MyBatis-Plus与Spring Boot的结合。MyBatis-Plus为开发人员提供了简化的操作方式，减少了很多样板代码，让开发变得更加高效。在实际项目中，你可以根据需求灵活运用MyBatis-Plus的各种功能，快速构建出高效、可维护的应用。

希望这篇文章能帮助你更好地理解Spring Boot和MyBatis-Plus的使用，快去实践一下吧！