在现代软件开发中，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 Setterspublic 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 {@Autowiredprivate 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 {@Autowiredprivate UserService userService;@GetMappingpublic List<User> getAllUsers() {return userService.getAllUsers();}@PostMappingpublic 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 应用到云服务。
希望本文能够为你后续的开发之路提供帮助。如果你有任何问题或建议，请随时联系我！
