Spring Boot 集成 MySQL 的详细指南

在现代软件开发中，Spring Boot 因其简单易用而成为构建 Java 应用程序的热门选择。结合 MySQL这一常用关系型数据库，开发者可以快速构建出功能完善的后端服务。本文将详细介绍如何将 Spring Boot 与 MySQL 集成，提供从环境搭建到代码实现的全方位指导。

一、环境准备

在开始之前，请确保你已经具备以下环境：

1. JDK: Java Development Kit (JDK) 8 及以上版本。
2. Maven: 用于管理项目和依赖。
3. MySQL: 已安装并可访问的 MySQL 数据库。
4. IDE: 安装的 Java 集成开发环境，如 IntelliJ IDEA 或 Eclipse。

1.1 安装 MySQL

如果你还没有安装 MySQL，可以通过以下链接获取：MySQL Downloads

安装完成后，使用命令行或 MySQL Workbench 创建一个新的数据库，例如 test_db。

CREATE DATABASE test_db;

二、创建 Spring Boot 项目

2.1 使用 Spring Initializr 创建项目

1. 访问 Spring Initializr，选择以下配置项：
   • Project: Maven Project
   • Language: Java
   • Spring Boot: 选择最新的稳定版本
   • Packaging: Jar
   • Java: 选择相应版本
2. 在 Dependencies 中添加：
   • Spring Web
   • Spring Data JPA
   • MySQL Driver
3. 生成项目，并下载压缩包，解压后在 IDE 中打开。

2.2 项目结构

解压后的项目结构如下：

src
└── main
    ├── java
    │   └── com
    │       └── example
    │           └── demo
    │               ├── DemoApplication.java
    │               └── ...
    └── resources
        ├── application.properties
        └── ...

三、配置 MySQL 数据库连接

打开 application.properties 文件，添加以下配置：

spring.datasource.url=jdbc:mysql://localhost:3306/test_db?useSSL=false&allowPublicKeyRetrieval=true
spring.datasource.username=root
spring.datasource.password=your_password
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true

3.1 配置详解

• spring.datasource.url: 数据库连接 URL，包含数据库名 test_db。
• spring.datasource.username: 数据库用户，默认是 root。
• spring.datasource.password: 数据库用户的密码。
• spring.jpa.hibernate.ddl-auto: 自动创建或更新数据库表。
• spring.jpa.show-sql: 显示执行的 SQL 语句，方便调试。

四、创建实体类

在 com.example.demo 包下创建一个实体类 User 代表 users 表：

package com.example.demo;

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;

@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String name;
    private String email;

    // Getters and Setters
    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 String getEmail() {
        return email;
    }

    public void setEmail(String email) {
        this.email = email;
    }
}

五、创建数据访问层

接下来，我们需要创建一个接口来访问数据库，通常使用 Spring Data JPA 进行数据访问。

在 com.example.demo 包下创建一个接口 UserRepository：

package com.example.demo;

import org.springframework.data.jpa.repository.JpaRepository;

public interface UserRepository extends JpaRepository<User, Long> {
    // 这里可以添加自定义查询方法
}

六、创建服务层

创建一个服务类来管理用户的业务逻辑。

在 com.example.demo 包下创建 UserService 类：

package com.example.demo;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.List;

@Service
public class UserService {

    @Autowired
    private UserRepository userRepository;

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

    public User createUser(User user) {
        return userRepository.save(user);
    }

    public User getUserById(Long id) {
        return userRepository.findById(id).orElse(null);
    }

    public void deleteUser(Long id) {
        userRepository.deleteById(id);
    }
}

七、创建控制器

最后，我们需要一个控制器来处理 HTTP 请求。在 com.example.demo 包下创建 UserController 类：

package com.example.demo;

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 {

    @Autowired
    private UserService userService;

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

    @PostMapping
    public User createUser(@RequestBody User user) {
        return userService.createUser(user);
    }

    @GetMapping("/{id}")
    public ResponseEntity<User> getUserById(@PathVariable Long id) {
        User user = userService.getUserById(id);
        return ResponseEntity.ok(user);
    }

    @DeleteMapping("/{id}")
    public ResponseEntity<Void> deleteUser(@PathVariable Long id) {
        userService.deleteUser(id);
        return ResponseEntity.noContent().build();
    }
}

八、测试与运行

8.1 测试数据库连接

在项目根目录下，运行以下命令以启动应用程序：

mvn spring-boot:run

确认你的 MySQL 数据库已启动，并且能够在 localhost:3306 访问。

8.2 使用 Postman 测试 API

• 获取所有用户: 发送 GET 请求到 http://localhost:8080/api/users
• 创建用户: 发送 POST 请求到 http://localhost:8080/api/users，并在正文中包含 JSON 数据，例如：

{
    "name": "John Doe",
    "email": "john.doe@example.com"
}

• 获取用户: 发送 GET 请求到 http://localhost:8080/api/users/{id}
• 删除用户: 发送 DELETE 请求到 http://localhost:8080/api/users/{id}

九、总结

恭喜你！现在你已经成功地将 Spring Boot 应用程序与 MySQL 数据库集成。本文涵盖了从环境搭建、项目创建到代码实现的多个方面，希望能帮助你快速上手开发基于 Spring Boot 的 Web 应用。

9.1 后续学习

• 掌握更多的 Spring Data JPA 特性，如复杂查询和分页。
• 学习如何进行异常处理和输入验证。
• 探索 Spring Security 来保护 REST API。
• 学习如何部署 Spring Boot 应用到云服务。

希望本文能够为你后续的开发之路提供帮助。如果你有任何问题或建议，请随时联系我！