IntelliJ IDEA中Spring Boot项目整合MyBatis:从零实现高效数据持久化

‌前言

MyBatis作为一款灵活且强大的‌ORM框架‌ ,凭借其直观的SQL映射和动态SQL能力,成为Java开发者首选的持久层解决方案。本文将以‌Spring Boot 3.4.x‌ 和‌MyBatis 3.5.x‌ 为例,手把手教你‌在IDEA中集成MyBatis‌ ,涵盖‌注解与XML两种开发模式‌、‌分页插件集成‌、‌多数据源配置‌ 及‌生产级避坑指南‌,助你轻松实现高效数据操作!


‌一、环境准备

1. ‌基础环境

  • JDK 17+(推荐OpenJDK 17/21)
  • IntelliJ IDEA 2023.1+
  • MySQL 8.x(或其他支持JDBC的数据库)

2. ‌项目初始化

  • 通过Spring Initializr创建项目,选择:
    • Spring Boot 3.4.x
    • 依赖项:Spring Web, MySQL Driver, ‌MyBatis Framework‌
    • (可选)Lombok简化代码

‌二、添加MyBatis依赖

‌1. 验证pom.xml依赖

确保包含以下核心依赖:

bash 复制代码
<!-- MyBatis官方Starter(适配Spring Boot 3.4.x) -->
<dependency>
    <groupId>org.mybatis.spring.boot</groupId>
    <artifactId>mybatis-spring-boot-starter</artifactId>
    <version>3.0.3</version>
</dependency>

<!-- MySQL驱动 -->
<dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
    <scope>runtime</scope>
</dependency>

<!-- 分页插件(可选) -->
<dependency>
    <groupId>com.github.pagehelper</groupId>
    <artifactId>pagehelper-spring-boot-starter</artifactId>
    <version>2.1.0</version>
</dependency>

‌注‌:Spring Boot 3.4.x需使用MyBatis Starter 3.0.x+,兼容Jakarta EE 9+规范。


‌三、配置数据源与MyBatis

‌1. 数据库连接配置(application.yml)

bash 复制代码
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/mybatis_demo?useSSL=false&serverTimezone=UTC
    username: root
    password: 123456
    driver-class-name: com.mysql.cj.jdbc.Driver

# MyBatis配置
mybatis:
  mapper-locations: classpath:mapper/*.xml  # XML映射文件路径
  type-aliases-package: com.example.demo.entity  # 实体类别名包
  configuration:
    map-underscore-to-camel-case: true  # 开启驼峰命名转换
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl  # 输出SQL日志

‌2. 配置Mapper扫描(可选)

在启动类添加@MapperScan注解:

bash 复制代码
@SpringBootApplication
@MapperScan("com.example.demo.mapper")  // 指定Mapper接口包路径
public class DemoApplication { ... }

‌四、两种开发模式实战

‌模式1:注解开发(适合简单SQL)

1. ‌定义实体类
bash 复制代码
@Data
public class User {
    private Long id;
    private String username;
    private String email;
    private LocalDateTime createTime;
}
2. ‌编写Mapper接口
bash 复制代码
public interface UserMapper {
    // 插入并返回自增ID
    @Options(useGeneratedKeys = true, keyProperty = "id")
    @Insert("INSERT INTO user(username, email) VALUES(#{username}, #{email})")
    int insertUser(User user);

    @Select("SELECT * FROM user WHERE id = #{id}")
    User selectById(Long id);
}

‌模式2:XML开发(适合复杂SQL)

1. ‌创建XML映射文件(resources/mapper/UserMapper.xml)
bash 复制代码
<?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.demo.mapper.UserMapper">
    <resultMap id="userMap" type="User">
        <id column="id" property="id"/>
        <result column="username" property="username"/>
        <result column="email" property="email"/>
        <result column="create_time" property="createTime"/>
    </resultMap>

    <select id="selectAll" resultMap="userMap">
        SELECT * FROM user
    </select>
</mapper>
2. ‌在Mapper接口中声明方法
bash 复制代码
public interface UserMapper {
    List<User> selectAll();
}

五、Service与Controller层

‌1. 业务逻辑层(Service)

bash 复制代码
@Service
public class UserService {
    @Autowired
    private UserMapper userMapper;

    public User getUserById(Long id) {
        return userMapper.selectById(id);
    }

    public List<User> getAllUsers() {
        return userMapper.selectAll();
    }
}

‌2. REST接口层(Controller)

bash 复制代码
@RestController
@RequestMapping("/api/users")
public class UserController {
    @Autowired
    private UserService userService;

    @GetMapping("/{id}")
    public User getUser(@PathVariable Long id) {
        return userService.getUserById(id);
    }

    @GetMapping
    public List<User> getAllUsers() {
        return userService.getAllUsers();
    }
}

‌六、高级功能:分页插件

‌1. 分页查询实现

bash 复制代码
public PageInfo<User> getUsersByPage(int pageNum, int pageSize) {
    PageHelper.startPage(pageNum, pageSize);
    List<User> users = userMapper.selectAll();
    return new PageInfo<>(users);
}

‌2. 接口测试

请求GET /api/users/page?pageNum=1&pageSize=5,返回分页数据:

bash 复制代码
{
  "total": 20,
  "list": [ ... ],
  "pageNum": 1,
  "pageSize": 5
}

‌七、常见问题与解决方案

Q1:Mapper接口无法注入(NoSuchBeanDefinitionException)

  • 原因‌:未扫描到Mapper接口。
  • 解决‌
    • 检查@MapperScan路径是否正确。
    • 确认Mapper接口添加了@Mapper注解(若未用@MapperScan)。

‌Q2:XML文件未找到(Invalid bound statement)

  • 解决‌
    • 检查mybatis.mapper-locations路径是否匹配。

    • pom.xml中添加资源过滤:

      bash 复制代码
      <build>
          <resources>
              <resource>
                  <directory>src/main/resources</directory>
                  <includes>
                      <include>**/*.xml</include>
                  </includes>
              </resource>
          </resources>
      </build>

‌Q3:事务管理失效

  • 解决‌
    • 在Service方法添加@Transactional注解。
    • 确认已启用事务管理(Spring Boot默认启用)。

总结

通过Spring Boot与MyBatis的整合,开发者可以灵活选择注解或XML方式管理SQL,兼顾开发效率与维护性。本文从基础配置到高级应用,覆盖了企业级开发的核心需求。

相关推荐
胚芽鞘68123 分钟前
查询依赖冲突工具maven Helper
java·数据库·maven
Charlie__ZS28 分钟前
若依框架去掉Redis
java·redis·mybatis
咖啡啡不加糖1 小时前
RabbitMQ 消息队列:从入门到Spring Boot实战
java·spring boot·rabbitmq
玩代码1 小时前
Java线程池原理概述
java·开发语言·线程池
NE_STOP1 小时前
SpringBoot--如何给项目添加配置属性及读取属性
java
水果里面有苹果1 小时前
20-C#构造函数--虚方法
java·前端·c#
%d%d21 小时前
python 在运行时没有加载修改后的版本
java·服务器·python
金銀銅鐵1 小时前
[Kotlin] 单例对象是如何实现的?
java·kotlin
泰勒疯狂展开1 小时前
Java研学-MongoDB(三)
java·开发语言·mongodb
zzywxc7872 小时前
AI技术通过提示词工程(Prompt Engineering)正在深度重塑职场生态和行业格局,这种变革不仅体现在效率提升,更在重构人机协作模式。
java·大数据·开发语言·人工智能·spring·重构·prompt