Spring Boot 3.3 + MyBatis 基础教程：从入门到实践

Spring Boot 3.3 + MyBatis 基础教程：从入门到实践

在当今的Java开发领域，Spring Boot和MyBatis是构建高效、可维护的后端应用的两个强大工具。Spring Boot简化了Spring应用的初始搭建和开发过程，而MyBatis则提供了一种灵活的ORM（对象关系映射）解决方案。本文将介绍如何在Spring Boot 3.3中集成MyBatis，并通过一个简单的用户管理系统示例来展示其基本用法。同时，我们也会深入探讨MyBatis的实现原理，并通过类图来帮助理解其内部机制。

一、项目搭建

1. 创建Spring Boot项目

首先，使用Spring Initializr（https://start.spring.io/）创建一个Spring Boot项目，选择以下依赖：

• Spring Web
• MyBatis Framework
• MySQL Driver

生成项目后，将项目导入到你的IDE中（如IntelliJ IDEA或Eclipse）。

2. 添加依赖

在pom.xml文件中，确保添加了以下依赖：

<dependencies><!-- Spring Boot Starter 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.4</version></dependency><!-- MySQL Connector --><dependency><groupId>com.mysql</groupId><artifactId>mysql-connector-j</artifactId><scope>runtime</scope></dependency><!-- Spring Boot Starter Test --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope></dependency>
</dependencies>

3. 配置数据源和MyBatis

在application.yml文件中，配置数据源和MyBatis的相关信息：

spring:application:name: spring-boot-demodatasource:url: jdbc:mysql://localhost:3306/db_spring_boot_demo?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=trueusername: rootpassword: 123456driver-class-name: com.mysql.cj.jdbc.Drivermybatis:mapper-locations: classpath:mapper/*.xml

• spring.datasource.*：配置数据库连接信息。
• mybatis.mapper-locations：指定MyBatis映射文件的位置。

二、创建实体类

创建一个简单的User实体类，用于表示用户信息：

package com.example.demo.model;import lombok.Data;@Data
public class User {private Long id;private String username;private String password;
}

• 使用@Data注解来自动生成getter和setter方法。

三、创建Mapper接口

MyBatis通过Mapper接口来定义数据库操作。创建UserMapper接口：

package com.example.demo.mapper;import com.example.demo.model.User;
import org.apache.ibatis.annotations.Mapper;import java.util.List;@Mapper
public interface UserMapper {// 也可以用@Select @Update等注解来定义相关的sql语句，不用xml配图User selectById(Long id);void insert(User user);void update(User user);void deleteById(Long id);List<User> getAll();
}

直接代码定义SQL语句

@Mapper
public interface UserMapper {@Select("SELECT * FROM users WHERE id = #{id}")User selectById(Long id);@Insert("INSERT INTO users(username, password) VALUES(#{username}, #{password})")@Options(useGeneratedKeys = true, keyProperty = "id")void insert(User user);@Update("UPDATE users SET username = #{username}, password = #{password} WHERE id = #{id}")void update(User user);@Delete("DELETE FROM users WHERE id = #{id}")void deleteById(Long id);@Select("SELECT * FROM users")List<User> getAll();
}

使用XML配置SQL

在src/main/resources/mapper目录下创建UserMapper.xml文件，定义SQL语句：

<?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"><select id="selectById" parameterType="long" resultType="com.example.demo.model.User">SELECT * FROM users WHERE id = #{id}</select><insert id="insert" parameterType="com.example.demo.model.User" useGeneratedKeys="true" keyProperty="id">INSERT INTO users(username, password) VALUES(#{username}, #{password})</insert><update id="update" parameterType="com.example.demo.model.User">UPDATE users SET username = #{username}, password = #{password} WHERE id = #{id}</update><delete id="deleteById" parameterType="long">DELETE FROM users WHERE id = #{id}</delete><select id="getAll" resultType="com.example.demo.model.User">SELECT * FROM users</select></mapper>

• namespace：指定Mapper接口的全限定名。
• 每个SQL语句通过<select>、<insert>、<update>、<delete>标签定义。

四、创建服务层

服务层是业务逻辑的核心部分。创建UserService类：

package com.example.demo.service;import com.example.demo.mapper.UserMapper;
import com.example.demo.model.User;
import org.springframework.stereotype.Service;
import org.springframework.beans.factory.annotation.Autowired;import java.util.List;@Service
public class UserService {private final UserMapper userMapper;@Autowiredpublic UserService(UserMapper userMapper) {this.userMapper = userMapper;}public User createUser(User user) {userMapper.insert(user);return user;}public User getUserById(Long id) {return userMapper.selectById(id);}public List<User> getAllUsers() {return userMapper.getAll();}public void updateUser(User user) {userMapper.update(user);}public void deleteUserById(Long id) {userMapper.deleteById(id);}
}

