在现代软件开发中，Spring Boot 因其简单易用而成为构建 Java 应用程序的热门选择。结合 MySQL这一常用关系型数据库，开发者可以快速构建出功能完善的后端服务。本文将详细介绍如何将 Spring Boot 与 MySQL 集成，提供从环境搭建到代码实现的全方位指导。
一、环境准备
在开始之前，请确保你已经具备以下环境：
- JDK: Java Development Kit (JDK) 8 及以上版本。
- Maven: 用于管理项目和依赖。
- MySQL: 已安装并可访问的 MySQL 数据库。
- 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 创建项目
- 访问 Spring Initializr，选择以下配置项：
- Project: Maven Project
- Language: Java
- Spring Boot: 选择最新的稳定版本
- Packaging: Jar
- Java: 选择相应版本
- 在
Dependencies中添加：- Spring Web
- Spring Data JPA
- MySQL Driver
- 生成项目，并下载压缩包，解压后在 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 应用到云服务。
希望本文能够为你后续的开发之路提供帮助。如果你有任何问题或建议，请随时联系我！
