SpringBoot3集成Mybatis

基础使用代码

1. 创建Spring Boot 3项目并添加依赖

使用Spring Initializr创建一个Spring Boot 3项目，添加以下依赖到pom.xml文件中：

<dependencies>
    <!-- Spring Boot Web -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <!-- MyBatis Spring Boot Starter -->
    <dependency>
        <groupId>org.mybatis.spring.boot</groupId>
        <artifactId>mybatis-spring-boot-starter</artifactId>
        <version>3.0.2</version>
    </dependency>
    <!-- MySQL 驱动 -->
    <dependency>
        <groupId>com.mysql</groupId>
        <artifactId>mysql-connector-j</artifactId>
        <scope>runtime</scope>
    </dependency>
</dependencies>

2. 配置数据库连接

在application.properties文件中添加数据库连接信息：

spring.datasource.url=jdbc:mysql://localhost:3306/your_database_name
spring.datasource.username=your_username
spring.datasource.password=your_password
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

3. 创建实体类

创建一个简单的User实体类：

package com.example.demo.entity;

public class User {
    private Long id;
    private String name;
    private Integer age;

    public Long getId() {
        return id;
    }

    public void setId(Long id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }

    @Override
    public String toString() {
        return "User{" +
                "id=" + id +
                ", name='" + name + '\'' +
                ", age=" + age +
                '}';
    }
}

4. 创建Mapper接口

创建UserMapper接口，使用MyBatis注解来定义SQL查询：

package com.example.demo.mapper;

import com.example.demo.entity.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> getAllUsers();
}

5. 创建Service层

创建UserService类，调用UserMapper的方法：

package com.example.demo.service;

import com.example.demo.entity.User;
import com.example.demo.mapper.UserMapper;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.List;

@Service
public class UserService {
    @Autowired
    private UserMapper userMapper;

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

6. 创建Controller层

创建UserController类，提供RESTful接口：

package com.example.demo.controller;

import com.example.demo.entity.User;
import com.example.demo.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.List;

@RestController
public class UserController {
    @Autowired
    private UserService userService;

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

7. 主应用类

确保主应用类添加了必要的注解，并且能扫描到Mapper接口：

package com.example.demo;

import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
@MapperScan("com.example.demo.mapper")
public class DemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

踩坑记录

1. 依赖版本不兼容

Spring Boot 3对依赖版本要求较为严格，如果MyBatis相关依赖版本与Spring Boot 3不兼容，可能会导致启动失败或出现各种异常。要确保使用的mybatis-spring-boot-starter版本与Spring Boot 3兼容。

2. Mapper接口扫描问题

若没有在主应用类上添加@MapperScan注解指定Mapper接口的扫描路径，Spring Boot无法自动将Mapper接口注册为Bean，就会抛出No qualifying bean of type异常。

3. 数据库连接问题

要保证数据库服务正常运行，数据库连接信息（如URL、用户名、密码）准确无误。同时，要注意数据库驱动的版本是否与数据库版本兼容。

4. Java版本问题

Spring Boot 3要求Java 17及以上版本，如果使用的Java版本不符合要求，会导致项目无法正常启动。

心得体会

Spring Boot 3集成MyBatis能让开发者更高效地进行数据库操作开发。Spring Boot 3的自动配置机制和强大的依赖管理，结合MyBatis灵活的SQL映射能力，能快速搭建出功能强大的数据库应用。在集成过程中，要特别注意依赖版本的兼容性和配置的准确性，遇到问题时要仔细查看日志，利用官方文档和社区资源来解决。同时，建议多实践，深入理解Spring Boot和MyBatis的原理和使用方法，这样在开发过程中就能更加得心应手。