Spring Boot + MyBatis + MySQL：快速搭建CRUD应用

随风九天2025-03-09 23:37

一、引言

1. 项目背景与目标

在现代Web开发中，CRUD（创建、读取、更新、删除）操作是几乎所有应用程序的核心功能。本项目旨在通过Spring Boot、MyBatis和MySQL技术栈，快速搭建一个高效、简洁的CRUD应用。我们将从零开始，逐步实现一个用户管理系统的增删改查功能。

2. 技术选型与适用场景

  • Spring Boot：简化了基于Spring的应用开发，提供了自动配置、嵌入式服务器等特性。
  • MyBatis：作为持久层框架，支持自定义SQL、存储过程和高级映射，灵活性高。
  • MySQL：广泛使用的开源关系型数据库，性能稳定，社区活跃。

二、开发环境准备

1. 开发工具与依赖安装

  • JDK：确保已安装Java Development Kit（建议版本8及以上）。
  • Maven/Gradle：用于项目构建和依赖管理。
  • IDE：推荐使用IntelliJ IDEA或Eclipse。
  • MySQL：下载并安装MySQL数据库，配置好数据库连接信息。

2. Spring Boot项目初始化

  • 使用 Spring Initializr 创建项目：
    • Project: Maven Project
    • Language: Java
    • Spring Boot: 最新稳定版本
    • Dependencies: Spring Web, MyBatis Framework, MySQL Driver

三、数据库设计与初始化

1. MySQL数据库表设计

创建一个简单的用户表user，包含以下字段：

