Spring Boot 是一个用于简化新 Spring 应用程序的初始设置以及开发过程的强大框架。它遵循“约定优于配置”的原则，使得开发者可以快速搭建起高效、可维护的应用程序。在现代 Web 应用程序中，与数据库交互是不可或缺的一部分。本文将详细介绍如何使用 Spring Boot 进行数据库操作，包括连接数据库、执行 CRUD 操作以及处理事务管理等方面。
1. 准备工作
1.1 创建 Spring Boot 项目
首先，你需要创建一个新的 Spring Boot 项目。你可以通过 Spring Initializr 来生成基础项目结构。选择合适的选项如 Java 版本、项目类型等，并确保添加了 Spring Web, Spring Data JPA 和 Thymeleaf（如果需要前端模板引擎）依赖项。此外，根据你使用的数据库类型，选择相应的驱动依赖，比如 MySQL 或 PostgreSQL。
1.2 配置数据库连接
在 application.properties 或 application.yml 文件中配置你的数据库连接信息。以 MySQL 为例：
spring.datasource.url=jdbc:mysql://localhost:3306/mydatabase?useSSL=false&serverTimezone=UTC
spring.datasource.username=root
spring.datasource.password=yourpassword
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
# JPA 相关配置
spring.jpa.database-platform=org.hibernate.dialect.MySQL5InnoDBDialect
spring.jpa.show-sql=true
spring.jpa.hibernate.ddl-auto=update
这里设置了数据库 URL、用户名和密码，同时指定了 Hibernate 的方言以及是否自动更新表结构。
2. 实体类定义
实体类代表了数据库中的表。Spring Data JPA 提供了一种简单的方式来映射这些类到数据库表。例如，假设我们有一个用户表，可以这样定义实体类：
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
}
使用 @Entity 注解标记这是一个 JPA 实体，@Id 标记主键字段，而 @GeneratedValue 则指示 ID 字段自动生成策略。
3. 定义仓库接口
为了对实体进行持久化操作，我们需要定义一个仓库接口。Spring Data JPA 提供了许多预定义的方法，可以直接使用或扩展它们来满足特定需求。
import org.springframework.data.repository.CrudRepository;
public interface UserRepository extends CrudRepository<User, Long> {
List<User> findByName(String name);
}
这里继承了 CrudRepository 接口，该接口提供了基本的 CRUD 方法。我们还额外定义了一个查询方法 findByName，用于按名称查找用户。
4. 服务层实现
服务层负责业务逻辑的实现，通常会调用仓库接口来访问数据。下面是一个简单的例子：
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 User createUser(User user) {
return userRepository.save(user);
}
public List<User> getUsers() {
return (List<User>) userRepository.findAll();
}
public User getUserById(Long id) {
return userRepository.findById(id).orElse(null);
}
public void deleteUser(Long id) {
userRepository.deleteById(id);
}
}
这里实现了创建、读取、更新和删除用户的功能。
5. 控制器层实现
控制器层处理 HTTP 请求并返回响应。我们可以使用 RESTful API 的方式来暴露服务。
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
import java.util.List;
@RestController
@RequestMapping("/api/users")
public class UserController {
@Autowired
private UserService userService;
@PostMapping
public User createUser(@RequestBody User user) {
return userService.createUser(user);
}
@GetMapping
public List<User> getAllUsers() {
return userService.getUsers();
}
@GetMapping("/{id}")
public User getUserById(@PathVariable Long id) {
return userService.getUserById(id);
}
@DeleteMapping("/{id}")
public void deleteUser(@PathVariable Long id) {
userService.deleteUser(id);
}
}
这个控制器暴露了几个端点，分别对应用户的增删查改操作。
6. 事务管理
Spring Boot 默认支持声明式的事务管理。你可以在服务层的方法上添加 @Transactional 注解来控制事务边界。
import org.springframework.transaction.annotation.Transactional;
@Service
public class UserService {
@Autowired
private UserRepository userRepository;
@Transactional
public User updateUser(User updatedUser) {
User existingUser = userRepository.findById(updatedUser.getId()).orElseThrow(() -> new RuntimeException("User not found"));
existingUser.setName(updatedUser.getName());
existingUser.setEmail(updatedUser.getEmail());
return userRepository.save(existingUser);
}
}
在这个例子中，updateUser 方法被标记为事务性的，这意味着整个方法的执行将在一个事务中完成。
7. 测试
最后，不要忘记编写单元测试和集成测试来验证你的代码。Spring Boot 提供了丰富的测试支持，包括使用 @DataJpaTest 注解来进行数据访问层的测试。
import static org.assertj.core.api.Assertions.assertThat;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.orm.jpa.DataJpaTest;
@DataJpaTest
public class UserRepositoryTest {
@Autowired
private UserRepository userRepository;
@Test
public void whenFindByName_thenReturnUser() {
User user = new User();
user.setName("John Doe");
user.setEmail("john.doe@example.com");
userRepository.save(user);
assertThat(userRepository.findByName("John Doe")).isNotNull();
}
}
这段测试代码检查了按名称查找用户的功能是否正常工作。
8. 总结
通过本文，我们学习了如何使用 Spring Boot 执行基本的数据库操作。从项目的创建、数据库连接配置到实体类定义、仓库接口设计、服务层及控制器层的实现，再到事务管理和测试，每个步骤都进行了详细的介绍。希望这篇文章能够帮助你在实际项目中更加得心应手地利用 Spring Boot 进行数据库操作。
