一、引言
MySQL 是一个广泛使用的开源关系型数据库,而 Spring Boot 则是一个流行的 Java 框架,提供了快速构建生产级别的独立 Spring 应用的能力。将 MySQL 与 Spring Boot 集成,可以轻松地管理应用的数据存储。本文将介绍如何在 Spring Boot 项目中配置和使用 MySQL 数据库。
二、环境准备
1. 安装 MySQL
首先,确保你的系统上已经安装了 MySQL。你可以从MySQL 官方网站下载并安装 MySQL。如果你已经安装好了,可以通过以下命令检查 MySQL 服务是否正在运行:
            
            
              bash
              
              
            
          
          mysql -u root -p2. 创建数据库和用户
登录 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:run2. 测试 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 的强大功能结合,使得开发高效且愉快。