sql 复制代码 
CREATE TABLE user (
    id INT AUTO_INCREMENT PRIMARY KEY,
    username VARCHAR(50) NOT NULL UNIQUE,
    password VARCHAR(100) NOT NULL,
    email VARCHAR(100),
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

2. 数据初始化脚本

在src/main/resources目录下创建data.sql文件，插入一些测试数据：

sql 复制代码 
INSERT INTO user (username, password, email) VALUES 
('admin', 'password123', 'admin@example.com'),
('user1', 'password123', 'user1@example.com');

配置application.yml中的数据库连接信息：

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

四、Spring Boot与MyBatis集成

1. MyBatis基础配置

在application.yml中添加MyBatis配置：

yaml 复制代码 
mybatis:
  mapper-locations: classpath:mapper/*.xml
  type-aliases-package: com.example.demo.entity

2. 实体类与Mapper接口开发

  • 实体类 ：创建User类表示用户信息。

    java 复制代码 
    package com.example.demo.entity;

public class User {
    private Integer id;
    private String username;
    private String password;
    private String email;
    private Timestamp createdAt;

    // Getters and Setters
}

  • Mapper接口 ：创建UserMapper接口及对应的XML映射文件。

    java 复制代码 
    package com.example.demo.mapper;

import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Select;

@Mapper
public interface UserMapper {
    @Select("SELECT * FROM user WHERE id = #{id}")
    User findById(Integer id);
}

    在src/main/resources/mapper目录下创建UserMapper.xml：

    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.demo.mapper.UserMapper">
    <select id="findById" resultType="com.example.demo.entity.User">
        SELECT * FROM user WHERE id = #{id}
    </select>
</mapper>

3. Service层与Controller层实现

  • Service层：封装业务逻辑。

    java 复制代码 
    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;

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

    public User getUserById(Integer id) {
        return userMapper.findById(id);
    }
}

  • Controller层：提供RESTful API接口。

    java 复制代码 
    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.PathVariable;
import org.springframework.web.bind.annotation.RestController;

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

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

五、CRUD功能实现

1. 创建（Create）功能

  • Mapper接口：添加插入数据的方法。

    java 复制代码 
    @Insert("INSERT INTO user (username, password, email) VALUES (#{username}, #{password}, #{email})")
void insertUser(User user);

  • Service层：实现新增用户逻辑。

    java 复制代码 
    public void createUser(User user) {
    userMapper.insertUser(user);
}

  • Controller层：提供新增用户的API接口。

    java 复制代码 
    @PostMapping("/users")
public void createUser(@RequestBody User user) {
    userService.createUser(user);
}

2. 读取（Read）功能

  • 分页查询 ：使用MyBatis分页插件PageHelper。

    xml 复制代码 
    <select id="findAllUsers" resultType="com.example.demo.entity.User">
    SELECT * FROM user
</select>
java 复制代码 
  PageHelper.startPage(pageNum, pageSize);
  List<User> users = userMapper.findAllUsers();
  PageInfo<User> pageInfo = new PageInfo<>(users);

  • 动态条件查询 ：按用户名模糊搜索。

    xml 复制代码 
    <select id="findUsersByUsername" resultType="com.example.demo.entity.User">
    SELECT * FROM user WHERE username LIKE CONCAT('%', #{username}, '%')
</select>

3. 更新（Update）功能

  • Mapper接口：添加更新数据的方法。

    java 复制代码 
    @Update("UPDATE user SET username=#{username}, password=#{password}, email=#{email} WHERE id=#{id}")
void updateUser(User user);

  • Service层：实现更新用户逻辑。

    java 复制代码 
    public void updateUser(User user) {
    userMapper.updateUser(user);
}

  • Controller层：提供更新用户的API接口。

    java 复制代码 
    @PutMapping("/users/{id}")
public void updateUser(@PathVariable Integer id, @RequestBody User user) {
    user.setId(id);
    userService.updateUser(user);
}

4. 删除（Delete）功能

  • 硬删除：直接从数据库中删除记录。

    java 复制代码 
    @Delete("DELETE FROM user WHERE id=#{id}")
void deleteUserById(Integer id);

  • 软删除 ：添加is_deleted字段标记删除状态。

    sql 复制代码 
    ALTER TABLE user ADD COLUMN is_deleted TINYINT DEFAULT 0;
java 复制代码 
  @Update("UPDATE user SET is_deleted=1 WHERE id=#{id}")
  void softDeleteUserById(Integer id);

六、功能扩展与优化

1. 事务管理

  • @Transactional注解 ：确保多个操作在同一事务中执行。

    java 复制代码 
    @Service
@Transactional
public class UserService {
    // CRUD方法
}

2. 分页与排序

  • PageHelper分页插件：实现分页查询。

    xml 复制代码 
    <dependency>
    <groupId>com.github.pagehelper</groupId>
    <artifactId>pagehelper-spring-boot-starter</artifactId>
    <version>1.4.0</version>
</dependency>

  • 排序参数动态传入：根据请求参数进行排序。

    java 复制代码 
    PageHelper.startPage(pageNum, pageSize).setOrderBy(orderBy);

3. 异常处理

  • 全局异常捕获 ：使用@ControllerAdvice处理全局异常。

    java 复制代码 
    @ControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(Exception.class)
    public ResponseEntity<String> handleException(Exception e) {
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(e.getMessage());
    }
}

七、测试与部署

1. 单元测试与集成测试

  • 单元测试：编写Mapper接口测试用例。

    java 复制代码 
    @RunWith(SpringRunner.class)
@SpringBootTest
public class UserMapperTest {
    @Autowired
    private UserMapper userMapper;

    @Test
    public void testFindById() {
        User user = userMapper.findById(1);
        assertNotNull(user);
    }
}

  • 集成测试：验证CRUD功能完整性。

    java 复制代码 
    @RunWith(SpringRunner.class)
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
public class UserControllerIT {
    @Autowired
    private TestRestTemplate restTemplate;

    @Test
    public void testGetUser() {
        ResponseEntity<User> response = restTemplate.getForEntity("/users/1", User.class);
        assertEquals(HttpStatus.OK, response.getStatusCode());
    }
}

2. 项目打包与部署

  • 打包为可执行JAR文件：

    bash 复制代码 
    mvn clean package

  • 部署到本地Tomcat或云服务器：

    • 将生成的JAR文件上传至服务器，并通过命令启动：

      bash 复制代码 
      java -jar myapp.jar
相关推荐
计算机学姐8 分钟前
基于Asp.net的驾校管理系统
vue.js·后端·mysql·sqlserver·c#·asp.net·.netcore
马剑威（威哥爱编程）9 分钟前
C语言操作MySQL从入门到精通
c语言·mysql·adb
欢乐少年19042 小时前
SpringBoot集成Sentry日志收集-3 (Spring Boot集成)
spring boot·后端·sentry
明矾java5 小时前
MySQL进阶-关联查询优化
数据库·mysql
冰糖码奇朵5 小时前
大数据表高效导入导出解决方案，mysql数据库LOAD DATA命令和INTO OUTFILE命令详解
java·数据库·sql·mysql
迷路的小犀牛5 小时前
【MYSQL数据库异常处理】执行SQL语句报超时异常
数据库·sql·mysql
笑远5 小时前
MySQL 主主复制与 Redis 环境安装部署
redis·mysql·adb
曹天骄5 小时前
使用 MyBatis XML 和 QueryWrapper 实现动态查询
xml·mybatis
热门推荐
01DeepSeek各版本说明与优缺点分析02从零安装 LLaMA-Factory 微调 Qwen 大模型成功及所有的坑03如何在WPS和Word/Excel中直接使用DeepSeek功能04苍穹外卖面试总结05DeepSeek R1本地化部署 Ollama + Chatbox 打造最强 AI 工具06本地部署DeepSeek教程（Mac版本）07Coze扣子平台完整体验和实践（附国内和国际版对比）08Windows 11 安装 Dify 完整指南 非docker环境09保姆级教程：利用Ollama与Open-WebUI本地部署 DeedSeek-R1大模型10macOS 上部署 RAGFlow