Spring Boot 集成 MySQL 8 的完整教程

在现代的 Java 开发中,Spring Boot 是一个非常流行的框架,而 MySQL 作为关系数据库也被广泛使用。本文将指导你如何通过几个简单的步骤将 Spring Boot 应用程序集成到 MySQL 8 中。

流程概述

以下是实现 Spring Boot 集成 MySQL 8 的步骤:

步骤 描述
1 创建 Spring Boot 项目
2 添加 MySQL 依赖
3 配置 MySQL 数据库连接
4 创建实体类和接口
5 编写 REST 控制器
6 运行应用程序并测试

步骤详解

1. 创建 Spring Boot 项目

首先,你可以通过 Spring Initializr 在线生成项目,选择 Spring WebSpring Data JPA 作为依赖。


2. 添加 MySQL 依赖

在生成的 pom.xml 文件中,添加 MySQL 驱动的依赖。你可以在 <dependencies> 标签中加入以下代码:

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.30</version> <!-- 确保使用的是合适的版本 -->
</dependency>

说明:这里我们加入了 MySQL Connector/J,这是连接 MySQL 数据库所必需的。

3. 配置 MySQL 数据库连接

application.properties 文件中,需要添加数据库连接信息。输入以下代码:

spring.datasource.url=jdbc:mysql://localhost:3306/your_database_name?useSSL=false&serverTimezone=UTC
spring.datasource.username=your_username
spring.datasource.password=your_password
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true

说明

  • spring.datasource.url:指定 MySQL 数据库的 URL。请替换 your_database_name 为你的数据库名称。
  • spring.datasource.username:数据库的用户名。
  • spring.datasource.password:数据库用户的密码。
  • spring.jpa.hibernate.ddl-auto:设置 Hibernate 的数据库操作方式,这里设置为 update,表示在每次启动时自动更新数据库表。
  • spring.jpa.show-sql:设置为 true 将展示 Hibernate 生成的 SQL 语句。

4. 创建实体类和接口

接下来,我们创建一个实体类,比如 User。在你的项目中创建一个 model 包,并新增 User.java 文件:

package com.example.demo.model;

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;      // 用户 ID

    private String name;  // 用户名

    // Getter 和 Setter 方法省略
}

接着,在 repository 包中创建一个接口 UserRepository.java

package com.example.demo.repository;

import com.example.demo.model.User;
import org.springframework.data.jpa.repository.JpaRepository;

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

说明User 类对应数据库中的 user 表,UserRepository 接口用于进行 CRUD操作。

5. 编写 REST 控制器

在你的项目中,创建一个 controller 包,并新增 UserController.java 文件:

package com.example.demo.controller;

import com.example.demo.model.User;
import com.example.demo.repository.UserRepository;
import org.springframework.web.bind.annotation.*;

import java.util.List;

@RestController
@RequestMapping("/users")
public class UserController {

    private final UserRepository userRepository;

    public UserController(UserRepository userRepository) {
        this.userRepository = userRepository;
    }

    @GetMapping
    public List<User> getAllUsers() {
        return userRepository.findAll(); // 获取所有用户
    }

    @PostMapping
    public User createUser(@RequestBody User user) {
        return userRepository.save(user); // 创建用户
    }
}

说明:上面的代码中定义了两个 REST API,一个用于获取所有用户,另一个用于创建新用户。

6. 运行应用程序并测试

确保 MySQL 数据库已启动,创建一个数据库(如上面提到的 your_database_name),然后运行 DemoApplication.java。可以通过 Postman 或 cURL 测试 API:

# 获取所有用户
GET http://localhost:8080/users

# 创建用户
POST http://localhost:8080/users
Content-Type: application/json
{
    "name": "John Doe"
}

结尾

恭喜你!现在你已经成功地将 Spring Boot 项目集成到 MySQL 8 中。通过本文的指导,你可以建立数据库连接、构建实体类、创建 REST API,并能够发送 HTTP 请求与数据库交互。这是实现现代 Java 应用的基础,也为你后续更深入的学习奠定了良好的基础。如果你对 Spring Boot 或数据库有更多的兴趣,建议进一步探索 Spring Data JPA 的高级特性。