Spring Boot 3 集成 MyBatis 连接 MySQL 数据库-EW帮帮网

Spring Boot 3 集成 MyBatis 连接 MySQL 数据库的步骤：

以下是集成 Spring Boot 3、MyBatis、HikariCP 连接池并操作 MySQL 数据库的完整步骤和代码：

一、创建 Spring Boot 项目

添加以下依赖：

<dependencies>
    <!-- Spring Web -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    
    <!-- MyBatis -->
    <dependency>
        <groupId>org.mybatis.spring.boot</groupId>
        <artifactId>mybatis-spring-boot-starter</artifactId>
        <version>3.0.4</version>
    </dependency>
    
    <!-- MySQL 驱动 -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <scope>runtime</scope>
    </dependency>
    
    <!-- HikariCP 连接池 (默认集成，无需显式添加) -->
    
    <!-- Lombok (可选) -->
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <optional>true</optional>
    </dependency>
</dependencies>

二、配置数据库连接

在 src/main/resources/application.yml 中添加配置：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/his2?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true
    username: root
    password: yourpassword
    driver-class-name: com.mysql.cj.jdbc.Driver
    hikari:
      maximum-pool-size: 10       # 最大连接数
      minimum-idle: 5            # 最小空闲连接
      idle-timeout: 30000        # 空闲连接超时时间（毫秒）
      connection-timeout: 30000  # 连接超时时间（毫秒）
      max-lifetime: 1800000      # 连接最大生命周期（毫秒）

mybatis:
  mapper-locations: classpath:mapper/*.xml  # Mapper XML 文件位置
  type-aliases-package: com.example.entity  # 实体类包路径
  configuration:
    map-underscore-to-camel-case: true      # 开启驼峰命名映射
    cache-enabled: true                     # 开启二级缓存

三、创建实体类

src/main/java/com/example/entity/User.java：

import lombok.Data;

@Data
public class User {
    private Long id;
    private String username;
    private String password;
    private Integer age;
    private String email;
    private LocalDateTime createTime;
}

四、创建 Mapper 接口

src/main/java/com/example/mapper/UserMapper.java：

import com.example.entity.User;
import org.apache.ibatis.annotations.Mapper;

import java.util.List;

@Mapper
public interface UserMapper {
    // 查询所有用户
    List<User> selectAll();
    
    // 根据 ID 查询用户
    User selectById(Long id);
    
    // 插入用户
    int insert(User user);
    
    // 更新用户
    int update(User user);
    
    // 删除用户
    int deleteById(Long id);
}

五、创建 Mapper XML 文件

src/main/resources/mapper/UserMapper.xml：

<?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.mapper.UserMapper">
    
    <resultMap id="BaseResultMap" type="User">
        <id column="id" property="id" />
        <result column="username" property="username" />
        <result column="password" property="password" />
        <result column="age" property="age" />
        <result column="email" property="email" />
        <result column="create_time" property="createTime" />
    </resultMap>
    
    <select id="selectAll" resultMap="BaseResultMap">
        SELECT * FROM user
    </select>
    
    <select id="selectById" resultMap="BaseResultMap">
        SELECT * FROM user WHERE id = #{id}
    </select>
    
    <insert id="insert" parameterType="User">
        INSERT INTO user (username, password, age, email, create_time)
        VALUES (#{username}, #{password}, #{age}, #{email}, #{createTime})
    </insert>
    
    <update id="update" parameterType="User">
        UPDATE user
        SET username = #{username},
            password = #{password},
            age = #{age},
            email = #{email}
        WHERE id = #{id}
    </update>
    
    <delete id="deleteById" parameterType="Long">
        DELETE FROM user WHERE id = #{id}
    </delete>
</mapper>

六、创建 Service 层

src/main/java/com/example/service/UserService.java：

import com.example.entity.User;

import java.util.List;

public interface UserService {
    List<User> getAllUsers();
    User getUserById(Long id);
    int saveUser(User user);
    int updateUser(User user);
    int deleteUser(Long id);
}

src/main/java/com/example/service/impl/UserServiceImpl.java：

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

import java.util.List;

@Service
@Transactional
public class UserServiceImpl implements UserService {
    
    @Autowired
    private UserMapper userMapper;
    
    @Override
    public List<User> getAllUsers() {
        return userMapper.selectAll();
    }
    
    @Override
    public User getUserById(Long id) {
        return userMapper.selectById(id);
    }
    
    @Override
    public int saveUser(User user) {
        return userMapper.insert(user);
    }
    
    @Override
    public int updateUser(User user) {
        return userMapper.update(user);
    }
    
    @Override
    public int deleteUser(Long id) {
        return userMapper.deleteById(id);
    }
}

七、创建 Controller 层

src/main/java/com/example/controller/UserController.java：

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

import java.util.List;

@RestController
@RequestMapping("/api/users")
public class UserController {
    
    @Autowired
    private UserService userService;
    
    // 获取所有用户
    @GetMapping
    public List<User> getAllUsers() {
        return userService.getAllUsers();
    }
    
    // 根据 ID 获取用户
    @GetMapping("/{id}")
    public User getUserById(@PathVariable Long id) {
        return userService.getUserById(id);
    }
    
    // 添加用户
    @PostMapping
    public int saveUser(@RequestBody User user) {
        return userService.saveUser(user);
    }
    
    // 更新用户
    @PutMapping("/{id}")
    public int updateUser(@PathVariable Long id, @RequestBody User user) {
        user.setId(id);
        return userService.updateUser(user);
    }
    
    // 删除用户
    @DeleteMapping("/{id}")
    public int deleteUser(@PathVariable Long id) {
        return userService.deleteUser(id);
    }
}

八、启用 MyBatis

在主应用类上添加 @MapperScan 注解：

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

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

九、数据库表结构

确保 MySQL 数据库 his2 中存在 user 表：

CREATE DATABASE his2;

USE his2;

CREATE TABLE user (
    id BIGINT PRIMARY KEY AUTO_INCREMENT,
    username VARCHAR(50) NOT NULL,
    password VARCHAR(100) NOT NULL,
    age INT,
    email VARCHAR(50),
    create_time DATETIME DEFAULT CURRENT_TIMESTAMP
);

十、测试应用

启动应用后，使用工具（如 Postman）测试接口：

获取所有用户
```
GET http://localhost:8080/api/users
```
获取单个用户
```
GET http://localhost:8080/api/users/1
```

添加用户

POST http://localhost:8080/api/users
请求体:
{
    "username": "test",
    "password": "123456",
    "age": 25,
    "email": "test@example.com"
}

更新用户

PUT http://localhost:8080/api/users/1
请求体:
{
    "username": "updated",
    "age": 26
}

删除用户

DELETE http://localhost:8080/api/users/1

十一、连接池配置

Spring Boot 3 默认使用 HikariCP 连接池，通过 spring.datasource.hikari 配置：

maximum-pool-size: 最大连接数（默认 10）
minimum-idle: 最小空闲连接数（默认与 maximum-pool-size 相同）
idle-timeout: 空闲连接超时时间（默认 30000 毫秒）
connection-timeout: 获取连接超时时间（默认 30000 毫秒）
max-lifetime: 连接最大生命周期（默认 1800000 毫秒）

十二、同包存放

同包存放：Mapper 接口和 XML 文件放在同一包下时，无需额外配置 mapper-locations，MyBatis 会自动识别。
核心配置：确保 @MapperScan 扫描到 Mapper 包，并通过 application.yml 配置数据库连接和连接池参数。
资源打包：若 XML 在 Java 源码目录下，需在 pom.xml 中配置资源过滤，确保其被编译到类路径中。

问题 1：XML 文件未被打包到类路径中

如果 XML 文件未被编译到 target/classes 目录下，需在 pom.xml 中配置资源过滤：

<build>
    <resources>
        <resource>
            <directory>src/main/java</directory>
            <includes>
                <include>**/*.xml</include>  <!-- 包含 Java 目录下的 XML 文件 -->
            </includes>
        </resource>
        <resource>
            <directory>src/main/resources</directory>
        </resource>
    </resources>
