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

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

article 2025/8/16 2:52:26

在这里插入图片描述

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格式表示：

creates
uses
has
uses
uses
creates
has
creates
implements
SqlSessionFactory
+open()
+getConfiguration()
SqlSession
+selectOne()
+selectList()
+insert()
+update()
+delete()
+getMapper()
Configuration
+getEnvironment()
+getMapperRegistry()
Environment
+getDataSource()
+getTransactionFactory()
DataSource
+getConnection()
TransactionFactory
+newTransaction()
Transaction
+commit()
+rollback()
MapperRegistry
+getMappers()
MapperProxy
+invoke()
Mapper
+selectById()
+insert()
+update()
+deleteById()
+getAll()
  • 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之力

http://www.lryc.cn/news/2404160.html

相关文章：

  • 征文投稿：如何写一份实用的技术文档？——以软件配置为例
  • 【后端】RPC
  • 详细讲解Flutter GetX的使用
  • ReLU 新生：从死亡困境到强势回归
  • tensorflow image_dataset_from_directory 训练数据集构建
  • QuickJS 如何发送一封邮件 ？
  • clickhouse 和 influxdb 选型
  • GOOUUU ESP32-S3-CAM 果云科技开发板开发指南（一）（超详细！）Vscode+espidf 通过摄像头拍摄照片并存取到SD卡中，文末附源码
  • C++学习思路
  • 全流程开源！高德3D贴图生成系统，白模一键生成真实感纹理贴图
  • 使用Conda管理服务器多版本Python环境的完整指南
  • html 滚动条滚动过快会留下边框线
  • 数据通信与计算机网络——数据与信号
  • 【LLM大模型技术专题】「入门到精通系列教程」LangChain4j与Spring Boot集成开发实战指南
  • Flask 基础与实战概述
  • 东芝Toshiba e-STUDIO2110AC打印机信息
  • Vue3 GSAP动画库绑定滚动条视差效果 绑定滚动条 滚动条动画 时间轴
  • grafana-mcp-analyzer：基于 MCP 的轻量 AI 分析监控图表的运维神器！
  • git commit 执行报错 sh: -/: invalid option
  • uniapp 设置手机不息屏
  • 【题解-洛谷】B3622 枚举子集（递归实现指数型枚举）
  • (LeetCode 每日一题)3170. 删除星号以后字典序最小的字符串(贪心+栈)
  • Protobuf 中的类型查找规则
  • Python项目中添加环境配置文件
  • 【区块链基础】区块链的 Fork（分叉）深度解析：原理、类型、历史案例及共识机制的影响
  • IOS 打包账号发布上传和IOS Xcode证书配置
  • 使用 HTML + JavaScript 实现文章逐句高亮朗读功能
  • 【CSS-4】掌握CSS文字样式：从基础到高级技巧
  • 双碳时代，能源调度的难题正从“发电侧”转向“企业侧”
  • 3. 简述node.js特性与底层原理