Java 后端 / 系统课时

使用 Repository 完成 CRUD

使用 Repository 完成 CRUD

本课将使用 JpaRepository 为用户实体实现完整 CRUD,并通过数据层测试验证新增、按条件查询、修改、删除和存在性判断,掌握 Spring Data JPA 的最小可用操作路径。

学习目标

  • 声明 JpaRepository 并使用内置 CRUD 方法
  • 通过方法名派生查询实现条件检索和存在性判断
  • 理解实体修改、事务提交与删除验证的关系

准备实体与 Repository

示例使用一个最小用户实体。主键由数据库生成,用户名具有唯一约束,状态使用字符串枚举保存。

java
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;
    }
}
java
package com.example.demo.user;

public enum UserStatus {
    ACTIVE,
    DISABLED
}

Repository 只需要继承 JpaRepository<实体类型, 主键类型>。方法名符合 Spring Data 规则时,框架会自动生成查询实现。

java
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 行为,并输出可核对的结果。

java
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);
    }
}

执行测试:

bash
mvn -q -Dtest=UserRepositoryTest test

预期输出:

text
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 数量、索引和执行计划进行评估。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 Repository 完成 CRUD

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通