Java 后端 / 系统课时
使用 Repository 完成 CRUD
使用 Repository 完成 CRUD
本课将使用 JpaRepository 为用户实体实现完整 CRUD,并通过数据层测试验证新增、按条件查询、修改、删除和存在性判断,掌握 Spring Data JPA 的最小可用操作路径。
学习目标
- 声明
JpaRepository并使用内置 CRUD 方法 - 通过方法名派生查询实现条件检索和存在性判断
- 理解实体修改、事务提交与删除验证的关系
准备实体与 Repository
示例使用一个最小用户实体。主键由数据库生成,用户名具有唯一约束,状态使用字符串枚举保存。
package com.example.demo.user;
import jakarta.persistence.*;
@Entity
@Table(name = "app_user")
public class User {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
@Column(nullable = false, unique = true, length = 50)
private String username;
@Enumerated(EnumType.STRING)
@Column(nullable = false, length = 20)
private UserStatus status;
protected User() {
}
public User(String username, UserStatus status) {
this.username = username;
this.status = status;
}
public Long getId() {
return id;
}
public String getUsername() {
return username;
}
public UserStatus getStatus() {
return status;
}
public void rename(String username) {
this.username = username;
}
}package com.example.demo.user;
public enum UserStatus {
ACTIVE,
DISABLED
}Repository 只需要继承 JpaRepository<实体类型, 主键类型>。方法名符合 Spring Data 规则时,框架会自动生成查询实现。
package com.example.demo.user;
import org.springframework.data.jpa.repository.JpaRepository;
import java.util.Optional;
public interface UserRepository extends JpaRepository<User, Long> {
Optional<User> findByUsername(String username);
boolean existsByUsername(String username);
}JpaRepository 已提供 save、findById、findAll、deleteById、existsById 和 count 等方法。只有业务需要的条件查询才需要额外声明。
完成新增与查询
新增实体时调用 save。对新对象执行保存会触发插入,返回值包含数据库生成的主键。查询单条数据时应处理 Optional,不要直接调用 get() 假设数据一定存在。
下面测试一次覆盖主要 CRUD 行为,并输出可核对的结果。
package com.example.demo.user;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.orm.jpa.DataJpaTest;
import static org.assertj.core.api.Assertions.assertThat;
@DataJpaTest
class UserRepositoryTest {
@Autowired
private UserRepository userRepository;
@Test
void shouldCompleteCrudLifecycle() {
User saved = userRepository.saveAndFlush(
new User("alice", UserStatus.ACTIVE)
);
User found = userRepository.findByUsername("alice")
.orElseThrow();
boolean existsBeforeDelete =
userRepository.existsByUsername("alice");
// 受管实体在事务内修改后会由脏检查生成 UPDATE
found.rename("alice-chen");
userRepository.flush();
String updatedName = userRepository.findById(saved.getId())
.orElseThrow()
.getUsername();
userRepository.deleteById(saved.getId());
userRepository.flush();
boolean existsAfterDelete =
userRepository.existsById(saved.getId());
assertThat(existsBeforeDelete).isTrue();
assertThat(updatedName).isEqualTo("alice-chen");
assertThat(existsAfterDelete).isFalse();
System.out.println("savedId=" + saved.getId());
System.out.println("updatedName=" + updatedName);
System.out.println("existsBeforeDelete=" + existsBeforeDelete);
System.out.println("existsAfterDelete=" + existsAfterDelete);
}
}执行测试:
mvn -q -Dtest=UserRepositoryTest test预期输出:
savedId=<ID>
updatedName=alice-chen
existsBeforeDelete=true
existsAfterDelete=false<ID> 的实际值由数据库决定。四行输出分别验证主键回填、修改落库、删除前存在以及删除后不存在。
理解修改与 save 的行为
查询得到的实体在当前事务中处于受管状态。调用 rename 后,即使不再次执行 save,事务提交或 flush 时也会通过脏检查生成更新语句。显式调用 save 通常用于保存新实体,或合并脱离持久化上下文的实体。
不要把接口传入的完整对象直接交给 save。更安全的做法是先按主键查询现有实体,再调用具有业务含义的方法修改允许变更的字段,这样可以避免主键、状态或审计字段被意外覆盖。
删除与存在性判断
deleteById 会按主键删除记录;若业务要求“记录不存在时返回明确错误”,应先查询并抛出业务异常,而不是依赖底层删除行为。批量删除还要评估关联关系、外键约束和审计要求。
existsByUsername 通常比先查询完整实体再判断是否为空更贴合意图。它适合注册前查重等场景,但并发请求下仍必须保留数据库唯一约束,不能只依赖应用层的先查后写。
Repository 使用边界
Repository 负责持久化访问,不应承载复杂业务流程。跨多个实体的修改、权限校验和事务控制应放在 Service 层,并由 @Transactional 明确事务边界。
分页查询应使用 Pageable,大数据量场景不要直接调用无条件 findAll()。删除、批量更新和复杂关联查询需要结合 SQL 数量、索引和执行计划进行评估。