一、引言
MySQL 是一个广泛使用的开源关系型数据库,而 Spring Boot 则是一个流行的 Java 框架,提供了快速构建生产级别的独立 Spring 应用的能力。将 MySQL 与 Spring Boot 集成,可以轻松地管理应用的数据存储。本文将介绍如何在 Spring Boot 项目中配置和使用 MySQL 数据库。
二、环境准备
1. 安装 MySQL
首先,确保你的系统上已经安装了 MySQL。你可以从MySQL 官方网站下载并安装 MySQL。如果你已经安装好了,可以通过以下命令检查 MySQL 服务是否正在运行:
bash
mysql -u root -p
2. 创建数据库和用户
登录 MySQL 后,创建一个数据库和用户供 Spring Boot 项目使用:
sql
CREATE DATABASE my_spring_boot_db;
CREATE USER 'springuser'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON my_spring_boot_db.* TO 'springuser'@'localhost';
FLUSH PRIVILEGES;
这里我们创建了一个名为 my_spring_boot_db
的数据库,并为用户 springuser
分配了所有权限。
三、Spring Boot 项目的搭建
1. 创建 Spring Boot 项目
你可以使用 Spring Initializr 快速创建一个 Spring Boot 项目。在Spring Initializr 网站上选择以下配置:
- Project: Maven Project
- Language: Java
- Spring Boot: 版本选择稳定版本
- Dependencies: Spring Web, Spring Data JPA, MySQL Driver
点击"Generate"按钮下载项目模板,并将其解压缩。
2. 添加 MySQL 依赖
在创建的项目中,打开 pom.xml
文件,确认已经包含以下 MySQL 依赖:
xml
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
</dependency>
这将使 Spring Boot 能够与 MySQL 数据库通信。
四、配置 MySQL 数据库连接
在 src/main/resources
目录下的 application.properties
文件中,添加以下数据库连接配置:
properties
spring.datasource.url=jdbc:mysql://localhost:3306/my_spring_boot_db?useSSL=false&serverTimezone=UTC
spring.datasource.username=springuser
spring.datasource.password=password
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
# JPA 配置
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL5Dialect
这些配置告诉 Spring Boot 如何连接到 MySQL 数据库,并启用 JPA(Java Persistence API)进行数据访问。
五、创建实体类和数据访问层
1. 创建实体类
在 src/main/java/com/example/demo
目录下创建一个 model
包,并在其中创建一个名为 User
的实体类:
java
package com.example.demo.model;
import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import jakarta.persistence.Id;
@Entity
public class User {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
private String name;
private String email;
// Getters and setters
}
2. 创建数据访问接口
接下来,在 src/main/java/com/example/demo
目录下创建一个 repository
包,并在其中创建一个名为 UserRepository
的接口:
java
package com.example.demo.repository;
import com.example.demo.model.User;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.stereotype.Repository;
@Repository
public interface UserRepository extends JpaRepository<User, Long> {
}
UserRepository
继承自 JpaRepository
,提供了常用的数据库操作方法,如保存、删除、查找等。
六、编写服务层和控制器
1. 创建服务层
在 src/main/java/com/example/demo
目录下创建一个 service
包,并在其中创建一个名为 UserService
的类:
java
package com.example.demo.service;
import com.example.demo.model.User;
import com.example.demo.repository.UserRepository;
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 void saveUser(User user) {
userRepository.save(user);
}
}
2. 创建控制器
最后,在 src/main/java/com/example/demo
目录下创建一个 controller
包,并在其中创建一个名为 UserController
的类:
java
package com.example.demo.controller;
import com.example.demo.model.User;
import com.example.demo.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
import java.util.List;
@RestController
@RequestMapping("/users")
public class UserController {
@Autowired
private UserService userService;
@GetMapping
public List<User> getAllUsers() {
return userService.getAllUsers();
}
@PostMapping
public void createUser(@RequestBody User user) {
userService.saveUser(user);
}
}
七、运行项目并测试
1. 启动应用
你可以通过以下命令运行应用:
bash
mvn spring-boot:run
2. 测试 API
应用启动后,可以使用 curl
或 Postman 等工具测试 API。例如,获取所有用户:
bash
curl -X GET http://localhost:8080/users
或创建新用户:
bash
curl -X POST http://localhost:8080/users -H "Content-Type: application/json" -d '{"name":"John Doe","email":"john.doe@example.com"}'
八、结语
通过本文,你已经了解了如何在 Spring Boot 项目中集成 MySQL 数据库,并通过简单的 API 来管理用户数据。Spring Boot 的简洁性和 MySQL 的强大功能结合,使得开发高效且愉快。