• 使用@Service注解标记这是一个服务类。
• 通过构造函数注入UserMapper。

五、创建控制器

控制器层用于处理HTTP请求。创建UserController类：

package com.example.demo.controller;import com.example.demo.model.User;
import com.example.demo.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;import java.util.List;@RestController
@RequestMapping("/api/users")
public class UserController {private final UserService userService;@Autowiredpublic UserController(UserService userService) {this.userService = userService;}@PostMappingpublic ResponseEntity<User> createUser(@RequestBody User user) {return ResponseEntity.ok(userService.createUser(user));}@GetMapping("/{id}")public ResponseEntity<User> getUserById(@PathVariable Long id) {return ResponseEntity.ok(userService.getUserById(id));}@GetMappingpublic ResponseEntity<List<User>> getAllUsers() {return ResponseEntity.ok(userService.getAllUsers());}@PutMapping("/{id}")public ResponseEntity<Void> updateUser(@PathVariable Long id, @RequestBody User user) {user.setId(id);userService.updateUser(user);return ResponseEntity.noContent().build();}@DeleteMapping("/{id}")public ResponseEntity<Void> deleteUserById(@PathVariable Long id) {userService.deleteUserById(id);return ResponseEntity.noContent().build();}
}

• 使用@RestController注解标记这是一个REST控制器。
• 使用@RequestMapping定义请求路径。
• 使用@Autowired注入UserService。

六、MyBatis实现原理简述

MyBatis是一个半自动化的ORM框架，它通过以下机制实现数据访问：

1. SQL映射：

   • MyBatis通过Mapper接口和注解（或XML配置）将Java对象与SQL语句进行映射。
   • 在UserMapper中，@Select、@Insert等注解定义了SQL语句和Java方法的对应关系。

2. 动态SQL：

   • MyBatis支持动态SQL，可以根据传入的参数动态生成SQL语句。
   • 例如，#{username}会被替换为实际的参数值。

3. SQL会话管理：

   • MyBatis通过SqlSession管理数据库会话，负责执行SQL语句、获取映射器和管理事务。
   • 在Spring Boot中，SqlSession的生命周期由Spring管理。

4. 映射器代理：

   • MyBatis为Mapper接口生成代理对象，当调用Mapper方法时，会通过代理机制执行对应的SQL语句。
   • 例如，调用userMapper.insert(user)时，MyBatis会根据注解生成并执行SQL语句。

5. 结果映射：

   • MyBatis将查询结果自动映射为Java对象。
   • 在selectById方法中，查询结果会被映射为User对象。

MyBatis主要类图（Mermaid格式）

以下是MyBatis主要类的UML类图，使用Mermaid格式表示：

• SqlSessionFactory：负责创建SqlSession实例。
• SqlSession：负责执行SQL语句、获取映射器和管理事务。
• Configuration：存储MyBatis的配置信息，包括环境配置、数据源、事务管理器和映射器。
• Environment：定义了数据源和事务管理器的配置。
• DataSource：提供数据库连接。
• TransactionFactory：用于创建事务管理器。
• Transaction：管理事务的提交和回滚。
• MapperRegistry：管理映射器接口。
• MapperProxy：为映射器接口生成代理对象。
• Mapper：映射器接口，定义了数据库操作方法。

七、运行项目

启动Spring Boot应用后，你可以通过以下RESTful API进行测试：

• 创建用户：POST /api/users
• 获取用户：GET /api/users/{id}
• 获取所有用户：GET /api/users
• 更新用户：PUT /api/users/{id}
• 删除用户：DELETE /api/users/{id}

http测试脚本

IntelliJ http接口请求脚本

### 创建用户 POST /api/users
POST http://localhost:8080/api/users
Content-Type: application/json{"username": "john_doe——2","password": "securePassword123"
}### 根据ID查询用户 GET /api/users/{id}
GET http://localhost:8080/api/users/1### 查询所有用户 GET /api/users
GET http://localhost:8080/api/users### 更新用户 PUT /api/users/{id}
PUT http://localhost:8080/api/users/1
Content-Type: application/json{"username": "john_doe_updated","password": "newSecurePassword456"
}### 删除用户 DELETE /api/users/{id}
DELETE http://localhost:8080/api/users/1

九、总结

通过本文，我们展示了如何在Spring Boot 3.3中集成MyBatis，并实现了一个简单的用户管理系统。MyBatis的灵活性和强大的SQL映射能力使其成为Java开发中常用的ORM框架之一。同时，通过Mermaid格式的类图，我们深入探讨了MyBatis的实现原理，帮助你更好地理解其内部机制。

希望本文对你有所帮助！如果你有任何问题或建议，欢迎留言交流。

---

以我之思，借AI之力