</build>

问题 2：手动指定 XML 路径（非必须）

如果 XML 与 Mapper 接口不在同一包，需在 application.yml 中明确指定 XML 位置：

mybatis:
  mapper-locations: classpath:/mapper/**/*.xml  # 例如：XML 放在 resources/mapper 目录下

十三、关于传统的MyBatis 中的 `SqlMapConfig.xml`

- 传统 Spring + MyBatis：需要 SqlMapConfig.xml 配置 MyBatis 基础信息，再由 Spring 加载。
- Spring Boot + MyBatis：无需 SqlMapConfig.xml，通过自动配置和属性文件即可完成大部分配置，更简洁。
- 什么时候需要自定义配置？
  当需要修改 MyBatis 全局行为（如添加插件、自定义类型处理器）时，可通过 Java 配置类（@Configuration + @Bean）替代传统的 XML 配置，例如：
  java
```
@Configuration
public class MyBatisConfig {
    @Bean
    public MyBatisConfiguration myBatisConfiguration() {
        MyBatisConfiguration configuration = new MyBatisConfiguration();
        configuration.setMapUnderscoreToCamelCase(true); // 开启驼峰映射
        return configuration;
    }
}
```

Spring Boot 3 集成 MyBatis 连接 MySQL 数据库

Spring Boot 3 集成 MyBatis 连接 MySQL 数据库的步骤：

一、创建 Spring Boot 项目

二、配置数据库连接

三、创建实体类

四、创建 Mapper 接口

五、创建 Mapper XML 文件

六、创建 Service 层

七、创建 Controller 层

八、启用 MyBatis

九、数据库表结构

十、测试应用

十一、连接池配置

十二、同包存放

问题 1：XML 文件未被打包到类路径中

问题 2：手动指定 XML 路径（非必须）

十三、关于传统的MyBatis 中的 `SqlMapConfig.xml`

网站公告

今日签到

热门文章

最新发布

Spring Boot 3 集成 MyBatis 连接 MySQL 数据库

Spring Boot 3 集成 MyBatis 连接 MySQL 数据库的步骤：

一、创建 Spring Boot 项目

二、配置数据库连接

三、创建实体类

四、创建 Mapper 接口

五、创建 Mapper XML 文件

六、创建 Service 层

七、创建 Controller 层

八、启用 MyBatis

九、数据库表结构

十、测试应用

十一、连接池配置

十二、同包存放

问题 1：XML 文件未被打包到类路径中

问题 2：手动指定 XML 路径（非必须）

十三、关于传统的MyBatis 中的 SqlMapConfig.xml

网站公告

今日签到

热门文章

最新发布

十三、关于传统的MyBatis 中的 `SqlMapConfig.xml`